List campaigns
Returns every 10DLC and toll-free campaign on your account as a bare JSON array, newest first. The list is not paginated and reads the records stored on your account without contacting the registry.
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/10dlc/campaigns \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.campaigns.list_campaigns()
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/10dlc/campaigns', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"id": "9c1b3e5f-7a2d-4b8c-a0e1-2f3d4c5b6a72",
"accountId": "MA_XXXXXXXX",
"name": "Example Corp toll-free notifications",
"campaignType": "TOLL_FREE_UNIFIED_NUMBER",
"stage": "IN_REVIEW",
"programSummary": "Example Corp sends account and support notifications to customers who opted in on the contact form.",
"customerCarePhone": "+14155550100",
"customerCareEmail": "support@example.com",
"exampleMessages": [
"Example Corp: Your account balance is low. Add funds at https://example.com/wallet. Reply STOP to opt out, HELP for help."
],
"termsAndConditionsUrl": "https://example.com/terms",
"privacyPolicyUrl": "https://example.com/privacy",
"useCases": [
"NOTIFICATIONS"
],
"optIns": {
"web": {
"url": "https://example.com/contact",
"callToAction": "By checking this box you agree to receive account notifications from Example Corp. Reply STOP to opt out, HELP for help."
}
},
"lowVolume": false,
"ageGated": false,
"directLending": false,
"embeddedLink": false,
"embeddedPhone": false,
"numbers": [
"+18335550100"
],
"lastSyncedAt": "2026-10-17T08:46:46Z",
"createdAt": "2026-10-08T04:36:40Z",
"updatedAt": "2026-10-15T19:19:02Z"
},
{
"id": "8a7d2f10-3c4b-4e9a-b1d2-6e5f4a3b2c11",
"accountId": "MA_XXXXXXXX",
"brandId": "5f1c3a2e-7b4d-4e8f-9a0b-1c2d3e4f5a60",
"name": "Example Corp account alerts",
"campaignType": "TEN_DIGIT_LONG_CODE",
"stage": "REGISTERED",
"useCases": [
"ALERTS"
],
"messageTypes": [
"SMS"
],
"lowVolume": true,
"ageGated": false,
"directLending": false,
"embeddedLink": true,
"embeddedPhone": false,
"numbers": [
"14155550100"
],
"lastSyncedAt": "2026-10-17T08:46:48Z",
"createdAt": "2026-10-06T14:28:25Z",
"updatedAt": "2026-10-14T17:19:03Z"
}
]{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}Authorizations
Your Vobiz account Auth ID (MA_XXXXXXXX).
Your Vobiz account Auth Token.
Response
All campaigns on your account.
Campaign ID (UUID) on your account. Use it in every /10dlc/campaigns/{id} path.
"8a7d2f10-3c4b-4e9a-b1d2-6e5f4a3b2c11"
Your Vobiz account ID (MA_...). Always the account whose credentials made the request.
"MA_XXXXXXXX"
ID of the brand the campaign runs under. Omitted for toll-free campaigns, which carry their business details themselves.
"5f1c3a2e-7b4d-4e8f-9a0b-1c2d3e4f5a60"
Name you gave the campaign, for your reference.
"Example Corp account alerts"
Kind of campaign. TEN_DIGIT_LONG_CODE is a standard 10DLC campaign (the default on create) and TOLL_FREE_UNIFIED_NUMBER is a toll-free verification created with POST /10dlc/campaigns/toll-free. The other values are registry campaign types you can request on create.
TEN_DIGIT_LONG_CODE, TOLL_FREE_UNIFIED_NUMBER, TOLL_FREE_NUMBER, SHORT_CODE, EXTERNAL_TEN_DIGIT_LONG_CODE, DCA2_TEN_DIGIT_LONG_CODE, TOLL_FREE_EXTERNALLY_VERIFIED, RCS_SENDER_LAUNCH Registry lifecycle stage. A new campaign is DRAFT; after you register it, it moves through review stages such as SUBMITTED, IN_REVIEW or APPEALED and settles at REGISTERED or REJECTED. Other values include REGISTERED_PENDING_UPDATE, REGISTERED_PENDING_DEREGISTRATION, REJECTED_EXTERNALLY, DEREGISTERED, ARCHIVED, BLOCKED, SUSPENDED and DELETED; treat it as an open string.
"REGISTERED"
Description of the program as submitted to the registry. Omitted when not set.
Opt-in confirmation message as submitted. Omitted when not set.
HELP reply as submitted. Omitted when not set.
STOP reply as submitted. Omitted when not set.
Customer care phone number, in E.164 format. Omitted when not set.
"+14155550100"
Customer care email address. Omitted when not set.
"support@example.com"
Sample messages as submitted. Omitted when not set.
Public URL of your terms and conditions. Omitted when not set.
Public URL of your privacy policy. Omitted when not set.
Use-case codes as submitted, for example ALERTS or, on a toll-free campaign, NOTIFICATIONS. Omitted when not set.
["ALERTS"]
Message types as submitted, for example SMS. Omitted when not set.
["SMS"]
Opt-in details as submitted, keyed by channel (for example web). Omitted when not set.
Whether the campaign is declared low volume. Always present; false unless you set it.
Whether the content is restricted to adults. Always present; false unless you set it.
Whether the content relates to direct lending. Always present; false unless you set it.
Whether messages contain URLs. Always present; false unless you set it.
Whether messages contain phone numbers. Always present; false unless you set it.
Numbers recorded on the campaign on your account. 10DLC campaigns store digits with country code (for example 14155550100); toll-free campaigns store E.164 with a leading +. For the registry's own list use GET /10dlc/campaigns/{id}/numbers.
["14155550100"]
The registry's review feedback after a rejection, with keys such as rejectionDate, rejectionReasons and rejectionDetails (each detail has errorCode, description, recommendedAction and rejectionCategory). Omitted when the campaign has no feedback; address every point before you appeal.
When Vobiz last refreshed this record from the US 10DLC registry, in ISO 8601 (RFC 3339) UTC. Omitted until the first refresh.
"2026-10-14T17:19:03Z"
When the record was created on your account, in ISO 8601 (RFC 3339) UTC.
"2026-10-06T14:28:25Z"
When the record last changed on your account, in ISO 8601 (RFC 3339) UTC.
"2026-10-14T17:19:03Z"
Was this page helpful?
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/10dlc/campaigns \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.campaigns.list_campaigns()
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/10dlc/campaigns', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"id": "9c1b3e5f-7a2d-4b8c-a0e1-2f3d4c5b6a72",
"accountId": "MA_XXXXXXXX",
"name": "Example Corp toll-free notifications",
"campaignType": "TOLL_FREE_UNIFIED_NUMBER",
"stage": "IN_REVIEW",
"programSummary": "Example Corp sends account and support notifications to customers who opted in on the contact form.",
"customerCarePhone": "+14155550100",
"customerCareEmail": "support@example.com",
"exampleMessages": [
"Example Corp: Your account balance is low. Add funds at https://example.com/wallet. Reply STOP to opt out, HELP for help."
],
"termsAndConditionsUrl": "https://example.com/terms",
"privacyPolicyUrl": "https://example.com/privacy",
"useCases": [
"NOTIFICATIONS"
],
"optIns": {
"web": {
"url": "https://example.com/contact",
"callToAction": "By checking this box you agree to receive account notifications from Example Corp. Reply STOP to opt out, HELP for help."
}
},
"lowVolume": false,
"ageGated": false,
"directLending": false,
"embeddedLink": false,
"embeddedPhone": false,
"numbers": [
"+18335550100"
],
"lastSyncedAt": "2026-10-17T08:46:46Z",
"createdAt": "2026-10-08T04:36:40Z",
"updatedAt": "2026-10-15T19:19:02Z"
},
{
"id": "8a7d2f10-3c4b-4e9a-b1d2-6e5f4a3b2c11",
"accountId": "MA_XXXXXXXX",
"brandId": "5f1c3a2e-7b4d-4e8f-9a0b-1c2d3e4f5a60",
"name": "Example Corp account alerts",
"campaignType": "TEN_DIGIT_LONG_CODE",
"stage": "REGISTERED",
"useCases": [
"ALERTS"
],
"messageTypes": [
"SMS"
],
"lowVolume": true,
"ageGated": false,
"directLending": false,
"embeddedLink": true,
"embeddedPhone": false,
"numbers": [
"14155550100"
],
"lastSyncedAt": "2026-10-17T08:46:48Z",
"createdAt": "2026-10-06T14:28:25Z",
"updatedAt": "2026-10-14T17:19:03Z"
}
]{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}