Skip to main content
GET
/
v1
/
10dlc
/
campaigns
List 10DLC Campaigns
curl --request GET \
  --url https://api.example.com/v1/10dlc/campaigns \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "campaigns": [
    {
      "id": "<string>",
      "campaign_id": "<string>",
      "campaign_uuid": "<string>",
      "brand_id": "<string>",
      "use_case": "<string>",
      "description": "<string>",
      "status": "<string>",
      "organization_id": "<string>",
      "tenant_id": "<string>",
      "created_at": {}
    }
  ],
  "count": 123
}
Retrieve all 10DLC campaigns registered for your tenant, optionally filtered by organization.

​
Authentication

​
X-API-Key
string
required
Your API key

​
Query Parameters

​
tenant_id
string
Your tenant identifier. Must match the tenant associated with your API key. If provided with a mismatched value, the request will be rejected with a 403 error.
​
organization_id
string
Filter campaigns by organization unique_id (optional)

​
Response

​
success
boolean
Whether the request was successful
​
campaigns
array
Array of campaign objects
​
count
integer
Total number of campaigns

​
Example Request

curl -X GET "https://api.teli.ai/v1/10dlc/campaigns?tenant_id=telitest" \
  -H "X-API-Key: YOUR_API_KEY"

​
Filter by Organization

curl -X GET "https://api.teli.ai/v1/10dlc/campaigns?tenant_id=telitest&organization_id=org_abc123" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

200
{
  "success": true,
  "campaigns": [
    {
      "id": "d1e2f3a4-b5c6-7890-abcd-ef1234567890",
      "campaign_id": "C9ABCDE",
      "campaign_uuid": "uuid-1234-5678-9012",
      "brand_id": "B4KRR4F",
      "use_case": "MIXED",
      "description": "Customer outreach and appointment scheduling",
      "status": "ACTIVE",
      "organization_id": "org_abc123",
      "tenant_id": "telitest",
      "created_at": "2026-01-20T14:00:00Z"
    }
  ],
  "count": 1,
  "powered_by": "Teli"
}

​
Campaign Status Values

StatusDescription
ACTIVECampaign is approved by carriers - can send SMS
PENDINGCampaign submitted, awaiting carrier approval (1-2 business days)
EXPIREDCampaign has been deactivated