---
title: "Get a list of campaign briefs by country code for the current resource."
method: GET
path: "/tollfreeVerification/countries/{countryCode}/campaignBriefs"
tags: ["TollFreeVerification - CampaignBrief"]
---

# Get a list of campaign briefs by country code for the current resource.

`GET /tollfreeVerification/countries/{countryCode}/campaignBriefs`

## Request

- Base URL: `{endpoint}`
- URL: `{endpoint}/tollfreeVerification/countries/{countryCode}/campaignBriefs`
- Auth: none declared

## Path parameters

- `countryCode` string, required

## Query parameters

- `skip` integer
- `top` integer
- `api-version` string, required

## Response `200`

Success

- CampaignBriefs: A wrapper for a list of CampaignBrief entities.
  - `campaignBriefs` CampaignBrief[]: List of Campaign Briefs.
    - `id` string, uuid, required: Campaign Brief Id.
    - `status` 'submitted' | 'approved' | 'updateRequested' | 'draft' | 'cancelled' | 'denied': Campaign Brief status e.g. 'submitted', 'approved', etc
    - `reviewNotes` ReviewNote[]: Notes added to the Campaign Brief after being reviewed to help customer understand review results and necessary follow up actions.
      - `message` string: Note related to a Campaign Brief that may imply changes needed from the client.
      - `date` string, date-time: Date and time when the note was added to the Campaign Brief.
    - `submissionDate` string, date-time: Date and time when the Campaign Brief was submitted.
    - `statusUpdatedDate` string, date-time: Last date and time when the Campaign Brief status was updated.
    - `countryCode` string: Country code of the Campaign Brief
    - `businessPointOfContact` BusinessPointOfContact
      - `firstName` string: First name of the contact at the business.
      - `lastName` string: Last name of the contact at the business.
      - `phone` string: Phone number of the contact at the business.
      - `email` string: Email of the contact at the business.
      - `address` Address
        - `addressLine1` string: Address line 1.
        - `addressLine2` string: Address line 2.
        - `locality` string: The Locality. That would be the City for US addresses, for example.
        - `administrativeDivision` string: The Administrative Division. That would be the State for US addresses, for example.
        - `postalCode` string: Postal code.
        - `country` string: Country.
    - `businessInformation` BusinessInformation
      - `companyName` string: Business Name.
      - `companyUrl` string: Url of corporate website.
      - `address` Address
        - `addressLine1` string: Address line 1.
        - `addressLine2` string: Address line 2.
        - `locality` string: The Locality. That would be the City for US addresses, for example.
        - `administrativeDivision` string: The Administrative Division. That would be the State for US addresses, for example.
        - `postalCode` string: Postal code.
        - `country` string: Country.
    - `useCaseInfo` UseCaseInfo
      - `sampleMessages` string[]: Sample of messages that will be sent to customers via Sms.
      - `useCase` 'TwoFactorAuthentication' | 'AppNotifications' | 'Appointments' | 'Auctions' | 'AutoRepairServices' | 'BankTransfers' | 'Billing' | 'BookingConfirmations' | 'BusinessUpdates' | 'CareerTraining' | 'Chatbot' | 'ConversationalOrAlerts' | 'CourierServicesAndDeliveries' | 'COVID19Alerts' | 'EmergencyAlerts' | 'EventsAndPlanning' | 'FinancialServices' | 'FraudAlerts' | 'Fundraising' | 'GeneralMarketing' | 'GeneralSchoolUpdates' | 'HealthcareAlerts' | 'HousingCommunityUpdates' | 'HROrStaffing' | 'InsuranceServices' | 'JobDispatch' | 'LegalServices' | 'Mixed' | 'MotivationalReminders' | 'NotaryNotifications' | 'OrderNotifications' | 'Political' | 'Works' | 'RealEstateServices' | 'ReligiousServices' | 'RepairAndDiagnosticsAlerts' | 'RewardsProgram' | 'Surveys' | 'SystemAlerts' | 'VotingReminders' | 'WaitlistAlerts' | 'WebinarReminders' | 'WorkshopAlerts' | 'Other': Use case the campaign will be sending messages for e.g. appointments, sweepstakes.
      - `useCaseSummary` string: Description of how the use case is used in the campaign.
    - `phoneNumbers` string[]: List of numbers provisioned for the Campaign e.g. 18881234567
    - `estimatedMonthlyVolume` 'V10' | 'V100' | 'V1000' | 'V10000' | 'V100000' | 'V250000' | 'V500000' | 'V750000' | 'V1000000' | 'V5000000' | 'V10000000OrMore': Estimated total messages per month.
    - `additionalInformation` string: Campaign opt in additional information - image URLs or opt in description.
    - `attachments` CampaignBriefAttachmentSummary[]: A list of summarized data of attachments currently added to the Campaign Brief
      - `id` string, uuid: Campaign Brief Attachment Id.
      - `type` 'optInSmsKeyword' | 'optInIVR' | 'optInPointOfSale' | 'optInWebsite' | 'optInPaperForm' | 'optInOther' | 'optInDescription': Attachment type describing the purpose of the attachment e.g. 'callToAction', 'termsOfService'
      - `fileName` string: The name of the attached file e.g. 'myFile01'
    - `optInDetails` OptInDetails
      - `description` string
      - `options` Option[]
        - `type` 'keywordSMS' | 'website' | 'interactiveVoiceResponse' | 'pointOfSale' | 'paperForm' | 'other', required
        - `imageUrls` string[]
    - `multipleNumbersJustification` string
    - `dba` string: Doing Business As (DBA). Must be filled if the company name used to contact customers differs from the legal entity name.
    - `privacyPolicyUrl` string: URL to the privacy policy for the campaign.
    - `termsAndConditionsUrl` string: URL to the terms and conditions for the campaign.
    - `businessRegistrationDetails` BusinessRegistrationDetails: Business registration details for Toll-Free Verification compliance.
      - `businessRegistrationNumber` string: Business registration number (e.g. EIN, VAT number). Max 500 chars.
      - `businessEntityType` 'SOLE_PROPRIETOR' | 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'GOVERNMENT': Type of business entity.
      - `businessRegistrationType` 'EIN' | 'CBN' | 'NEQ' | 'PROVINCIAL_NUMBER' | 'CRN' | 'VAT' | 'ACN' | 'ABN' | 'BRN' | 'SIREN' | 'SIRET' | 'NZBN' | 'UST_IDNR' | 'CIF' | 'NIF' | 'CNPJ' | 'UID' | 'OTHER': Type of business registration.
      - `businessRegistrationCountry` string: Country where the business is registered. ISO 3166-1 Alpha-2 format.
  - `nextLink` string: Represents the URL link to the next page.

## Other responses

- `default`: Failure

---

[API](https://skmtc.dev/azure/apis/toll-free-verification-service.md) - [All operations](https://skmtc.dev/azure/apis/toll-free-verification-service/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/toll-free-verification-service/revisions/ee51ef50444b?raw)
