# Loss Notifications

If a `lurl` is provided in the bid response, Chartboost will send win/loss/error notifications via server-side HTTP GET requests. Standard OpenRTB 2.5 macro replacement is supported here. A list of the supported macros as well as our reason code mapping table can be found below. 

<div class="alert alert-info" role="alert">
  <b>Note:</b> This url is used for losses as well as wins & errors, even if nurl is also provided.
</div>

**Supported lurl macros:**

* `${AUCTION_ID}`
* `${AUCTION_BID_ID}`
* `${AUCTION_IMP_ID}`
* `${AUCTION_SEAT_ID}`
* `${AUCTION_AD_ID}`
* `${AUCTION_PRICE}`
* `${AUCTION_CURRENCY}`
* `${AUCTION_LOSS}`
* `${MIN_BID_TO_WIN}`
  
<div class="alert alert-info" role="alert">
  <b>Note:</b> <code>${MIN_BID_TO_WIN}</code> will be populated with the winning bid price only if your <b>valid</b> bid does not win the auction (i.e. only when <code>${AUCTION_LOSS}=102)</code>.  <code>${AUCTION_PRICE}</code> will be populated with the winning bid price only when your bid wins the auction (i.e. only when <code>${AUCTION_LOSS}=0)</code>.  If you plan to use the <code>${MIN_BID_TO_WIN}</code> macro, please reach out to us so we can enable it for you.
</div>


| Code                                              | `${AUCTION_LOSS}` code definition | 
|---------------------------------------------------|--------|
| <span style="font-family:Courier New">0</span>    | Bid Won |
| <span style="font-family:Courier New">3</span>    | Invalid Bid Response |
| <span style="font-family:Courier New">4</span>    | Invalid Deal ID |
| <span style="font-family:Courier New">5</span>    | Bid response's impid doesn't match auction id |
| <span style="font-family:Courier New">6</span>    | Invalid Advertiser Domain |
| <span style="font-family:Courier New">100</span>  | Bid was Below Auction Floor |
| <span style="font-family:Courier New">102</span>  | Lost to Higher Bid |
| <span style="font-family:Courier New">103</span>  | Lost to a Bid for a PMP Deal |
| <span style="font-family:Courier New">202</span>  | Creative Filtered - Disapproved by Exchange |
| <span style="font-family:Courier New">204</span>  | Creative Filtered - Incorrect Creative Format |
| <span style="font-family:Courier New">205</span>  | Creative Filtered - Advertiser Exclusions |
| <span style="font-family:Courier New">206</span>  | Creative Filtered – App Bundle Exclusions |
| <span style="font-family:Courier New">209</span>  | Creative Filtered - Category Exclusions |
| <span style="font-family:Courier New">211</span>  | Blocked due to a bid response missing `bid.ext.crtype:"MRAID playable`" for a Rewarded placement and non-VAST response |
| <span style="font-family:Courier New">214</span>  | Invalid SKAdNetwork |
| <span style="font-family:Courier New">502</span>  | Bid won the auction but the ad failed to load |
| <span style="font-family:Courier New">1000</span> | Blocked due to creative id (`crid`) being blocked globally on Chartboost side |
| <span style="font-family:Courier New">1001</span> | Timeout. Bid request was not received in time for the auction.  *Partial as we can only wait a brief time for a response after the auction timeout |
| <span style="font-family:Courier New">1002</span> | `burl` or `ext.imptrackers` contains non-URL-encoded `'` character |
| <span style="font-family:Courier New">1003</span> | `burl` or `ext.imptrackers` URL that exceeds 12K characters |