# Offers API

```
GET https://api.offer18.com/api/m/offers
```

:link: [<mark style="color:blue;">**Click to Test Offers API**</mark> ](https://offer18.readme.io/reference/offers-api-2)

### **Common Parameters**

<table data-header-hidden><thead><tr><th width="282.21480547854435">Query</th><th width="191.2954426994595"> </th><th> </th></tr></thead><tbody><tr><td><strong>Query</strong></td><td><strong>Type</strong></td><td><strong>Description</strong>  </td></tr><tr><td>mid</td><td>Integer</td><td>Network Account ID</td></tr><tr><td>api-key</td><td>String</td><td>Network API Key</td></tr><tr><td>secret-key</td><td>String</td><td>Network Secret Key</td></tr></tbody></table>

***

### Filters

| **Query**         | **Type** | **Description**                                                                                                           |
| ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| advertiser\_id    | String   | Advertiser ID                                                                                                             |
| offer\_id         | String   | Offer ID                                                                                                                  |
| category          | String   | Offer Category                                                                                                            |
| status            | Integer  | <p>Offer Status <br>  <strong>1</strong> : Approved<br>  <strong>2</strong> : Pending<br>  <strong>3</strong> : Ended</p> |
| offer\_name       | String   | Offer Name                                                                                                                |
| model\_affiliate  | String   | Affiliate Model (CPA, CPC, etc)                                                                                           |
| model\_advertiser | String   | Advertiser Model (CPA, CPC, etc)                                                                                          |
| limit             | Integer  | Number of offer                                                                                                           |
| page              | Integer  | Page Number                                                                                                               |

{% code overflow="wrap" %}

```
https://api.offer18.com/api/m/offers?mid=000&api-key=000000&secret-key=000000000&advertiser_id=00000&offer_id=00000&status=1&offer_name=offername&model_affiliate=CPA&model_advertiser=CPA&limit=100
```

{% endcode %}

***

### Example API Request

<figure><img src="https://295230641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F41f2EboJipeUA6flsLGK%2Fuploads%2FbuGgTqI0QfyGt2txDVG1%2Fimage.png?alt=media&#x26;token=e3142acc-8816-4e07-a092-c64b4e0ffbf7" alt=""><figcaption></figcaption></figure>

***

### API Response

```
{
    "response": "200",
    "data": {
        "00011": {
            "offerid": "00011",
            "offer_name": "Test offer",
            "logo": "https://example.com/sample.jpeg",
            "status": "Approved",
            "category": "",
            "currency": "INR",
            "price_affiliate": "10",
            "model_affiliate": "CPA",
            "price_advertiser": "10",
            "model_advertiser": "CPA",
            "advertiser_id": "11111",
            "external_offer_id": "",
            "app_id": "",
            "visibility": "public",
            "deep_links": "disabled",
            "private_note": "",
            "start_datetime": "2023-02-13 09:35:00",
            "end_datetime": "2025-02-13 09:35:00",
            "preview_url": "",
            "offer_description": "Offer default terms and conditions.. ",
            "offer_kpi": "",
            "country_allow": "US",
            "os_allow": "android,ios",
            "device_allow": "smartphone",
            "browser_allow": "ch",
            "capping": [
    {
        "affiliate_visibility": "show",
        "rule_type": "shared_capping",
        "event": "",
        "type": "gross_conversions",
        "period": "daily",
        "value": 10,
        "over_capping_action": "conversion_pending",
        "timezone": "",
        "rule_id": "1001"
    },
    {
        "affiliate_visibility": "show",
        "rule_type": "affiliate_capping",
        "affiliates": "",
        "event": "",
        "type": "approved_conversions",
        "period": "daily",
        "value": 10,
        "over_capping_action": "conversion_pending",
        "timezone": "",
        "rule_id": "1002"
    }
],
            "events": [
    {
        "event_name": "reagistration",
        "event_token": "reagistration"
    }
],
            "affiliate_payout_tier": "",
            "payout": [
    {
        "affiliate_price": "10.00000",
        "advertiser_price": "10.00000",
        "currency": "USD",
        "affiliate_model": "CPA",
        "advertiser_model": "CPA",
        "condition": [
            [
                {
                    "field": "event",
                    "operator_type": "is_equal",
                    "value": "reagistration"
                }
            ]
        ],
        "rule_id": "1101"
    },
    {
        "affiliate_price": "15.00000",
        "advertiser_price": "15.00000",
        "currency": "USD",
        "affiliate_model": "CPA",
        "advertiser_model": "CPA",
        "condition": [
            [
                {
                    "field": "affiliate_id",
                    "operator_type": "is_equal",
                    "value": "00001"
                }
            ]
        ],
        "rule_id": "1102"
    }
],
            "affiliates": {
    "00001": {
        "name": "Affiliate",
        "status": "approved",
        "tracking_url": "https:\/\/test.o18.link\/c?o=00011&m=0000&a=00001",
        "impression_url": "https:\/\/test.o18.link\/i?o=00011&m=0000&a=00001"
    }
},
            "impression_url": "https:\/\/www.impression.com",
            "offer_url": "https:\/\/www.example.com",
            "postback_type": "S2S",
            "fallback_url": "https:\/\/fallbackurl.com",
            "fallback": "enabled",
            "conversion_lifespan": "2592000 seconds",
            "multi_conversions": "no",
            "conversion_approval": "auto",
            "multi_ip_conversions": "allow",
            "default_event": "initial",
            "event_mismatch_action": "record conversion as initial event",
            "landing_pages": null,
            "creatives": [
    {
        "type": "image",
        "url": "https:\/\/d25e10dl5yrpaz.cloudfront.net\/3872\/21005008\/21005008-1707817058301480-con.png"
    }
]
        }
    }
}
```