Check if the recipient's device supports RCS

Before sending an RCS message, check whether the recipient’s device and carrier support RCS. This ensures rich messages can be displayed correctly to the end user.

This endpoint reports whether the number is RCS capable and which features, such as carousels or location sharing, are supported.

Note: Capability checks are currently limited to the Telia, Telenor, and Tele2 networks.

Quickstart

curl -X GET https://api.ip1.net/v3/phones/46700123456/capabilities \
  -H "Authorization: Bearer YOUR_TOKEN"

Request

Endpoint: /phones/{msisdn}/capabilities

Method: GET

Request example

https://api.ip1.net/v3/phones/46700123456/capabilities

Request fields

Field name	Description	Required	Type	Example
msisdn	Recipient device mobile number in MSISDN format.	Yes	String	`"46700123456"`

Response

Response example

{
  "msisdn": "46700123456",
  "capable": true,
  "features": [
    "CHAT_SESSION",
    "FILE_TRANSFER",
    "CAROUSEL"
  ]
}

Response fields

Field name	Description	Type	Example
msisdn	The phone number that was checked.	String	`"46700123456"`
capable	Indicates whether the recipient supports RCS (true/false).	Boolean	true
features	List of supported features.	Array	[ ”CHAT_SESSION”, ”FILE_TRANSFER”, ”CAROUSEL” ]