Skip to main content
GET
Listar contribuyentes

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

producto
string

Sólo los contribuyentes que incluyen este producto (pueden tener varios). Una key atada a un producto sólo ve los suyos, así que con otro valor la lista sale vacía. Los contribuyentes sin productos no aparecen bajo ningún valor; sin el filtro siguen listándose (a una key sin producto).

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

"inmos"

cuit
string

Por CUIT exacto, con o sin guiones. Es la forma de recuperar el id de un contribuyente cuyo alta devolvió 409.

Example:

"30711223344"

environment
enum<string>

Sólo los de este ambiente. Sin el filtro se listan los dos: una key test sólo puede operar los de HOMOLOGACION, pero los de PRODUCCION de su organización también se ven.

Available options:
HOMOLOGACION,
PRODUCCION
limit
number
default:25

Cuántos contribuyentes por página.

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

El pagination.nextCursor de la respuesta anterior, tal cual vino. Es opaco. Un cursor ilegible da 400 INVALID_CURSOR.

withTotal
boolean
default:false

Agrega pagination.total con cuántos contribuyentes matchean, ignorando el cursor. Cuesta un COUNT(*): pedilo en la primera página.

Response

Una página de contribuyentes.

data
object[]
required

Las filas de esta página, del más reciente al más viejo. Cada una tiene la misma forma que la respuesta del alta.

pagination
object
required

Cómo pedir la página siguiente.