---
title: "List toll-free campaigns"
method: GET
path: "/accounts/{account_id}/toll_free_campaigns"
tags: ["Toll-Free Campaigns"]
---

# List toll-free campaigns

`GET /accounts/{account_id}/toll_free_campaigns`

## Request

- Base URL: `https://api.surge.app`
- URL: `https://api.surge.app/accounts/{account_id}/toll_free_campaigns`
- Auth: HTTP bearer

List all toll-free campaigns for an account with cursor-based pagination.

## Path parameters

- `account_id` string, required: The account ID to list toll-free campaigns for.

## Query parameters

- `after` string: Cursor for forward pagination. Use the next_cursor from a previous response.
- `before` string: Cursor for backward pagination. Use the previous_cursor from a previous response.

## Response `200`

List of toll-free campaigns

- TollFreeCampaignList: A paginated list of toll-free campaigns
  - `data` TollFreeCampaign[], required: The list of toll-free campaigns
    - `consent_flows` TollFreeCampaignConsentFlow[], required
      - union: A consent flow returned on toll-free campaign responses.
        - object
          - `script` string, required
          - `type` 'verbal', required
        - object
          - `form_url` string, uri, required
          - `type` 'web_form', required
        - object
          - `screenshot` object, required
            - `reason` 'behind_login' | 'under_construction' | 'other', required
            - `reason_other` string
          - `type` 'web_form', required
        - object
          - `keywords` string[]
          - `type` 'text', required
        - object
          - `type` 'paper_form', required
    - `description` string, nullable, required
    - `id` string, required: The toll-free campaign ID
    - `includes` string[], required
    - `message_samples` string[], required
    - `phone_number_id` string, required: The toll-free phone number ID
    - `privacy_policy_url` string, uri, nullable, required
    - `status` 'active' | 'canceled' | 'created' | 'in_review' | 'rejected', required: The current status of the toll-free campaign.
    - `terms_and_conditions_url` string, uri, nullable, required
    - `use_cases` string[], required
  - `pagination` Pagination, required: Cursor-based pagination information
    - `next_cursor` string, nullable: Cursor for the next page of results. Null if there is no next page.
    - `previous_cursor` string, nullable: Cursor for the previous page of results. Null if there is no previous page.

## Other responses

- `default`: Error

## Changes

- **2026-10-16** `912b2a3101fc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/surgeapi/apis/surge/changes/accounts/:account_id/toll_free_campaigns/get.md)

---

[API](https://skmtc.dev/surgeapi/apis/surge.md) - [All operations](https://skmtc.dev/surgeapi/apis/surge/llms.txt) - [OpenAPI document](https://skmtc.dev/surgeapi/apis/surge/revisions/bb534713d694?raw)