Send the CEP to Telegram

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

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

Delivers this validation's CEP to the Telegram chat linked to the account. The send happens in the background, so the response is an immediate 202 with queued: true and the document appears in the chat a few seconds later: the 202 confirms it was enqueued, not delivered. Two conditions are required. That the CEP exists — that is, the validation ended in banxico_status: 'valid' — and that the account has Telegram linked, which telegram_linked on GET /v1/users/me reports. Without the first, the response is 404 cep_not_available; without the second, 409 telegram_not_linked. The delivered document is the same PDF returned by GET /v1/validations/{id}/cep?format=pdf.

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`	The CEP delivery to Telegram was queued. The `bots` worker uploads the document to the linked chat asynchronously.	No body
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 user (`not_found`).	`ErrorResponse`
409	`4xx`	The CEP is not available for this validation (`cep_not_available`, when `banxico_status` is not `valid` or the PDF was not persisted), or the user has no Telegram account linked (`telegram_not_linked`).	`ErrorResponse`
422	`4xx`	Invalid UUID in path (`invalid_uuid`).	`ErrorResponse`
503	`5xx`	Could not queue the delivery (broker unavailable, `dispatch_failed`). The client may retry.	`ErrorResponse`

**Errors from `POST /v1/validations/{id}/cep/send-telegram`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b9`
403	`forbidden`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c0`