Consultar una factura
const url = 'https://sandbox.api.cierrelisto.com/v1/taxpayers/340f4500-e627-4f37-aaa8-9ad5baff8209/invoices/cc70a888-12db-48c5-8893-ef72046f57f1';const options = { method: 'GET', headers: { 'X-Request-Id': 'req_6a07a2bfa55e4e1ebf5a9f27482f09f1', Authorization: 'Bearer <token>' }};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://sandbox.api.cierrelisto.com/v1/taxpayers/340f4500-e627-4f37-aaa8-9ad5baff8209/invoices/cc70a888-12db-48c5-8893-ef72046f57f1 \ --header 'Authorization: Bearer <token>' \ --header 'X-Request-Id: req_6a07a2bfa55e4e1ebf5a9f27482f09f1'Requiere el alcance invoices.read.
Authorizations
Sección titulada «Authorizations»Parameters
Sección titulada «Parameters»Path Parameters
Sección titulada «Path Parameters»Contribuyente autorizado dentro de la cuenta CierreListo.
Example
340f4500-e627-4f37-aaa8-9ad5baff8209Example
cc70a888-12db-48c5-8893-ef72046f57f1Header Parameters
Sección titulada «Header Parameters»Identificador opcional del cliente. Si no es válido, CierreListo genera uno.
Example
req_6a07a2bfa55e4e1ebf5a9f27482f09f1Responses
Sección titulada «Responses»Factura encontrada.
object
object
La API pública v1 emite únicamente facturas en pesos dominicanos (DOP).
object
object
Example
{ "data": { "id": "cc70a888-12db-48c5-8893-ef72046f57f1", "taxpayer_id": "340f4500-e627-4f37-aaa8-9ad5baff8209", "external_id": "erp-venta-2026-000184", "ecf_type": "31", "status": "queued", "fiscal_document_id": "261aa475-f462-4446-9f88-9525714ed925", "currency": "DOP", "issue_date": "2026-07-29", "totals": { "subtotal": "70000.00", "discount_total": "0.00", "tax_total": "12600.00", "total": "82600.00", "paid": "0.00", "balance": "82600.00" }, "created_at": "2026-07-29T14:05:10.000-04:00", "updated_at": "2026-07-29T14:05:10.000-04:00" }, "meta": { "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1" }}Headers
Sección titulada «Headers»Identificador de trazabilidad de la solicitud.
Example
req_6a07a2bfa55e4e1ebf5a9f27482f09f1Máximo de solicitudes permitidas en la ventana actual.
Example
70Solicitudes disponibles antes de agotar la ventana actual.
Example
69Instante de reinicio de la ventana expresado como Unix time.
Example
1785337200Credencial ausente o inválida.
object
object
object
Example
{ "error": { "code": "unauthorized", "message": "La credencial no es válida.", "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1" }}Headers
Sección titulada «Headers»Identificador de trazabilidad de la solicitud.
Example
req_6a07a2bfa55e4e1ebf5a9f27482f09f1Máximo de solicitudes permitidas en la ventana actual.
Example
70Solicitudes disponibles antes de agotar la ventana actual.
Example
69Instante de reinicio de la ventana expresado como Unix time.
Example
1785337200La credencial no autoriza esta operación, integración o ambiente.
object
object
object
Example
{ "error": { "code": "forbidden", "message": "La credencial no tiene el alcance requerido.", "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1" }}Headers
Sección titulada «Headers»Identificador de trazabilidad de la solicitud.
Example
req_6a07a2bfa55e4e1ebf5a9f27482f09f1Máximo de solicitudes permitidas en la ventana actual.
Example
70Solicitudes disponibles antes de agotar la ventana actual.
Example
69Instante de reinicio de la ventana expresado como Unix time.
Example
1785337200El recurso no existe dentro del contribuyente autorizado.
object
object
object
Example
{ "error": { "code": "not_found", "message": "No se encontró el recurso solicitado.", "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1" }}Headers
Sección titulada «Headers»Identificador de trazabilidad de la solicitud.
Example
req_6a07a2bfa55e4e1ebf5a9f27482f09f1Máximo de solicitudes permitidas en la ventana actual.
Example
70Solicitudes disponibles antes de agotar la ventana actual.
Example
69Instante de reinicio de la ventana expresado como Unix time.
Example
1785337200Se excedió el límite temporal de solicitudes.
object
object
object
Example
{ "error": { "code": "rate_limited", "message": "Espera antes de volver a intentarlo.", "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1" }}Headers
Sección titulada «Headers»Identificador de trazabilidad de la solicitud.
Example
req_6a07a2bfa55e4e1ebf5a9f27482f09f1Máximo de solicitudes permitidas en la ventana actual.
Example
70Solicitudes disponibles antes de agotar la ventana actual.
Example
69Instante de reinicio de la ventana expresado como Unix time.
Example
1785337200CierreListo no pudo completar la operación por un error interno.
object
object
object
Example
{ "error": { "code": "internal_error", "message": "No pudimos completar la operación. Conserva el request_id para soporte.", "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1" }}Headers
Sección titulada «Headers»Identificador de trazabilidad de la solicitud.
Example
req_6a07a2bfa55e4e1ebf5a9f27482f09f1Máximo de solicitudes permitidas en la ventana actual.
Example
70Solicitudes disponibles antes de agotar la ventana actual.
Example
69Instante de reinicio de la ventana expresado como Unix time.
Example
1785337200El servicio no puede completar temporalmente la operación.
object
object
object
Example
{ "error": { "code": "service_unavailable", "message": "El servicio no está disponible temporalmente.", "request_id": "req_6a07a2bfa55e4e1ebf5a9f27482f09f1" }}Headers
Sección titulada «Headers»Identificador de trazabilidad de la solicitud.
Example
req_6a07a2bfa55e4e1ebf5a9f27482f09f1Máximo de solicitudes permitidas en la ventana actual.
Example
70Solicitudes disponibles antes de agotar la ventana actual.
Example
69Instante de reinicio de la ventana expresado como Unix time.
Example
1785337200Segundos que debe esperar el cliente antes de reintentar una operación temporalmente ocupada.
Example
1