| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Intro
This API retrieves a Canceled Invoices query you already executed, from the id that query returned.
It is meant for reading a result again without signing in to the SAT portal one more time and at no additional cost.
Important Points
Path parameter
| field | type | required | length | Description |
|---|---|---|---|---|
| id | Alphanumeric | Yes | N/A | Execution identifier returned by POST /api/v2/sat/canceled_invoices. |
The CIEC stays masked
The request comes back exactly as it was stored, which means the password shows as asterisks. The taxpayer's CIEC is never returned by this endpoint.
Successful response
The body is the same one returned by Canceled Invoices: the execution wrapper with the cancellation requests.
| subfield | Description |
|---|---|
| id | Execution identifier. |
| createdAt | Date and time the execution started. |
| finishedAt | Date and time it finished. |
| duration | Duration in milliseconds. |
| status | Execution status. |
| errorMessage | Reason, present when the credentials were wrong or the execution failed. |
| searchableBy | Keys the execution was stored with. |
| request | The body that was sent, with the password masked. |
| response | The total and the list of cancellation requests. |
| apiData | The call made to the SAT portal and the page it returned. |
{
"id": "68752a1b0000000000000f01",
"createdAt": "2026-07-14T15:40:11.204Z",
"finishedAt": "2026-07-14T15:40:29.882Z",
"duration": 18678,
"status": "SUCCESS",
"searchableBy": {
"externalId": "solicitud-4821"
},
"request": {
"rfc": "LIQ2209121V6",
"password": "********",
"externalId": "solicitud-4821"
},
"response": {
"total": 1,
"invoices": [
{
"folioFiscal": "FBF788D3-1681-4A63-BA32-C4B5951D1606",
"rfcEmisor": "MRE2412175E4",
"nombreEmisor": "MOTOS REGIAS",
"rfcReceptor": "LIQ2209121V6",
"nombreReceptor": "LIQUITECH",
"fechaEmision": "2026-05-27T14:10:16.000-06:00",
"fechaCertificacion": "2026-05-27T14:10:35.000-06:00",
"fechaSolicitud": "2026-07-14T15:33:45.000-06:00",
"pacCertifico": "SAT970701NN3",
"total": "$65,498.99",
"efectoComprobante": "",
"estatusSolicitud": "En proceso",
"motivo": "",
"folioSustitucion": ""
}
]
},
"apiData": [
{
"url": "https://portalcfdi.facturaelectronica.sat.gob.mx/ConsultaCancelacion.aspx",
"duration": 4182,
"request": {
"date": "2026-07-14T15:40:25.118Z",
"headers": { "...": "..." }
},
"response": {
"date": "2026-07-14T15:40:29.300Z",
"httpCode": 200,
"body": "<!DOCTYPE html> … "
}
}
]
}Execution where the credentials were wrong
An execution that failed to sign in is stored like any other, with status: SUCCESS and no response. Reading it back returns the same thing the query returned.
{
"id": "68752a1b0000000000000f03",
"createdAt": "2026-07-14T15:47:31.556Z",
"finishedAt": "2026-07-14T15:47:48.019Z",
"duration": 16463,
"status": "SUCCESS",
"errorMessage": "Error credentials wrong RFC or password",
"request": {
"rfc": "LIQ2209121V6",
"password": "********"
}
}Listing the possible not success responses
Not found
The id does not exist or does not belong to your account. You will not receive a body, only a 400 HTTP code.
Unauthorized
It means that the provided API is incorrect and that you are not authorized to access it. You will not receive a body, only a 401 HTTP code.