Before sending an RCS message, it's critical to check if the recipient's device and carrier support the technology. This check ensures that your rich messages can actually be displayed correctly by the end-user.
By calling this endpoint, you will get a response indicating whether the number is ”RCS-capable” as well as which specific features, such as carousels or location sharing, are supported.
Quickstart #
Quick start (cURL)
Copy to clipboard
curl -X GET https://api.ip1.net/phones/46700123456/capabilities \
-H "Authorization: Bearer YOUR_TOKEN"Call #
Endpoint: /phones/{msisdn}/capabilities
Methodology: GET
Example calls #
Call (URL)
Copy to clipboard
https://api.ip1.net/phones/46700123456/capabilitiesFields for call data #
| Field name | Description of the project | Required | Type | Example |
| MSISDN | The mobile number of the recipient's device in MSISDN format | Yes | string | "46700123456" |
Responsibility #
Example response #
Response data
Copy to clipboard
{
"msisdn": "46700123456",
"capable": true,
"features": [
"CHAT_SESSION",
"FILE_TRANSFER",
"CAROUSEL"
]
}Fields for response data #
| Field name | Description of the project | Type | Example |
| MSISDN | The phone number that has been verified. | string | "46700123456" |
| capable | Check if the recipient supports RCS (true/false). | Boolean | true |
| characteristics | List of specific features supported. | Array | [ ”CHAT_SESSION, ”FILE_TRANSFER, ”Carousel” ] |