v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
Campaign

Get campaign

Retrieve campaign details by campaignId.

get/10dlc/campaign/{campaignId}

Path parameters

campaignIdstring required

Unique identifier of the campaign.

Response

Successful Response

ageGatedboolean

Age gated content in campaign.

autoRenewalboolean

Campaign subscription auto-renewal status.

billedDatestring

Campaign recent billed date.

brandDisplayNamestring

Display or marketing name of the brand.

brandIdstring required

Unique identifier assigned to the brand.

campaignIdstring required

Unique identifier for a campaign.

campaignStatus'TCR_PENDING' | 'TCR_SUSPENDED' | 'TCR_EXPIRED' | 'TCR_ACCEPTED' | 'TCR_FAILED' | 'TELNYX_ACCEPTED' | 'TELNYX_FAILED' | 'MNO_PENDING' | 'MNO_ACCEPTED' | 'MNO_REJECTED' | 'MNO_PROVISIONED' | 'MNO_PROVISIONING_FAILED'

Campaign status

createDatestring

Unix timestamp when campaign was created.

cspIdstring required

Alphanumeric identifier of the CSP associated with this campaign.

descriptionstring required

Summary description of this campaign.

directLendingboolean
embeddedLinkboolean

Does message generated by the campaign include URL link in SMS?

embeddedLinkSamplestring

Sample of an embedded link that will be sent to subscribers.

embeddedPhoneboolean

Does message generated by the campaign include phone number in SMS?

failureReasonsstring

Failure reasons if campaign submission failed

helpKeywordsstring

Subscriber help keywords. Multiple keywords are comma separated without space.

helpMessagestring

Help message of the campaign.

isTMobileNumberPoolingEnabledboolean

Indicates whether the campaign has a T-Mobile number pool ID associated with it.

isTMobileRegisteredboolean

Indicates whether the campaign is registered with T-Mobile.

isTMobileSuspendedboolean

Indicates whether the campaign is suspended with T-Mobile.

messageFlowstring

Message flow description.

mockboolean required

Campaign created from mock brand. Mocked campaign cannot be shared with an upstream CNP.

nextRenewalOrExpirationDatestring

When the campaign would be due for its next renew/bill date.

numberPoolboolean

Does campaign utilize pool of phone numbers?

optinKeywordsstring

Subscriber opt-in keywords. Multiple keywords are comma separated without space.

optinMessagestring

Subscriber opt-in message.

optoutKeywordsstring

Subscriber opt-out keywords. Multiple keywords are comma separated without space.

optoutMessagestring

Subscriber opt-out message.

privacyPolicyLinkstring

Link to the campaign's privacy policy.

referenceIdstring

Caller supplied campaign reference ID. If supplied, the value must be unique across all submitted campaigns. Can be used to prevent duplicate campaign registrations.

resellerIdstring

Alphanumeric identifier of the reseller that you want to associate with this campaign.

sample1string

Message sample. Some campaign tiers require 1 or more message samples.

sample2string

Message sample. Some campaign tiers require 2 or more message samples.

sample3string

Message sample. Some campaign tiers require 3 or more message samples.

sample4string

Message sample. Some campaign tiers require 4 or more message samples.

sample5string

Message sample. Some campaign tiers require 5 or more message samples.

statusstring

Current campaign status. Possible values: ACTIVE, EXPIRED. A newly created campaign defaults to ACTIVE status.

subUsecasesstring[] required

Campaign sub-usecases. Must be of defined valid sub-usecase types. Use /10dlc/enum/usecase operation to retrieve list of valid sub-usecases

submissionStatus'CREATED' | 'FAILED' | 'PENDING'

Campaign submission status

subscriberHelpboolean

Does campaign responds to help keyword(s)?

subscriberOptinboolean

Does campaign require subscriber to opt-in before SMS is sent to subscriber?

subscriberOptoutboolean

Does campaign support subscriber opt-out keyword(s)?

tcrBrandIdstring

Unique identifier assigned to the brand by the registry.

tcrCampaignIdstring

Unique identifier assigned to the campaign by the registry.

termsAndConditionsboolean required

Is terms & conditions accepted?

termsAndConditionsLinkstring

Link to the campaign's terms and conditions.

usecasestring required

Campaign usecase. Must be of defined valid types. Use /10dlc/enum/usecase operation to retrieve usecases available for given brand.

verticalstring

Business/industry segment of this campaign (Deprecated). Must be of defined valid types. Use /registry/enum/vertical operation to retrieve verticals available for given brand, vertical combination.

This field is deprecated.

webhookFailoverURLstring

Failover webhook to which campaign status updates are sent.

webhookURLstring

Webhook to which campaign status updates are sent.

Example response

{
  "brandDisplayName": "ABC Mobile",
  "brandId": "d2ca9d69-641b-4131-83fa-5d0744f4c8a9",
  "campaignId": "823d6b1a-6ed6-41a3-9c50-c8ff41b682ba",
  "campaignStatus": "TCR_ACCEPTED",
  "tcrBrandId": "BBRAND1",
  "tcrCampaignId": "CCAMP1",
  "webhookFailoverURL": "https://example.com/failover-webhook",
  "webhookURL": "https://example.com/webhook"
}