POSThttps://api.veriko.mx/v1/validations/{id}/cep/send-telegram

Send the CEP to Telegram

Audience: public
Auth: API key
Permission: validations_cep:download

Starts delivery of the CEP as a PDF to the Telegram chat linked to the owning account.

An HTTP status 202 (with queued: true in the body) confirms that delivery is pending, not that it completed.

It requires an available receipt and a linked Telegram account:

Without the document, it responds with an HTTP status 409 (with cep_not_available in the body).
Without the link, it responds with an HTTP status 409 (with telegram_not_linked in the body).

Parameters
Parameter	In	Type	Required	Description
`id`*	path	`string (uuid)`	required	Validation UUID.

Request

cURLPython•JavaScript•PHP•

curl -X POST 'https://api.veriko.mx/v1/validations/{id}/cep/send-telegram' \
  -H 'Authorization: Bearer veriko_••••' \
  -H 'Content-Type: application/json'

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response status codes**`POST /v1/validations/{id}/cep/send-telegram`
Status	Class	Description	Body
202	`2xx`	CEP delivery was accepted and is pending delivery to the linked Telegram chat.	Body without schema
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`
403	`4xx`	Insufficient permissions.	`ErrorResponse`
404	`4xx`	Validation not found or not owned by the account (`not_found`).	`ErrorResponse`
409	`4xx`	The CEP is unavailable (`cep_not_available`) or the account has no linked Telegram chat (`telegram_not_linked`).	`ErrorResponse`
410	`4xx`	The validation was purged and this resource no longer exists (`validation_purged`).	`ErrorResponse`
422	`4xx`	Invalid UUID in path (`invalid_uuid`).	`ErrorResponse`
503	`5xx`	Delivery could not be started (`dispatch_failed`).	`ErrorResponse`

**Errors from `POST /v1/validations/{id}/cep/send-telegram`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`
410	`validation_purged`	The validation was purged and this resource no longer exists. Envelope meta.request_id `1a2b3c4d5e6ff6e5d4c3b2a1`