v1

latestOpenAPI 3.0.02026-07-244771176.5 KB

RCS

Check RCS capability for phone numbers

Synchronously checks whether a list of phone numbers can receive RCS from your sender.

Use this before sending to decide between RCS and SMS fallback. Designed for routing-time lookups: small batches (1–10 numbers recommended for best latency), immediate response.

Results are best-effort and reflect capability at the moment of the lookup. Do not use this as a hard gate on sending — treat UNKNOWN as reachable and rely on SMS fallback for hard delivery guarantees.

post/v2/rcs/capabilities

Request body

senderstring required

The RCS sender assigned to your account.

Example: DemoSender

phone_numbersstring[] required

Phone numbers to check, in E.164 format without the leading +.

For best latency we recommend batches of 1–10. The endpoint accepts up to 100 numbers per request.

Example request

{
  "sender": "DemoSender",
  "phone_numbers": [
    "61400000000",
    "61400000001"
  ]
}

Response

requestobject

Optional metadata (e.g. requestId, traceId)

metaobject

Optional pagination, feature flags, etc.

Example response

{
  "data": {
    "results": [
      {
        "phone_number": "61400000000",
        "code": "ENABLED"
      }
    ]
  }
}