---
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`

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.net/kaleyra/apis/kaleyra-io-sms-apis.md) · [All operations](https://skmtc.net/kaleyra/apis/kaleyra-io-sms-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kaleyra/kaleyra-io-sms-apis/versions/d9b785884d03/schema)