Skip to main content
POST
Checks the specified RCS sending list’s current reachability for one US number. The API key needs the lists.read scope, and the list must be active, belong to the key’s account, and have an enabled RCS agent. Both live and sandbox keys make a real reachability lookup. The limit is 60 checks per account per minute. A 429 response includes Retry-After in seconds. The result is a point-in-time check for this list’s RCS agent. reachable: false does not distinguish an unsupported or disabled handset from an agent that has not launched on the recipient’s network. A successful lookup does not check consent, list membership, or suppression and does not guarantee delivery. This request sends no message. Normal sends do not run this lookup automatically.

Path Parameters

integer
required
ID of an active RCS sending list owned by your account.

Body Parameters

string
required
US recipient phone number in E.164 format, such as +13105551234.

Response Fields

boolean
Whether the list’s RCS agent can currently reach this number. A number that the agent cannot reach returns false with HTTP 200.

Examples

Error Codes