--- title: "Find All Runnable Offers" method: GET path: "/partners/offersrunnable" tags: ["Marketplace Offers"] --- # Find All Runnable Offers `GET /partners/offersrunnable` ## Query parameters - `page` integer - `page_size` integer - `relationship` 'category' | 'creatives' | 'reporting' | 'payouts' | 'ruleset' | 'urls' | 'channels' | 'creative_bundle' | 'remaining_caps' | 'custom_payout_settings' ## Request body - object - `filters` object — Filters to narrow the offer results. - `categories` string[] — Filter by category names. - `channels` string[] — Filter by channel names. - `payout_types` string[] — Filter by payout type (e.g. cpa, cpc, cpm). - `country_ids` integer[] — Filter by country IDs. - `platform_ids` integer[] — Filter by platform IDs. - `network_ids` integer[] — Filter by network IDs. - `search_terms` object[] — Text search filters. - `search_type` 'advertiser_name' | 'category' | 'offer_id' | 'offer_name', required — The field to search on. - `value` string, required — The search value. ## Response `200` - object - `offers` MarketplaceOffer[] — Array of runnable offer objects. - `network_offer_id` integer — Unique offer ID. - `network_id` integer — Network ID that owns this offer. - `name` string — Offer name. - `offer_status` 'active' | 'paused' | 'pending' | 'deleted' — Current status of the offer. - `thumbnail_url` string — Offer thumbnail image URL. - `network_category_id` integer — Category ID for the offer. - `preview_url` string — Preview URL for the offer landing page. - `currency_id` string — Currency used for this offer (e.g. "USD"). - `html_description` string — HTML description of the offer. - `visibility` 'public' | 'require_approval' | 'private' — Offer visibility setting. - `is_caps_enabled` boolean — Whether caps are enabled for this offer. - `daily_conversion_cap` integer — Maximum conversions allowed per day. 0 means unlimited. - `weekly_conversion_cap` integer — Maximum conversions allowed per week. 0 means unlimited. - `monthly_conversion_cap` integer — Maximum conversions allowed per month. 0 means unlimited. - `global_conversion_cap` integer — Maximum total conversions allowed. 0 means unlimited. - `daily_payout_cap` integer — Maximum payout amount per day. 0 means unlimited. - `weekly_payout_cap` integer — Maximum payout amount per week. 0 means unlimited. - `monthly_payout_cap` integer — Maximum payout amount per month. 0 means unlimited. - `global_payout_cap` integer — Maximum total payout amount. 0 means unlimited. - `daily_click_cap` integer — Maximum clicks allowed per day. 0 means unlimited. - `weekly_click_cap` integer — Maximum clicks allowed per week. 0 means unlimited. - `monthly_click_cap` integer — Maximum clicks allowed per month. 0 means unlimited. - `global_click_cap` integer — Maximum total clicks allowed. 0 means unlimited. - `tracking_url` string — The click tracking URL used to route traffic. - `impression_tracking_url` string — URL for tracking impressions. - `redirect_tracking_url` string — URL for redirect-based tracking. - `time_created` integer — Unix timestamp of when the offer was created. - `time_saved` integer — Unix timestamp of the last update to the offer. - `app_identifier` string — App identifier. - `caps_timezone_id` integer — Timezone ID for cap calculations. - `date_live_until` string — Offer expiration date (empty string if none). - `is_description_plain_text` boolean — Whether description is plain text. - `is_force_terms_and_conditions` boolean — Whether terms acceptance is forced. - `is_use_direct_linking` boolean — Whether direct linking is allowed. - `is_using_explicit_terms_and_conditions` boolean — Whether offer has explicit terms and conditions. - `is_using_suppression_list` boolean — Whether offer uses suppression list. - `network_tracking_domain_id` integer — Tracking domain ID. - `suppression_list_id` integer — Suppression list ID (0 if none). - `terms_and_conditions` string — Terms and conditions text. - `relationship` object — Related data included in the response. The list endpoint and single-offer endpoint return slightly different default relationship keys. - `blocked_variables_count` integer — Count of blocked variables. - `category` object — Offer category information. - `network_category_id` integer — Unique category ID. - `network_id` integer — Network ID that owns this category. - `name` string — Category name. - `status` string — Category status. - `time_created` integer — Unix timestamp of when the category was created. - `time_saved` integer — Unix timestamp of the last update to the category. - `channels` object — Channels associated with this offer. - `entries` object[] - `network_channel_id` integer — Unique channel ID. - `network_id` integer — Network ID that owns this channel. - `name` string — Channel name. - `status` string — Channel status. - `time_created` integer — Unix timestamp of when the channel was created. - `time_saved` integer — Unix timestamp of the last update to the channel. - `total` integer - `creative_bundle` object — Creative bundle information. - `url` string — URL to download the creative bundle archive. - `creatives` object — Creatives associated with this offer. - `entries` object[] - `network_offer_creative_id` integer — Unique creative ID. - `network_id` integer — Network ID that owns this creative. - `network_offer_id` integer — Offer ID this creative belongs to. - `name` string — Creative name. - `creative_type` string — Type of creative (e.g. image, html, email). - `creative_status` string — Status of the creative. - `width` integer — Width in pixels (for image/banner creatives). - `height` integer — Height in pixels (for image/banner creatives). - `resource_url` string — URL of the creative resource file. - `html_code` string — HTML code for HTML creatives. - `is_private` boolean — Whether the creative is private. - `is_apply_specific_affiliates` boolean — Whether the creative is restricted to specific affiliates. - `email_subject` string — Email subject line for email creatives. - `email_subject_lines` string — Additional email subject lines. - `email_from` string — Email from address for email creatives. - `email_from_lines` string — Additional email from lines. - `additional_offer_ids` string — Additional offer IDs associated with this creative. - `time_created` integer — Unix timestamp of when the creative was created. - `time_saved` integer — Unix timestamp of the last update to the creative. - `total` integer - `custom_payout_settings` object — Custom payout settings for this offer. - `entries` object[] - `total` integer - `email` object — Email configuration. Only present on the single-offer endpoint. - `network_id` integer — Network ID. - `network_offer_id` integer — Offer ID. - `is_enabled` boolean — Whether email creatives are enabled. - `from_lines` string — Default email from lines. - `subject_lines` string — Default email subject lines. - `email_optout` object — Email opt-out settings. Only present on the single-offer endpoint. - `network_id` integer — Network ID. - `network_offer_id` integer — Offer ID. - `is_enabled` boolean — Whether email opt-out is enabled. - `unsub_link` string — Unsubscribe link URL. - `suppression_file_link` string — Suppression file download link. - `integrations` object — Third-party integrations. Only present on the single-offer endpoint. - `invoca` object — Invoca integration settings. - `enabled` boolean — Whether Invoca integration is enabled. - `retreaver` object — Retreaver integration settings. - `ringa` object — Ringa integration settings. - `ezepo` object — Ezepo integration settings. - `optizmo` object — Optizmo integration settings. - `unsubcentral` object — UnsubCentral integration settings. - `meta` object — App store metadata. - `network_id` integer — Network ID. - `network_offer_id` integer — Offer ID. - `meta_platform` string — App store platform (e.g. ios, android). - `app_id` string — App store application ID. - `bundle_id` string — App bundle identifier. - `store_url` string — App store URL. - `category` string — App store category. - `developer` string — App developer name. - `version` string — App version. - `size` integer — App size. - `score_rating` number — App rating score. - `total_rating` integer — Total number of ratings. - `advertiser_campaign_name` string — Advertiser campaign name. - `is_app_unavailable` boolean — Whether the app is unavailable in the store. - `time_app_data_saved` integer — Unix timestamp of when app data was last fetched. - `time_created` integer — Unix timestamp of when the metadata was created. - `time_saved` integer — Unix timestamp of the last update to the metadata. - `network` object — Network information. Only present on the list endpoint. - `network_id` integer — Network ID. - `displayed_name` string — Display name of the network. - `offer_affiliate_status` string — Affiliate's approval status for this offer (e.g. "public", "approved"). - `payouts` object — Payout configurations for this offer. - `entries` object[] - `network_offer_payout_revenue_id` integer — Unique payout/revenue entry ID. - `entry_name` string — Name of the payout entry. - `payout_type` string — Payout type (e.g. cpa, cpc, cpi). - `payout_amount` number — Payout amount per conversion. - `payout_percentage` number — Payout percentage (for revshare). - `is_default` boolean — Whether this is the default payout entry. - `is_enforce_caps` boolean — Whether caps are enforced for this payout. - `is_postback_disabled` boolean — Whether postback is disabled for this payout. - `network_custom_payout_revenue_setting_id` integer — Custom payout revenue setting ID. - `custom_payout_overwrite` boolean — Whether this entry overrides the default custom payout revenue setting. - `total` integer - `remaining_caps` object — Remaining cap amounts. - `remaining_daily_conversion_cap` integer — Remaining daily conversion cap. -1 means unlimited. - `remaining_daily_payout_cap` number — Remaining daily payout cap. -1 means unlimited. - `remaining_daily_click_cap` integer — Remaining daily click cap. -1 means unlimited. - `reporting` object — Reporting metrics for this offer. - `imp` integer — Total impressions. - `total_click` integer — Total clicks. - `unique_click` integer — Unique clicks. - `duplicate_click` integer — Duplicate clicks. - `invalid_click` integer — Invalid or flagged clicks. - `cv` integer — Total conversions. - `event` integer — Total events. - `view_through_cv` integer — View-through conversions. - `ctr` number — Click-through rate. - `cvr` number — Conversion rate. - `evr` number — Event rate. - `revenue` number — Total revenue. - `rpc` number — Revenue per click. - `rpm` number — Revenue per mille (thousand impressions). - `on_hold_conversion_count` integer — Number of conversions on hold. - `on_hold_potential_revenue` number — Potential revenue from on-hold conversions. - `redirect_traffic_revenue` number — Revenue from redirect traffic. - `requirement_kpis` object — KPI requirements. - `entries` object[] - `total` integer - `requirement_tracking_parameters` object — Required tracking parameters. - `entries` object[] - `total` integer - `ruleset` object — Targeting ruleset for this offer. - `network_ruleset_id` integer — Unique ruleset ID. - `network_id` integer — Network ID. - `is_block_proxy` boolean — Whether proxy traffic is blocked. - `is_use_day_parting` boolean — Whether day parting is enabled. - `day_parting_apply_to` string — What day parting applies to. - `day_parting_timezone_id` integer — Timezone ID for day parting. - `days_parting` object[] — Day parting schedule entries. - `countries` object[] — Targeted countries. - `regions` object[] — Targeted regions/states. - `cities` object[] — Targeted cities. - `dmas` object[] — Targeted DMA regions. - `postal_codes` object[] — Targeted postal codes. - `ips` object[] — Targeted IP addresses or ranges. - `platforms` object[] — Targeted operating system platforms. - `network_targeting_platform_id` integer — Unique targeting platform entry ID. - `network_id` integer — Network ID. - `platform_id` integer — Platform ID. - `label` string — Platform label (e.g. iOS, Android). - `match_type` string — Match type (e.g. include, exclude). - `targeting_type` string — Targeting type. - `os_versions` object[] — Targeted OS versions. - `network_targeting_os_version_id` integer — Unique targeting OS version entry ID. - `network_id` integer — Network ID. - `os_version_id` integer — OS version ID. - `platform_id` integer — Platform ID this version belongs to. - `label` string — OS version label (e.g. iOS 14.0+). - `match_type` string — Match type (e.g. include, exclude). - `targeting_type` string — Targeting type. - `browsers` object[] — Targeted browsers. - `network_targeting_browser_id` integer — Unique targeting browser entry ID. - `network_id` integer — Network ID. - `browser_id` integer — Browser ID. - `label` string — Browser label (e.g. Chrome, Safari). - `match_type` string — Match type (e.g. include, exclude). - `targeting_type` string — Targeting type. - `device_types` object[] — Targeted device types. - `network_targeting_device_type_id` integer — Unique targeting device type entry ID. - `network_id` integer — Network ID. - `device_type_id` integer — Device type ID. - `label` string — Device type label (e.g. Mobile, Desktop). - `match_type` string — Match type (e.g. include, exclude). - `targeting_type` string — Targeting type. - `brands` object[] — Targeted device brands. - `languages` object[] — Targeted browser languages. - `network_targeting_browser_language_id` integer — Unique targeting language entry ID. - `network_id` integer — Network ID. - `browser_language_id` integer — Browser language ID. - `label` string — Language label (e.g. English, French). - `match_type` string — Match type (e.g. include, exclude). - `targeting_type` string — Targeting type. - `mobile_carriers` object[] — Targeted mobile carriers. - `connection_types` object[] — Targeted connection types. - `isps` object[] — Targeted ISPs. - `time_created` integer — Unix timestamp of when the ruleset was created. - `time_saved` integer — Unix timestamp of the last update to the ruleset. - `suppression_file_asset` object — Suppression file asset. Only present on the single-offer endpoint. - `network_asset_id` integer — Unique asset ID. - `filename` string — Original filename. - `url` string — URL to download the asset. - `content_type` string — MIME content type. - `file_size` integer — File size in bytes. - `image_width` integer — Image width in pixels (0 if not an image). - `image_height` integer — Image height in pixels (0 if not an image). - `optimized_thumbnail_url` string — Optimized thumbnail URL. - `thumbnail_asset` object — Thumbnail asset. - `network_asset_id` integer — Unique asset ID. - `filename` string — Original filename. - `url` string — URL to download the asset. - `content_type` string — MIME content type. - `file_size` integer — File size in bytes. - `image_width` integer — Image width in pixels. - `image_height` integer — Image height in pixels. - `optimized_thumbnail_url` string — Optimized thumbnail URL. - `today_revenue` string — Today's revenue formatted as a string (e.g. "CLP $0.00"). Only present on the list endpoint. - `urls` object — Offer URLs. - `entries` object[] - `network_offer_url_id` integer — Unique offer URL ID. - `network_id` integer — Network ID. - `network_offer_id` integer — Offer ID this URL belongs to. - `name` string — URL name or label. - `preview_url` string — Preview URL for this landing page. - `total` integer - `paging` object - `page` integer — Current page number. - `page_size` integer — Number of results per page. - `total_count` integer — Total number of runnable offers. - `last_sync` integer — Unix timestamp of when the marketplace data was last synced. --- [API](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains.md) · [All operations](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/everflow/everflow-network-api-tracking-domains/revisions/39242cee0e32/schema)