Offers

Operations for offers

Find All Visible

GET /v1/affiliates/alloffers
This endpoint allows you to retrieve a list of all visible offers. This includes public offers and the ones that require your network's approval.

Returns an empty array if no Offers exist or are visible.

Filters

This endpoint supports basic filtering. Refer to API filters page for usage.

cURL
curl --request GET 'https://api.eflow.team/v1/affiliates/alloffers' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--header 'content-type: application/json' 
Response
{
    "offers": [
        {
            "network_offer_id": 1,
            "network_id": 1,
            "name": "Offer Example",
            "thumbnail_url": "",
            "network_category_id": 1,
            "preview_url": "",
            "offer_status": "active",
            "currency_id": "USD",
            "caps_timezone_id": 90,
            "date_live_until": "",
            "html_description": "",
            "is_using_explicit_terms_and_conditions": false,
            "terms_and_conditions": "",
            "is_force_terms_and_conditions": false,
            "visibility": "public",
            "is_caps_enabled": false,
            "is_using_suppression_list": false,
            "suppression_list_id": 0,
            "network_tracking_domain_id": 1,
            "daily_conversion_cap": 0,
            "weekly_conversion_cap": 88,
            "monthly_conversion_cap": 0,
            "global_conversion_cap": 125,
            "daily_payout_cap": 10.3,
            "weekly_payout_cap": 0,
            "monthly_payout_cap": 0,
            "global_payout_cap": 300.5,
            "daily_click_cap": 0,
            "weekly_click_cap": 0,
            "monthly_click_cap": 2500,
            "global_click_cap": 0,
            "tracking_url": "http://www.servetrack.test/9W598/2CTPL/",
            "app_identifier": "",
            "time_created": 1602783082,
            "time_saved": 1602783082,
            "is_description_plain_text": false,
            "is_use_direct_linking": false,
            "relationship": {
                "offer_affiliate_status": "public"
            },
            "impression_tracking_url": ""
        }
    ],
    "paging": {
        "page": 1,
        "page_size": 50,
        "total_count": 34
    }
}

Find All Runnable

GET /v1/affiliates/offersrunnable
This endpoint allows you to retrieve a list of all runnable offers. This includes public offers and the ones that have gotten your network's approval.

Returns an empty array if no Offers exist or are runnable.

Filters

This endpoint supports basic filtering. Refer to API filters page for usage.

cURL
curl --request GET 'https://api.eflow.team/v1/affiliates/offersrunnable' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--header 'content-type: application/json' 
Response
{
  "offers": [
      {
          "network_offer_id": 1,
          "network_id": 1,
          "name": "Offer Example",
          "thumbnail_url": "",
          "network_category_id": 1,
          "preview_url": "",
          "offer_status": "active",
          "currency_id": "USD",
          "caps_timezone_id": 90,
          "date_live_until": "",
          "html_description": "",
          "is_using_explicit_terms_and_conditions": false,
          "terms_and_conditions": "",
          "is_force_terms_and_conditions": false,
          "visibility": "public",
          "is_caps_enabled": false,
          "is_using_suppression_list": false,
          "suppression_list_id": 0,
          "network_tracking_domain_id": 1,
          "daily_conversion_cap": 0,
          "weekly_conversion_cap": 88,
          "monthly_conversion_cap": 0,
          "global_conversion_cap": 125,
          "daily_payout_cap": 10.3,
          "weekly_payout_cap": 0,
          "monthly_payout_cap": 0,
          "global_payout_cap": 300.5,
          "daily_click_cap": 0,
          "weekly_click_cap": 0,
          "monthly_click_cap": 2500,
          "global_click_cap": 0,
          "tracking_url": "http://www.servetrack.test/9W598/2CTPL/",
          "app_identifier": "",
          "time_created": 1602783082,
          "time_saved": 1602783082,
          "is_description_plain_text": false,
          "is_use_direct_linking": false,
          "relationship": {
              "category": {
                  "network_category_id": 1,
                  "network_id": 1,
                  "name": "Finance",
                  "status": "active",
                  "time_created": 1602783082,
                  "time_saved": 1602783082
              },
              "creatives": {
                  "total": 1,
                  "entries": [
                      {
                          "network_offer_creative_id": 2,
                          "network_id": 1,
                          "network_offer_id": 1,
                          "name": "Creative Example",
                          "creative_type": "image",
                          "is_private": false,
                          "creative_status": "active",
                          "resource_url": "https://usercontent-dev.everflowclient.io/1/offers/1/c/2/Screen%20Shot%202020-10-16%20at%2010.49.04%20AM.png",
                          "html_code": "",
                          "width": 0,
                          "height": 0,
                          "email_from": "",
                          "email_subject": "",
                          "time_created": 1602871237,
                          "time_saved": 1602871239,
                          "additional_offer_ids": null,
                          "is_apply_specific_affiliates": false
                      }
                  ]
              },
              "reporting": {
                  "imp": 0,
                  "total_click": 0,
                  "unique_click": 0,
                  "invalid_click": 0,
                  "duplicate_click": 0,
                  "ctr": 0,
                  "cv": 0,
                  "view_through_cv": 0,
                  "event": 0,
                  "cvr": 0,
                  "evr": 0,
                  "rpc": 0,
                  "rpm": 0,
                  "revenue": 0,
                  "redirect_traffic_revenue": 0
              },
              "payouts": {
                  "total": 1,
                  "entries": [
                      {
                          "network_offer_payout_revenue_id": 1,
                          "custom_payout_overwrite": false,
                          "network_custom_payout_revenue_setting_id": 0,
                          "payout_type": "cpa",
                          "entry_name": "Payout Example",
                          "payout_amount": 0.8,
                          "payout_percentage": 0,
                          "is_default": true,
                          "is_postback_disabled": false,
                          "is_enforce_caps": true
                      }
                  ]
              },
              "offer_affiliate_status": "public",
              "ruleset": {
                  "network_id": 1,
                  "network_ruleset_id": 0,
                  "time_created": 0,
                  "time_saved": 0,
                  "platforms": [],
                  "device_types": [],
                  "os_versions": [],
                  "brands": [],
                  "browsers": [],
                  "languages": [],
                  "countries": [],
                  "regions": [],
                  "cities": [],
                  "dmas": [],
                  "mobile_carriers": [],
                  "connection_types": [],
                  "ips": [],
                  "is_block_proxy": false,
                  "is_use_day_parting": false,
                  "day_parting_apply_to": "null_value",
                  "day_parting_timezone_id": 0,
                  "days_parting": [],
                  "isps": []
              },
              "urls": {
                  "total": 0,
                  "entries": []
              },
              "custom_payout_settings": {
                  "total": 0,
                  "entries": []
              },
              "remaining_caps": {
                  "remaining_daily_payout_cap": 10.3,
                  "remaining_daily_conversion_cap": -1,
                  "remaining_daily_click_cap": -1
              },
              "creative_bundle": {
                  "url": "https://everflow.everflowclient.io/creativebundles/QLTw3_5p4hy25NQtPKrBOpN1LN1Qp5Iz"
              },
              "channels": {
                  "total": 0,
                  "entries": []
              },
              "blocked_variables_count": 1,
                  "requirement_kpis": {
                      "total": 0,
                      "entries": []
                  },
              "requirement_tracking_parameters": {
                  "total": 0,
                  "entries": []
              }
          },
          "impression_tracking_url": ""
      }
  ],
  "paging": {
    "page": 0,
    "page_size": 0,
    "total_count": 0
  }
}

Find By ID

GET /v1/affiliates/offers/:offerId
This endpoint allows you to retrieve a visible Offer by ID.

Returns HTTP code 404 if the Offer doesn’t exist or is not visible.

Path Parameters

Parameter Description
offerId The ID of the offer you want to fetch

cURL
curl --request GET 'https://api.eflow.team/v1/affiliates/offers/<INSERT OFFER ID>' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--header 'content-type: application/json'
Response
{
   "network_offer_id":1,
   "network_id":1,
   "name":"Test Offer",
   "thumbnail_url":"",
   "network_category_id":18,
   "preview_url":"",
   "offer_status":"active",
   "currency_id":"USD",
   "caps_timezone_id":68,
   "date_live_until":"",
   "html_description":"",
   "is_using_explicit_terms_and_conditions":false,
   "terms_and_conditions":"",
   "is_force_terms_and_conditions":false,
   "visibility":"public",
   "is_caps_enabled":false,
   "is_using_suppression_list":false,
   "suppression_list_id":0,
   "network_tracking_domain_id":1,
   "daily_conversion_cap":0,
   "weekly_conversion_cap":0,
   "monthly_conversion_cap":0,
   "global_conversion_cap":0,
   "daily_payout_cap":0,
   "weekly_payout_cap":0,
   "monthly_payout_cap":0,
   "global_payout_cap":0,
   "daily_click_cap":0,
   "weekly_click_cap":0,
   "monthly_click_cap":0,
   "global_click_cap":0,
   "tracking_url":"https://www.test.com",
   "app_identifier":"",
   "time_created":1496373274,
   "time_saved":1661965494,
   "is_description_plain_text":false,
   "is_use_direct_linking":false,
   "relationship":{
      "category":{
         "network_category_id":18,
         "network_id":1,
         "name":"Business",
         "status":"active",
         "time_created":1489692867,
         "time_saved":1526478117
      },
      "creatives":{
         "total":0,
         "entries":[]
      },
      "reporting":{
         "imp":0,
         "total_click":0,
         "unique_click":0,
         "invalid_click":0,
         "duplicate_click":0,
         "ctr":0,
         "cv":0,
         "view_through_cv":0,
         "event":0,
         "cvr":0,
         "evr":0,
         "rpc":0,
         "rpm":0,
         "revenue":0,
         "redirect_traffic_revenue":0
      },
      "payouts":{
         "total":1,
         "entries":[
            {
               "network_offer_payout_revenue_id":1,
               "custom_payout_overwrite":false,
               "network_custom_payout_revenue_setting_id":0,
               "payout_type":"cpa",
               "entry_name":"",
               "payout_amount":0.015,
               "payout_percentage":0,
               "is_default":true,
               "is_postback_disabled":false,
               "is_enforce_caps":false
            }
         ]
      },
      "offer_affiliate_status":"public",
      "integrations":{
         "optizmo":{
            "mailer_access_key":"https://www.url.com/123321312",
            "optout_link":"https://www.url.com/312312312312312"
         },
         "ezepo":null,
         "invoca":{
            "enabled":false
         },
         "unsubcentral":null
      },
      "ruleset":{
         "network_id":5,
         "network_ruleset_id":0,
         "time_created":0,
         "time_saved":0,
         "platforms":[],
         "device_types":[],
         "os_versions":[],
         "browsers":[],
         "languages":[],
         "countries":[],
         "regions":[],
         "cities":[],
         "dmas":[],
         "mobile_carriers":[],
         "connection_types":[],
         "ips":[],
         "is_block_proxy":false,
         "is_use_day_parting":false,
         "day_parting_apply_to":"null_value",
         "day_parting_timezone_id":0,
         "days_parting":[],
         "isps":[],
         "brands":[],
         "postal_codes":[]
      },
      "urls":{
         "total":2,
         "entries":[
            {
               "network_offer_url_id":147,
               "network_id":1,
               "network_offer_id":1,
               "name":"Test 1",
               "preview_url":""
            },
            {
               "network_offer_url_id":148,
               "network_id":1,
               "network_offer_id":1,
               "name":"test2",
               "preview_url":""
            }
         ]
      },
      "custom_payout_settings":{
         "total":0,
         "entries":[]
      },
      "email":{
         "network_offer_id":1,
         "network_id":1,
         "is_enabled":false,
         "subject_lines":"",
         "from_lines":""
      },
      "email_optout":{
         "network_offer_id":1,
         "network_id":1,
         "is_enabled":false,
         "suppression_file_link":"",
         "unsub_link":""
      },
      "creative_bundle":{
         "url":"https://www.url.com/creativebundles/312312312321"
      },
      "channels":{
         "total":0,
         "entries":[]
      },
      "blocked_variables_count":2,
      "requirement_kpis":{
         "total":0,
         "entries":[]
      },
      "requirement_tracking_parameters":{
         "total":0,
         "entries":[]
      },
      "meta":{
         "network_offer_id":1,
         "network_id":1,
         "app_id":"",
         "meta_platform":"",
         "advertiser_campaign_name":"",
         "bundle_id":"",
         "category":"",
         "store_url":"",
         "score_rating":0,
         "total_rating":0,
         "size":0,
         "developer":"",
         "version":"",
         "is_app_unavailable":true,
         "time_created":1606422919,
         "time_app_data_saved":0,
         "time_saved":1661965494
      },
      "product_feeds": [
        {
          "network_advertiser_product_feed_id": 5,
          "network_id": 1,
          "network_advertiser_id": 65,
          "name": "test rando col",
          "status": "active",
          "file_asset_id": 8,
          "date_valid_from": 0,
          "date_valid_to": 0,
          "date_valid_timezone_id": 90,
          "relationship": {
            "document_file_asset": {
              "network_asset_id": 8,
              "content_type": "text/csv",
              "filename": "products-3.csv",
              "url": "http://usercontent-dev.everflowclient.io/1/advertisers/65/productfeed/products-3.csv",
              "file_size": 654,
              "image_width": 0,
              "image_height": 0,
              "optimized_thumbnail_url": ""
            }
          },
          "time_saved": 1683644302,
          "time_created": 1683644302
        }
      ]
   },
   "impression_tracking_url":"",
   "redirect_tracking_url":""
}

Find Tracking URL

GET /v1/affiliates/offers/:offerId/url/:urlId
This endpoint lets you pull a tracking link for a runnable Offer by Id.

You can supply 0 for the urlId if no extra destination urls exist or if you do not wish to use one.

Returns HTTP code 404 if the Offer doesn’t exist. Returns HTTP code 400 if not allowed to run this Offer.

Path Parameters

Parameter Description
offerId The ID of an offer
urlId The id of an extra destination url

cURL
curl --request GET 'https://api.eflow.team/v1/affiliates/offers/<INSERT OFFER ID>/url/<INSERT URL ID>' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--header 'content-type: application/json'
Response
{
    "url": "http://www.servetrack.test/9W598/2CTPL/?uid=1"
}

Find Impression URL

GET /v1/affiliates/offers/:offerId/impressionurl/:urlId
This endpoint lets you pull a tracking link for a runnable Offer by Id.

You can supply 0 for the urlId if no extra destination urls exist or if you do not wish to use one.

Returns HTTP code 404 if the Offer doesn’t exist. Returns HTTP code 400 if not allowed to run this Offer.

Path Parameters

Parameter Description
offerId The ID of an offer
urlId The id of an extra destination url

cURL
curl --request GET 'https://api.eflow.team/v1/affiliates/offers/<INSERT OFFER ID>/impressionurl/<INSERT URL ID>' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--header 'content-type: application/json'
Response
{
    "url": "http://www.servetrack.test/i/9W598/2CTPL/?uid=1"
}

Create Application

POST /v1/affiliates/offers/:offerId/application

This endpoint allows you to apply to run an Offer that requires approval. Use offer_id to make application.

Returns HTTP code 400 if the Offer doesn’t exist or do not require approval.

Path Parameters

Parameter Description
offerId The ID of an offer

Note that certain offers do require an “application questionnaire” to be filled. When that’s the case, the answers to the application questionnaire must be passed in the body of the request. You can find out if an application questionnaire must be filled by looking at the application_questionnaire relationship in the response of the Find By ID endpoint (it can only be present on offers that are require_approval).

While the body of a request to create an application on an offer without a questionnaire will be empty, a payload that contains questionnaire answers will look like so :

{
    "questionnaire_answers":
    [
        {
            "network_application_questionnaire_custom_field_id": 1,
            "field_value": "first answer"
        },
        {
            "network_application_questionnaire_custom_field_id": 2,
            "field_value": "second answer"
        },
        ...
    ]
}
cURL
curl --request POST 'https://api.eflow.team/v1/affiliates/offers/<INSERT OFFER ID>/application' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--header 'content-type: application/json'
Response
{
    "network_application_id": 2,
    "network_id": 1,
    "network_affiliate_id": 7,
    "network_offer_id": 6,
    "network_affiliate_user_id": 11,
    "application_status": "pending",
    "time_created": 1638453818,
    "time_saved": 1638453818,
    "relationship":
    {
        "affiliate":
        {
            "network_affiliate_id": 7,
            "network_id": 1,
            "name": "John Doe Inc.",
            "account_status": "active",
            "network_employee_id": 1,
            "internal_notes": "",
            "has_notifications": true,
            "network_traffic_source_id": 0,
            "account_executive_id": 0,
            "adress_id": 1,
            "default_currency_id": "USD",
            "is_contact_address_enabled": true,
            "enable_media_cost_tracking_links": true,
            "time_created": 1636144876,
            "time_saved": 1637351717,
            "referrer_id": 0
        },
        "offer":
        {
            "network_offer_id": 6,
            "network_id": 1,
            "network_advertiser_id": 13,
            "network_offer_group_id": 1,
            "name": "Example Offer",
            "offer_status": "active",
            "network_tracking_domain_id": 1,
            "visibility": "require_approval",
            "currency_id": "USD"
        },
        "advertiser":
        {
            "network_advertiser_id": 13,
            "network_id": 1,
            "name": "Advertising Company Inc.",
            "account_status": "active"
        }
    }
}