---
title: "Get RCS capabilities"
method: POST
path: "/v4/rcs/capabilities"
tags: ["RCS - Capabilities"]
---

# Get RCS capabilities

`POST /v4/rcs/capabilities`

## Request

- Base URL: `https://api.inmobile.com`
- URL: `https://api.inmobile.com/v4/rcs/capabilities`
- Auth: one of:
  - HTTP basic
  - API key in query parameter `apikey`

Get RCS capabilities for the provided MSISDNs for a specific agent.</br>
This endpoint relies on Google for up-to-date capability information, so response times can be slower than on other endpoints.</br>
One or more MSISDNs can return a transient error.</br>
When that happens, <c>rcsSupport.value</c> is <c>3 = TransientError</c>.</br>
We recommend waiting a few minutes before retrying the affected entries.</br>
If <c>rcsSupport.value</c> is <c>2 = SupportsRcs</c> and <c>featuresSupported</c> is empty, Google did not report any explicit supported features for that MSISDN, and only text-based RCS messages are supported.

## Request body

- RcsCapabilitiesPostRequest
  - `agentId` string, guid, required: Public RCS agent identifier used for the capability lookup.
  - `msisdns` RcsCapabilitiesMsisdnInputModel[], required: Msisdn entries to validate and query for capabilities.
    - `msisdn` string, required: The msisdn (country code and number) to send to. (Remember to include countrycode in all numbers, e.g. 4512345678).</br> If max length is exceeded, the entire api call will fail.
    - `countryHint` string: For optimal phone number validation, we encourage you to provide us with a country code.</br> This can be the numeric country code (like 44) or the two-letter ISO 3166-1 alpha-2 code (like GB).</br> If this field is empty it is important that you add the country code (e.g 44) in front of the phone number in “to”.

## Response `200`

- RcsCapabilitiesPostReply
  - `result` RcsCapabilitiesResultModel[]: Capability results for each requested msisdn in request order.
    - `msisdn` NumberDetails
      - `countryCode` string: The country code part of the msisdn, e.g. 45.
      - `phoneNumber` string: The phone number part of the msisdn, e.g. 12345678.
      - `rawMsisdn` string: The input msisdn in its unaltered format. This is the value provided when sending the text message.
      - `msisdn` string: The final cleaned msisdn.
      - `isValidMsisdn` boolean: True if the input msisdn was valid.
      - `countryHint` string: The country code hint if provided in the request.
    - `rcsSupport` RcsSupportModel
      - `value` integer: A code describing whether the msisdn supports RCS. Transient error is returned when the Google capability lookup fails transiently. 1 = Does not support RCS 2 = Supports RCS 3 = Transient error
      - `description` string: A text description of the status.
    - `featuresSupported` RcsCapabilitiesFeatureModel[]: RCS features supported by the msisdn.
      - `value` integer: A code describing an RCS feature supported by the msisdn. 1 = Single Rich Card 2 = Carousel 3 = Action Create Calendar Event 4 = Action Dial 5 = Action Open URL 6 = Action Share Location 7 = Action View Location 8 = Action Open URL In Web View
      - `description` string: A text description of the feature.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/inmobile/apis/inmobile-rest-api.md) · [All operations](https://skmtc.dev/inmobile/apis/inmobile-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inmobile/apis/inmobile-rest-api/revisions/197a90ad5f8f?raw)