---
title: "List Brand Campaigns"
method: GET
path: "/v3/10dlc/brands/{brand_id}/campaigns"
tags: ["10DLC"]
---

# List Brand Campaigns

`GET /v3/10dlc/brands/{brand_id}/campaigns`

Returns a paginated list of 10DLC Campaigns associated with the 10DLC Brand identified by `brand_id`.

## Path parameters

- `brand_id` string, required

## Query parameters

- `name` string
- `usecase` string
- `status` string
- `mock` boolean
- `created_before` string, date
- `created_after` string, date
- `page` integer
- `per_page` integer

## Response `200`

Returns a paginated list of 10DLC Campaigns.

- object — Paginated list of 10DLC Campaigns.
  - `items` TenDLCCampaign[], required — 10DLC Campaigns on the current page that match the filter criteria.
    - `affiliate_marketing` boolean, required — Indicates whether the Campaign is used for affiliate marketing.
    - `age_gated` boolean, required — Indicates whether the Campaign messages contain age-gated content.
    - `auto_renewal` boolean, required — Indicates whether the Campaign should be automatically renewed.
    - `last_bill_date` string, nullable, required — Date and time the Campaign was last billed in ISO 8601 format. `null` if the Campaign has never been billed.
    - `next_bill_date` string, nullable, required — Date and time the Campaign will be billed next in ISO 8601 format. `null` if the next billing date is not scheduled.
    - `direct_lending` boolean, required — Indicates whether the Campaign messages contain direct lending content.
    - `embedded_links` boolean, required — Indicates whether the Campaign messages contain embedded links.
    - `embedded_phones` boolean, required — Indicates whether the Campaign messages contain embedded phone numbers.
    - `embedded_link_sample` string, nullable, required — Sample of an embedded link used in Campaign messages.
    - `brand_id` string, required — Unique identifier of the Brand that owns the Campaign.
    - `campaign_id` string, required — Unique identifier of the Campaign assigned by the registry.
    - `description` string, nullable, required — Description of the Campaign and its messaging purpose.
    - `optin_workflow` string, nullable, required — Description of the workflow through which subscribers opt in to the Campaign.
    - `feedback` string, nullable, required — Feedback from the registry explaining the current `status`.
    - `help` boolean, required — Indicates whether the campaign includes a help system (for example, keyword: HELP, INFO).
    - `help_keywords` string, required — Comma-separated list of help keywords. Keywords are case-insensitive.
    - `help_message` string, nullable, required — Help message sent upon receiving a help keyword.
    - `optin` boolean, required — Indicates whether the Campaign requires subscriber opt-in.
    - `optin_keywords` string, required — Comma-separated list of opt-in keywords. Keywords are case-insensitive.
    - `optin_message` string, nullable, required — Opt-in message sent upon receiving an opt-in keyword.
    - `optout` boolean, required — Indicates whether the campaign includes an opt-out system (for example, keyword: STOP, QUIT).
    - `optout_keywords` string, required — Comma-separated list of opt-out keywords. Keywords are case-insensitive.
    - `optout_message` string, nullable, required — Opt-out message sent upon receiving an opt-out keyword.
    - `name` string, required — Display name of the Campaign.
    - `created_at` string, required — Timestamp when the Campaign was created, in ISO 8601 format.
    - `sample1` string, nullable, required — Sample message demonstrating the content sent through the Campaign.
    - `sample2` string, nullable, required — Sample message demonstrating the content sent through the Campaign.
    - `sample3` string, nullable, required — Sample message demonstrating the content sent through the Campaign.
    - `sample4` string, nullable, required — Sample message demonstrating the content sent through the Campaign.
    - `sample5` string, nullable, required — Sample message demonstrating the content sent through the Campaign.
    - `updated_at` string, required — Timestamp when the Campaign was last updated, in ISO 8601 format.
    - `mock` boolean, required — Indicates whether the Campaign is a mock campaign used for testing. Mock campaigns cannot send production traffic.
    - `usecase` string, required — Registered use case for the Campaign, such as `2FA` or `MARKETING`.
    - `monthly_fee` string, required — Recurring monthly fee charged for the Campaign, as a decimal string.
    - `privacy_policy` string, nullable, required — Privacy policy URL.
    - `terms_conditions` string, nullable, required — Terms and conditions URL.
    - `status` string, required — Current registration status of the Campaign, such as `APPROVED` or `PENDING`.
    - `phone_numbers` string[], required — Phone numbers assigned to the Campaign, in E.164 format.
  - `pagination` object, required — Pagination metadata for the result set.
    - `current_page` integer, required — Current page number.
    - `per_page` integer, required — Number of records per page.
    - `total` integer, required — Total number of records.
    - `total_pages` integer, required — Total number of pages.

## Other responses

- `403` — Returns when the 10DLC feature is disabled for the account.
- `404` — Returns when no 10DLC Brand matches `brand_id`.

---

[API](https://skmtc.net/wavix/apis/wavix-apis.md) · [All operations](https://skmtc.net/wavix/apis/wavix-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wavix/wavix-apis/revisions/b22f170488b6/schema)