---
title: "Can this brand message this number?"
method: GET
path: "/v1/brands/{id}/optins/{e164}"
tags: ["Consent"]
---

# Can this brand message this number?

`GET /v1/brands/{id}/optins/{e164}`

## Request

- Base URL: `https://api.cadencercs.com`
- URL: `https://api.cadencercs.com/v1/brands/{id}/optins/{e164}`
- Auth: HTTP bearer

Without this the only way to learn someone opted out is to attempt a send and read the 409 — which means finding out at the moment you were going to message them.

## Path parameters

- `id` string, required
- `e164` string, required

## Response `200`

Consent status.

- object
  - `e164` string, required
  - `status` 'opted_in' | 'opted_out' | 'no_record', required
  - `sendable` boolean, required: Whether a send would be accepted right now.
  - `method` string: How consent was captured.
  - `evidenceRef` string, nullable
  - `capturedAt` string, nullable
  - `optedOutAt` string, nullable
  - `reconsents` number: How many times this opt-out has already been reversed.
  - `remediation` string
  - `message` string

## Other responses

- `400`: `e164` must be E.164.
- `401`: Not signed in, and no account-linked API key was sent.
- `404`: No such brand on this account.
- `500`: Unexpected server error. The body is always JSON.

---

[API](https://skmtc.dev/cadencercs/apis/cadence-api.md) · [All operations](https://skmtc.dev/cadencercs/apis/cadence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cadencercs/apis/cadence-api/revisions/9438443c2081?raw)
