---
title: "POST /v1/{sid}/consent/validate"
method: POST
path: "/v1/{sid}/consent/validate"
tags: ["2. Consent Validate"]
---

# POST /v1/{sid}/consent/validate

`POST /v1/{sid}/consent/validate`

## Request

- Base URL: `api.in.kaleyra.io` (relative, and the document’s source URL is not known)
- URL: `api.in.kaleyra.io/v1/{sid}/consent/validate`
- Auth: API key in header `api-key`

The Kaleyra platform enables you to retrieve consent status for the channel based on mobile numbers and specific filters included in the request in real-time.

The statuses that can be returned in the response are as follows:
| Returned Status    | Description |
| -------- | --------------------- |
| `-1`     | Number Not Found in the database.    |
| `0`      | Opt-out.              |
| `1`      | Opt-in.               |
| `2`      | Deactivated.          |

## Path parameters

- `sid` string, required

## Headers

- `api-key` string, required

## Request body

- object
  - `channel` string, required: Channel name for which you want to get the consent updates.Example - sms.
  - `sender_identifier` string, required: Inbound Sender ID. Inbound Sender ID. In case of SMS, it’s the customer short code.
  - `contact_identifiers` string[], required: Contact identifier of end-user or end-users mobile number.
  - `consent_category` string: Consent category. Example - Marketing, Transactional, or Promotional. Optional, defaults is for 'all' when no value is passed.
  - `consent_topic` string: Consent topic. Example - Offers, Loan, or Insurance. Optional, defaults is for 'all' when no value is passed.

## Response `200`

OK

- object

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/kaleyra/apis/consent-apis.md) - [All operations](https://skmtc.dev/kaleyra/apis/consent-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/kaleyra/apis/consent-apis/revisions/95f4a7eb5aae?raw)