Check RCS capability Early access

Use this endpoint to verify whether the phone numbers in a given list can receive RCS messages from the specified sender. You can check up to 500 phone numbers in a single request. The response will provide the list of capability statuses for each phone number individually.

Ensure the sender is configured and launched on the mobile network/carrier that manages the phone numbers being tested for RCS capability. If the sender is not launched on the network, the capability check request will always return a negative status for the tested phone numbers.

Please log in to see full path URL. Learn why.

post

/rcs/2/capability-check/query

Authorizations:

Scopes:

rcs:manage

Request Body schema:

collapse all -

sender

required

string

The sender ID. It can be alphanumeric or numeric (for example, CompanyName). Make sure the sender ID does not exceed the character limit.

phoneNumbers

required

Array of strings [ 1 .. 500 ] items

A list of phone numbers (1 to 500) to check for RCS capability (for example, ["441134960001", "441134960002"]).

options

object

platform

object

Platform options. For more details, see documentation.

entityId	string [ 0 .. 255 ] characters Used when specifying an entity in outbound send requests. It is also returned in notification events. For detailed usage, refer to the documentation.
applicationId	string [ 0 .. 255 ] characters Used when specifying an application in outbound send requests. It is also returned in notification events. For detailed usage, refer to the documentation.

Responses

200

400

Bad Request

401

Unauthorized

403

Forbidden

429

Too Many Requests

500

Internal Server Error

Request samples

Content type

Copy

Collapse all


{"sender": "441134960000",
"phoneNumbers": 
["441134960001",
"441134960002"
],
"options": 
{"platform": 
{"entityId": "Example entity id",
"applicationId": "Example application id"
}
}
}

Response samples

Content type

Copy

Collapse all


{"capabilityCheckResults": 
[
{"messageId": "d5c3bdff-2d44-4f74-8a8e-3792fa57dfc8",
"phoneNumber": "441134960001",
"code": "ENABLED"
},
{"messageId": "b5c3bdff-2d44-4f74-8a8e-3792fa57dfc3",
"phoneNumber": "441134960002",
"code": "UNREACHABLE"
}
],
"options": 
{"platform": 
{"entityId": "Example entity id",
"applicationId": "Example application id"
}
}
}

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products

Learn more

Service status

Privacy documents Terms of use