2. 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.

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

Path parameters

sidstring required

Account SID (Security Identifier). For more information, see View API Key and SID.

Headers

api-keystring required

API key generated from Kaleyra platform account. For more information, see View API Key and SID.

Request body

channelstring required

Channel name for which you want to get the consent updates.Example - sms.

sender_identifierstring required

Inbound Sender ID. Inbound Sender ID. In case of SMS, it’s the customer short code.

contact_identifiersstring[] required

Contact identifier of end-user or end-users mobile number.

consent_categorystring

Consent category. Example - Marketing, Transactional, or Promotional. Optional, defaults is for 'all' when no value is passed.

consent_topicstring

Consent topic. Example - Offers, Loan, or Insurance. Optional, defaults is for 'all' when no value is passed.

Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.