DELETEhttps://api.veriko.mx/v1/validations/{id}

Withdraw a validation

Audience: public
Auth: API key
Permission: validations:delete

Withdraws a validation from the history through a soft delete.

The record keeps its result and can reappear in GET /v1/validations with the with_deleted filter. Only the owning account can withdraw it.

The record, the CEP, the extracted data, and the receipt file are kept. To delete them permanently, there is POST /v1/validations/{id}/purge/prepare, followed by POST /v1/validations/{id}/purge/execute.

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

Request

cURLPython•JavaScript•PHP•

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

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response status codes**`DELETE /v1/validations/{id}`
Status	Class	Description	Body
204	`2xx`	Validation withdrawn. Empty body.	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 account.	`ErrorResponse`
422	`4xx`	Invalid UUID in path (`invalid_uuid`).	`ErrorResponse`

**Errors from `DELETE /v1/validations/{id}`**
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`