---
title: Working with Wildfire Coupon Data
slug: article/aja2b-working-with-wildfire-coupon-data
description: Learn about the Wildfire Coupon JSON feed, which provides valuable coupon data such as ID, Merchant ID, Description, Code, Countries, Exclusions, Start Date, and End Date. Keep in mind that the coupon data is updated every six hours, and it's important to
docTags: WX-732KZOub96_R0NW2HX
createdAt: 2022-12-13T00:05:09.000Z
---

# Introduction

Wildfire Coupon data aggregates coupons from multiple sources to provide partners with the widest range of available coupons. Wildfire's coupon data is a raw data feed with a few nuances that partners should be aware of, as specified below. For Wildfire-built products, these nuances are handled on behalf of our partners. 

## Wildfire Coupon Data JSON Feed:

Available coupon data is located at the Wildfire Coupon JSON feed:<font color="#A855F7">`https://www.wildlink.me/data/APPLICATION_ID/coupon/VERSION` </font>

<font color="#E9D5FF"></font>

## Expected Fields:&#x20;

- **ID** and **Merchant ID**: ID is the unique identifier for the coupon or promotion, and the Merchant ID is the associated merchant reference for the coupon/promo.
- **Description**: ****
  Contains details about the offer or promotion. In some cases, the coupon code may also appear in this field. Some merchants do not provide structured or consistent descriptions, especially for coupon-based offers. 
  - **For Wildfire-built products:** Wildfire handles this on behalf of our partners. 
  - **For partner-built products:&#x20;**&#x70;artners may need to normalize or clean up descriptions before displaying them in the UI.
- **Code**: When provided, this field contains the coupon code entered at checkout to apply the discount.
  - Note: This field may sometimes be blank or show null. 
  - **For Wildfire-built products:&#x20;**&#x57;ildfire handles this on behalf of our partners. 
  - **For Partner-built products:&#x20;**&#x55;se the table below to determine how to interpret offer data

| **Scenario**              | **Code Field** | **Description Field** | **Action Required**                                                                   |
| ------------------------- | -------------- | --------------------- | ------------------------------------------------------------------------------------- |
| Code only in description  | Blank or null  | Contains code         | Extract code from description                                                         |
| Code in both fields       | Contains code  | Contains code         | Use Code Field (preferred source)                                                     |
| No code provided          | Blank or null  | No code listed        | No code required; discount applies automatically (e.g. free shiping or sitewide sale) |

- **Countries:** List of country codes where the merchant indicates the coupon can be used.
  - May include "International"
  - May be null if not specified

:::Paragraph{indent="3"}
**Important Notes:**
:::

:::Paragraph{listStyleType="disc" indent="3"}
The Wildfire coupon feed is **not filtered by country**
:::

:::Paragraph{listStyleType="disc" listStart="2" indent="3"}
The JSON feed does **not** include a direct coupon-to-country relationship
:::

:::Paragraph{listStyleType="disc" listStart="3" indent="2"}
**For Wildfire-built products:&#x20;**&#x57;ildfire manages country filtering
:::

:::Paragraph{listStyleType="disc" listStart="4" indent="2"}
**For Partner-built products:** Partners must control which coupons are displayed by count
:::

- **Languages:&#x20;**&#x57;hile Network Merchants sets the applicable countries for offer codes, they can still pass coupons available for that country in different languages. For partner-built products, partners must manage the display of applicable language.&#x20;
  - i.e: A network merchant can pass US coupons & promos, but that does not mean eligible coupons are exclusively in English. The eligible US coupons can be in French or Spanish, etc.
- **Exclusions**: Some merchants explicitly list restrictions or exclusions (e.g., brands, categories, regions).More commonly, eligibility details are included within the Description field
- **Start Date** / **End Date**: Defines when the coupon is valid. &#x20;
  - May include future start dates (“coming soon” promotions)
  - May include expired promotions
  - Some merchants use very long end dates (e.g., year 3000) to indicate no expiration
  - **For Wildfire-built products:** Wildfire manages validity filtering
  - **For Partner-built products:** Partners must display only currently valid coupon

**Feed Regeneration Cadence:** Wildfire regenerates coupon data approximately every 6 hours. Plan caching and refresh logic accordingly to ensure accurate and timely offers.

## Summary

Wildfire's coupon data feed is raw data and may contain expected anomalies. This raw data provides all Wildfire partners with the maximum number of savings opportunities to present to their users. For Wildfire-built products, these nuances are handled on behalf of our partners.

For partner-built products, partners must manage the following:

- Extract specific coupon code patterns from descriptions
- Refine dates shown to users; Specifically for the no-expiration date codes and promos
- Handling Countries; Specifically, the translation of eligible coupons from non-official languages to the official language, if desired.

###