Get your channels

Every market you send SMS in, your WhatsApp account and your RCS agent — with each one's status, and what each market has supplied.

Status lives on the channel, never on you or your brand. An identity has no lifecycle; what has one is the registration of a sender in a market and the approval of a channel. So a customer live in one country and mid-registration in another reports exactly that, rather than one flattened answer.

sms[n].compliance carries what each market holds: brand and campaign for markets that register with a compliance regime such as US TEN_DLC, and documents for markets that pre-register an alphanumeric or similar sender. Absent means the market registers with nobody and nothing has been supplied. GET /v3/compliance/requirements says what a market demands of any new customer; this says what you gave it.

Send x-profile-id with an organization key to read one of your profiles' channels.

GET
/v3/channels

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v3/channels"
{
  "success": true,
  "data": {
    "customer_id": "550e8400-e29b-41d4-a716-446655440000",
    "sms": [
      {
        "country": "US",
        "number_type": "TEN_DLC",
        "sender_value": "+12125550100",
        "status": "ACTIVE",
        "note": "This market's sender is live and can carry traffic.",
        "compliance": {
          "brand": {
            "inherit": false,
            "legal_name": "Example Retail Inc",
            "entity_type": "PRIVATE_PROFIT",
            "country": "US"
          },
          "campaign": {
            "inherit": false,
            "description": "Order and delivery updates for customers who opted in at checkout."
          },
          "documents": []
        }
      },
      {
        "country": "GB",
        "number_type": "ALPHANUMERIC",
        "sender_value": "ExmplRetail",
        "status": "ACTIVE",
        "note": "This market's sender is live and can carry traffic.",
        "compliance": {
          "documents": [
            {
              "key": "senderid_registration_requirements",
              "file_name": "sender-id-registration.pdf",
              "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6"
            }
          ]
        }
      }
    ],
    "whatsapp": null,
    "rcs": {
      "id": "c87b77eb-d936-497f-b662-a865a35d802c",
      "status": "PROVISIONING",
      "display_name": "Example Retail",
      "description": "Order and delivery notifications for Example Retail customers.",
      "agent_use_case": "NOTIFICATIONS",
      "brand_name": "Example Retail",
      "privacy_policy_url": "https://example.com/privacy",
      "terms_and_conditions_url": "https://example.com/terms",
      "website_url": "https://example.com",
      "brand_color": "#1a73e8",
      "brand_phone_number": "+12125550100",
      "customer_support_phone_number": "+18005550100",
      "brand_email": "hello@example.com",
      "customer_support_email": "support@example.com",
      "contact_name_and_title": "Jane Smith, Head of Marketing",
      "company_ein": "12-3456789",
      "entity_type": "PRIVATE_PROFIT",
      "official_address": {
        "street": "123 Main St",
        "city": "New York",
        "state": "NY",
        "postal_code": "10001",
        "country": "US"
      },
      "brief_company_description": "Example Retail sells home goods across the US and ships to 48 states.",
      "opt_in_process_description": "Customers opt in at checkout by checking the SMS/RCS notifications box.",
      "start_message": "Welcome to Example Retail! Reply HELP for help or STOP to opt out.",
      "help_message": "For help, visit https://example.com/support or call 1-800-555-0100.",
      "stop_message": "You have been unsubscribed from Example Retail notifications.",
      "sample_messages": [
        "Your order #12345 has shipped and will arrive tomorrow."
      ],
      "created_at": "2025-06-01T12:00:00+00:00"
    },
    "mms": []
  },
  "meta": {
    "request_id": "req_4A2cNm8pRt",
    "timestamp": "2025-06-01T12:00:00+00:00",
    "version": "v3"
  }
}
Empty
Empty
{
  "success": false,
  "data": null,
  "error": {
    "code": "RESOURCE_004",
    "message": "The customer could not be read",
    "details": null,
    "doc_url": "https://docs.sent.dm/reference/api/error-catalog"
  },
  "meta": {
    "request_id": "req_4A2cNm8pRt",
    "timestamp": "2025-06-01T12:00:00+00:00",
    "version": "v3"
  }
}
{
  "success": true,
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": [
        "string"
      ],
      "property2": [
        "string"
      ]
    },
    "doc_url": "string"
  },
  "meta": {
    "request_id": "string",
    "timestamp": "2019-08-24T14:15:22Z",
    "version": "string"
  }
}

Delete a sender profile DELETE

Deletes one of your sender profiles and returns `204`. The delete is **soft**: the profile stops being usable and stops appearing in reads, and its message history is kept, because deleting a profile must not delete the record of what it sent. ## What it releases Anything the profile still held goes with it. A **phone number** returns to our inventory and can be given to whoever asks next — it does not stay reserved for you, and getting the same number back afterwards is not something we can promise. A **WhatsApp account of its own** is deregistered from Meta. Its routing rules stop being used, so nothing sends through the profile after this call. A profile that only inherits from its organization holds nothing of its own and releases nothing.

List your SMS markets GET

Every market you send SMS in, each with its sender, where that sender stands, and what its compliance holds. The same entries `GET /v3/channels` reports under `sms`, and the same shape `GET /v3/channels/sms/{country}/{type}` returns for one of them — so a list, a member read and the all-channels read cannot describe a market differently. Send `x-profile-id` with an organization key to list one of your profiles' markets.