---
title: "Retrieve a toll-free campaign"
method: GET
path: "/toll_free_campaigns/{campaign_id}"
tags: ["Toll-Free Campaigns"]
---

# Retrieve a toll-free campaign

`GET /toll_free_campaigns/{campaign_id}`

## Request

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

Retrieves a toll-free campaign object.

## Path parameters

- `campaign_id` string, required: The ID of the toll-free campaign to retrieve.

## Response `200`

Toll-free campaign

- TollFreeCampaign: A toll-free campaign registration for a phone number.
  - `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

## Other responses

- `default`: Error

## Changes

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

[Operation history](https://skmtc.dev/surgeapi/apis/surge/changes/toll_free_campaigns/:campaign_id/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)