> ## Documentation Index
> Fetch the complete documentation index at: https://docs.primeearn.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Offers Changelog

> Release history for the Offers & Games integration.

# Offers Changelog

## v1.3 — 2026-07-21

**Added `performance_d0`, `performance_d7`, `performance_d30` fields to offer objects**

All three endpoints (`/offers`, `/offers/active`, `/offers/{hash}`) now return three performance score fields on every offer object.

| Field             | Type              | Description                                   |
| ----------------- | ----------------- | --------------------------------------------- |
| `performance_d0`  | `integer \| null` | ROAS performance score on the day of install. |
| `performance_d7`  | `integer \| null` | ROAS performance score at day 7.              |
| `performance_d30` | `integer \| null` | ROAS performance score at day 30.             |

Each field is an integer from 1 to 5 indicating how the offer's actual ROAS compares to its target ROAS. `null` means data is not yet available for that cohort.

| Value | Meaning                                                  |
| ----- | -------------------------------------------------------- |
| `1`   | Actual ROAS is more than 25% **below** Target ROAS       |
| `2`   | Actual ROAS is between 10% and 25% **below** Target ROAS |
| `3`   | Actual ROAS is **within ±10%** of Target ROAS            |
| `4`   | Actual ROAS is between 10% and 25% **above** Target ROAS |
| `5`   | Actual ROAS is more than 25% **above** Target ROAS       |

***

## v1.2 — 2026-07-15

**Added `package_name` field to offer objects**

All three endpoints (`/offers`, `/offers/active`, `/offers/{hash}`) now return a `package_name` field on every offer object.

| Field          | Type             | Description                                                                      |
| -------------- | ---------------- | -------------------------------------------------------------------------------- |
| `package_name` | `string \| null` | The app's bundle / package identifier. Can be used to identify a specific offer. |

**Added `locale` query parameter**

Pass `locale=en` or `locale=en-US` to set the interface language. Currently only English is supported.

**Added `source`, `network`, and `placement` query parameters**

Three new optional parameters are now accepted by all integration types (API, IFrame, Script) for both offers and surveys.

| Parameter   | Type      | Description                                                                                                                                                        |
| ----------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `source`    | `integer` | Numeric traffic source identifier. Identifies how the user arrived in your app.                                                                                    |
| `network`   | `integer` | Numeric network identifier. Identifies the specific ad network or channel.                                                                                         |
| `placement` | `string`  | Free-text label for where the integration is placed in your product (e.g. `post_level`, `main_menu`). Useful for comparing performance across multiple placements. |

For `source` and `network`, use the numeric ID from the reference table (IDs 1–19) instead of raw text values. See the integration pages for the full lookup table.

***

## v1.1 — 2026-06-29

**Added `cpi` field to offer objects**

All three endpoints (`/offers`, `/offers/active`, `/offers/{hash}`) now return a `cpi` field on every offer object.

| Field | Type     | Description                                                                         |
| ----- | -------- | ----------------------------------------------------------------------------------- |
| `cpi` | `number` | Publisher revenue in USD for a successful install. Only present on CPI-type offers. |

***

## v1.0 — Initial release

First release of the Partner Offers API with three endpoints:

* `GET /offers` — list available offers for a user
* `GET /offers/active` — list offers the user has already started
* `GET /offers/{hash}` — full details for a single offer