Skip to main content
GET
Listar comprobantes

Authorizations

X-API-Key
string
header
required

API key de integración. El modo va en el prefijo: emi_test_ opera contra homologación, emi_live_ contra producción. Después, 64 hexadecimales.

Headers

X-Emissa-Producto
string

El producto que origina el pedido (inmos, por ejemplo). Opcional, sólo con API key. Formato ^[a-z0-9-]{1,32}$; otro valor da 400 INVALID_INPUT. Queda en el comprobante, en el consumo y en el registro de pedidos.

Con una key sin producto es sólo atribución: no autoriza ni restringe nada. Con una key atada a un producto el pedido se etiqueta con el de la key aunque no mandes la cabecera, y si mandás otro valor la respuesta es 403 API_KEY_PRODUCTO_DISTINTO.

Pattern: ^[a-z0-9-]{1,32}$
Example:

"inmos"

Query Parameters

taxpayerId
string
required

Contribuyente sobre el que se opera. Obligatorio. Uno solo: repetirlo en el query string es 400 INVALID_INPUT.

Example:

"cmfa1b2c30000"

cbteTipo
enum<number>

El código de ARCA, no la etiqueta.

Available options:
1,
2,
3,
6,
7,
8,
11,
12,
13
Example:

1

status
enum<string>[]

Uno o varios. Se repite el parámetro (?status=PENDING&status=UNKNOWN) o se separan con comas. Un estado que no existe da 400, no una lista vacía.

PENDING y UNKNOWN juntos son los comprobantes sin resolver: el número ya está tomado y no se sabe si ARCA lo autorizó.

Available options:
DRAFT,
PENDING,
AUTHORIZED,
REJECTED,
UNKNOWN,
CANCELLED
Example:
salePoint
number
Required range: x >= 1
Example:

1

number
number
Required range: x >= 1
Example:

7

q
string

Resuelve contra el número del comprobante (7 o 0001-00000007), el nombre del receptor, su documento y el CAE.

Los identificadores se buscan completos; el nombre, por fragmento y sin distinguir mayúsculas. El CUIT se puede escribir con guiones: se normaliza antes de comparar.

El Request ID no entra acá: hoy no se guarda en el comprobante, así que no hay contra qué resolverlo.

Maximum string length: 120
Example:

"20-43713669-7"

externalReference
string

Resuelve por igualdad exacta contra la referencia que mandaste al emitir. Devuelve 0 o 1 comprobante: es única por contribuyente y ambiente. Para buscar por fragmento está q.

Maximum string length: 64
Example:

"COBRO-8842"

origin
enum<string>

Por dónde entró: API lo emitió una integración, PANEL se cargó a mano. Los comprobantes emitidos antes de que se registrara el origen no aparecen bajo ningún valor: no se sabe por dónde entraron. Sin el filtro siguen listándose.

Available options:
API,
PANEL
Example:

"API"

producto
string

El producto que originó el comprobante (X-Emissa-Producto al emitir). Los emitidos sin la cabecera, desde el panel o antes de que existiera no aparecen bajo ningún valor; sin el filtro siguen listándose.

Maximum string length: 32
Pattern: ^[a-z0-9-]{1,32}$
Example:

"inmos"

limit
number
default:25

Cuántos comprobantes por página. Cada uno trae sus items, su desglose de IVA y sus asociaciones, así que el tope no es arbitrario.

Required range: 1 <= x <= 100
cursor
string

El pagination.nextCursor de la respuesta anterior, tal cual vino. Es opaco: no lo interpretes ni lo construyas a mano. Un cursor ilegible da 400 INVALID_CURSOR.

dateFrom
string<date>

Fecha de emisión desde, inclusive.

Example:

"2026-01-01"

dateTo
string<date>

Fecha de emisión hasta, inclusive.

Example:

"2026-12-31"

withTotal
boolean
default:false

Agrega pagination.total con cuántos comprobantes matchean la consulta, ignorando el cursor.

Cuesta un COUNT(*) sobre el histórico filtrado, así que hay que pedirlo. Conviene en la primera página —para mostrar "248 resultados" u ofrecer "seleccionar los 248"— y no en cada página siguiente: el total no cambia mientras se pagina.

Response

Una página del histórico.

data
object[]
required

Las filas de esta página, de la más reciente a la más vieja.

pagination
object
required

Cómo pedir la página siguiente.