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

# Get all creatives for the account

`GET /v2/creatives`

## Request

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

Supports pagination and filtering by status and type.

## Query parameters

- `list_id` string
- `per_page` string
- `page` string
- `creative_type` string
- `status` string

## Response `200`

Success

- CreativesResponse
  - `creatives` CreativeResponse[]: Array of creatives
    - `character_count` integer: Estimated character count
    - `created_at` string, date-time: Creation timestamp
    - `creative_type` string: Type: automated, one_time, welcome
    - `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.
    - `end_date` string, nullable: Last day the creative may be sent, inclusive (YYYY-MM-DD, in dates_timezone). Null = no end.
    - `id` integer: Creative ID
    - `list_control_ids` integer[]: List IDs for include/exclude control
    - `list_control_mode` string: List control mode: all (default), include, exclude
    - `message` string: Message template with {{linkN}} placeholders
    - `name` string: Creative name
    - `offer_links` OfferLink[]: Offer link mappings
      - `custom_url` string: HTTPS destination URL; exactly one of offer_id or custom_url is required
      - `key` string: Placeholder key (e.g., link1)
      - `offer_id` string: Offer ID; exactly one of offer_id or custom_url is required
      - `offer_source` 'sms' | 'oms': Offer source for offer_id; defaults to sms
      - `url` string: Deprecated and ignored; use custom_url for a custom destination
      - `url_params` object: Additional URL parameters
    - `offers` string[]: List of offer IDs used
    - `segment_count` integer: Estimated SMS segment count
    - `start_date` string, nullable: First day the creative may be sent (YYYY-MM-DD, in dates_timezone). Null = no start limit.
    - `status` string: Status: active, paused, archived
  - `pagination` Pagination
    - `page` integer: Current page
    - `per_page` integer: Items per page
    - `total` integer: Total items
    - `total_pages` integer: Total pages

## Other responses

- `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)