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

# Get RCS Capabilities

`POST /rcs/capabilities`

## Request

- Base URL: `https://api.pinnacle.sh`
- URL: `https://api.pinnacle.sh/rcs/capabilities`
- Auth: API key in header `PINNACLE-API-KEY`

Check RCS capabilities for one or more phone numbers.

This endpoint allows you to verify which RCS features (cards, buttons, etc.) are supported
on specific phone numbers before sending RCS messages to them.

## Request body

- RcsCapabilitiesRequest: Request body for checking RCS capabilities of phone numbers
  - `phoneNumbers` string[], required: List of phone numbers to check RCS capabilities for (E.164 format). <br><br> **Limit:** 1 min
  - `agentId` string: Optional RCS agent ID (prefixed with 'agent_') to check capabilities of a number from a specific agent.

## Response `200`

Returns RCS capabilities for each requested phone number.

The response is a map where keys are phone numbers and values are either:
- `null` if the number doesn't support RCS
- An object containing supported cards and actions if RCS is supported

- RcsCapabilitiesResponse: Response containing RCS capabilities for requested phone numbers

## Other responses

- `400`: Validation failed. The payload has missing required fields and/or invalid types. <br> See https://zod.dev/error-formatting for more information.
- `401`: The request lacks valid authentication credentials or the provided credentials are invalid. <br> Ensure you're including a valid API key in the request headers and that your account has the necessary permissions to access this endpoint.
- `403`: Your subscription does not include access to this feature. <br> This occurs when attempting to use functionality that requires a higher subscription tier. Please upgrade your subscription to access this feature.
- `500`: An unexpected error occurred on Pinnacle's servers while processing your request. <br> If this error persists, please contact support with the request details.
- `501`: The requested functionality is not implemented on the server. <br> This typically indicates that the feature or endpoint you attempted to access is unavailable or not yet supported.

---

[API](https://skmtc.dev/pinnacle/apis/pinnacle-2.md) - [All operations](https://skmtc.dev/pinnacle/apis/pinnacle-2/llms.txt) - [OpenAPI document](https://skmtc.dev/pinnacle/apis/pinnacle-2/revisions/45416dadab79?raw)