---
title: "Get all offers for the account"
method: GET
path: "/v2/offers"
tags: ["offers-v2"]
---

# Get all offers for the account

`GET /v2/offers`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/offers`
- Auth: API key in header `X-Api-Key`

Supports pagination and status filtering.

## Query parameters

- `per_page` string
- `page` string
- `platform_config_id` string
- `external_platform` string
- `external_id` string
- `status` string

## Response `200`

Success

- OffersResponse
  - `offers` OfferResponse[]: Array of offers
    - `advertiser` string, nullable: Advertiser entity ID owned by this account, or null
    - `advertiser_id` string: Advertiser ID
    - `advertiser_name` string: Advertiser name
    - `created_at` string, date-time: Creation timestamp
    - `dates_timezone` string, nullable: Timezone for start_date/end_date: America/New_York, America/Chicago, America/Denver, America/Los_Angeles or UTC. Null = the account timezone.
    - `day_parting` object: Allow-list of send windows by lowercase weekday, evaluated in Eastern Time. Shape {"monday": [{"start": "HH:MM", "end": "HH:MM"}]}; 24h zero-padded times, start < end (no overnight crossing), max 6 ranges/day; omit a weekday to block it.
    - `day_parting_enabled` boolean: Whether intra-day send-window restrictions apply
    - `end_date` string, nullable: Last day the offer may be sent, inclusive (YYYY-MM-DD, in dates_timezone). Null = no end.
    - `excluded_days_of_week` string[]: Weekdays the SMS ad server will not send this offer (contact-local)
    - `external_id` string: External platform ID
    - `external_platform` string: External platform: tune, everflow, or null
    - `filter_bots` boolean: Whether to filter bots
    - `id` string: Offer ID
    - `metadata` object: Custom metadata fields
    - `name` string: Offer name
    - `payout` number: Payout amount
    - `payout_type` string: Payout type: cpa or cpc
    - `platform_config_id` string, nullable: ID of the integration this offer is linked to, or null when unlinked
    - `start_date` string, nullable: First day the offer may be sent (YYYY-MM-DD, in dates_timezone). Null = no start limit.
    - `status` string: Status: active, paused, archived
    - `tracking_url` string: Tracking URL
    - `updated_at` string, date-time: Last update timestamp
  - `pagination` Pagination
    - `page` integer: Current page
    - `per_page` integer: Items per page
    - `total` integer: Total items
    - `total_pages` integer: Total pages

## Other responses

- `400`: Validation error
- `401`: Authentication error

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)