> For the complete documentation index, see [llms.txt](https://offerslook-api.gitbook.io/api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://offerslook-api.gitbook.io/api-documentation/networkapi/offers/sub-resources/offer-events/get_the_offer_event.md).
# Get the offer event
| HTTP method | Endpoint |
| ----------- | ---------------------------------------- |
| **GET** | **/v1/offers/{offer\_id}/offer\_events** |
### Path parameters
| Parameter | Description |
| --------- | ---------------------------- |
| offer\_id | The unique id for the offer. |
**Note: To change event status to active, you will need t to reset revenue and payout if previous value is null.**
### Query string parameters
| Conditions | Parameters | Type | Description |
| ---------- | --------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Offset | offset | offset | Check page scale. |
| Limit | limit | limit | The number of date displays in each page. |
| Sort | sort | sort | Ranking according to the specified field ascending "+", or descending "-". |
| Filters | filters | filter | Query requirements of Specify field. |
| | | | EQUAL\_TO NOT\_EQUAL\_TO LESS\_THAN LESS\_THAN\_OR\_EQUAL\_TO GREATER\_THAN GREATER\_THAN\_OR\_EQUAL\_TO CONTAINS NOT\_CONTAINS NULL NOT\_NULL |
| Fields | fields | field | You can choose the field of the query (the result of the query is in line with the selected field). |
| | id | integer | The unique id for the event. |
| | name | string | Offer Event name. |
| | revenue\_type | string | Event revenue type. Allowed values: RPC · RPI · RPA · RPL · RPS · RPA+RPS |
| | revenue | string | Event revenue. |
| | percent\_revenue | string | Event percent revenue. |
| | payout\_type | string | Event payout type. Allowed values: CPC · CPI · CPA · CPL · CPS · CPA+CPS |
| | payout | string | Event payout. |
| | percent\_payout | string | Event percent payout. |
| | status | string | The status of the event. Allowed values: active paused |
| | is\_private | integer | Enabling this setting will track revenue of event only, affiliate do not have access to private events, custom affiliate payouts can not be set nor can 3rd party affiliate postbacks be placed. Allowed values: 1: Open 0: Close |
| | approve\_conversions | integer | Whether Conversions for this Offer must be manually approved. If enabled, Conversions will receive a "status" of "pending" when generated. Allowed values: 1: Open 0: Close |
| | is\_allowed\_multiple | integer | Enabling this setting will allow multiple conversions to be recorded per user for only one click id. Allowed values: 1: Open 0: Close |
| | is\_end\_point | integer | Enabling this setting will close the active click session when this event is converted. Allowed values: 1: Open 0: Close |
| | conversion\_protocol | integer | The Conversion tracking method to use for the offer event. Allowed values: 1 mage Pixel 2 ostback URL 3 Frame Pixel |
| | offer\_payout\_tier | | Tier payout information. |
### Response body parameters
| Field | Type | Description |
| --------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id | integer | The unique id for the event. |
| name | string | Offer Event name. |
| revenue\_type | string | Event revenue type. Allowed values: RPC · RPI · RPA · RPL · RPS · RPA+RPS |
| revenue | string | Event revenue. |
| percent\_revenue | string | Event percent revenue. |
| payout\_type | string | Event payout type. Allowed values: CPC · CPI · CPA · CPL · CPS · CPA+CPS |
| payout | string | Event payout. |
| percent\_payout | string | Event percent payout. |
| status | string | The status of the event. Allowed values: active paused |
| is\_private | integer | Enabling this setting will track revenue of event only, affiliate do not have access to private events, custom affiliate payouts can not be set nor can 3rd party affiliate postbacks be placed. Allowed values: 1: Open 0: Close |
| approve\_conversions | integer | Whether Conversions for this Offer must be manually approved. If enabled, Conversions will receive a "status" of "pending" when generated. Allowed values: 1: Open 0: Close |
| is\_allowed\_multiple | integer | Enabling this setting will allow multiple conversions to be recorded per user for only one click id. Allowed values: 1: Open 0: Close |
| is\_end\_point | integer | Enabling this setting will close the active click session when this event is converted. Allowed values: 1: Open 0: Close |
| conversion\_protocol | integer | The Conversion tracking method to use for the offer event. Allowed values: 1 mage Pixel 2 ostback URL 3 Frame Pixel |
| offer\_payout\_tier | | Tier payout information. |
| tier\_id | integer | The unique id for the tier. |
| tier\_payout | string | Tier payout. |
| totalPages | integer | The list of data pages (associated with your limit). |
| totalRows | integer | Total number of available data. |
| offset | integer | The number of records from a collection to skip. Iterating over large collections with this parameter can be slow. |
| limit | integer | The number of data displayed on one page |
## Example request
**Request GET**
**Request GET**
## Example response
```
{
"code": 0,
"message": "Success",
"data": {
"rowset": [
{
"id": 1,
"name": "Initial Event",
"revenue": "0.000",
"payout": "0.000",
"status": "active",
"offer_payout_tier": ""
},
{
"id": 2,
"name": "0",
"revenue": "0.000",
"payout": "0.000",
"status": "active",
"offer_payout_tier": ""
},
{
"id": 3,
"name": "30",
"revenue": "0.000",
"payout": "0.000",
"status": "active",
"offer_payout_tier": ""
},
{
"id": 4,
"name": "30d",
"revenue": "0.000",
"payout": "0.000",
"status": "active",
"offer_payout_tier": ""
},
{
"id": 5,
"name": "30d",
"revenue": "0.000",
"payout": "0.000",
"status": "active",
"offer_payout_tier": ""
},
{
"id": 6,
"name": "30ddd",
"revenue": "0.000",
"payout": "0.000",
"status": "active",
"offer_payout_tier": ""
},
{
"id": 7,
"name": "30ddd",
"revenue": "0.000",
"payout": "0.000",
"status": "active",
"offer_payout_tier": ""
},
{
"id": 8,
"name": "30ddd",
"revenue": "0.000",
"payout": "0.000",
"status": "active",
"offer_payout_tier": ""
},
{
"id": 9,
"name": "30ddd",
"revenue": "2.000",
"payout": "0.000",
"status": "active",
"offer_payout_tier": [
{
"tier_id": 17,
"offer_id": 102,
"event_id": 9,
"tier_payout": "0"
}
]
},
{
"id": 10,
"name": "Update Test",
"revenue": "2.800",
"payout": "2.000",
"status": "active",
"offer_payout_tier": [
{
"tier_id": 12,
"offer_id": 102,
"event_id": 10,
"tier_payout": "2.5"
},
{
"tier_id": 11,
"offer_id": 102,
"event_id": 10,
"tier_payout": "2.5"
}
]
}
],
"totalPages": 1,
"totalRows": 10,
"offset": 1,
"limit": 10
}
}
```