---
title: "Get Contact Capabilities"
method: GET
path: "/v1/contacts/capabilities"
tags: ["contacts"]
---

# Get Contact Capabilities

`GET /v1/contacts/capabilities`

Check which messaging channels a phone number supports, without sending
a message.

Runs a live check (typically 1-2 seconds), so the result reflects the
number right now. Capabilities can still change by the time you send.
Requires at least one active iMessage-capable or RCS number on the
account; each flag is null when your account holds no line that could
act on it (rcs reachability is checked against YOUR agents, so it can
differ per account while an agent is pre-launch).

## Query parameters

- `phone_number` string, required — Phone number to check (E.164 preferred; URL-encode + as %2B)

## Response `200`

Successful Response

- ContactCapabilitiesResponse
  - `phoneNumber` string, required
  - `capabilities` ContactCapabilityFlags, required
    - `imessage` boolean, nullable
    - `sms` boolean, nullable
    - `rcs` boolean, nullable
  - `checkedAt` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/agentphone/apis/agentphone-api.md) · [All operations](https://skmtc.dev/agentphone/apis/agentphone-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentphone/agentphone-api/revisions/6efa707e8ebd/schema)