Skip to main content
GET
Consultar el padrón de ARCA por CUIT

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"

Path Parameters

cuit
string
required

Query Parameters

environment
enum<string>

Contra qué padrón consultar.

Con API key no hace falta: sale del modo de la key, emi_live_ a producción y emi_test_ a homologación. Está para la sesión de panel, que no tiene modo porque opera sobre contribuyentes de los dos ambientes. Por omisión, PRODUCCION.

En homologación ARCA puede no resolver la persona, y eso es esperable: la respuesta sale con padronStatus distinto de VALIDATED.

Available options:
HOMOLOGACION,
PRODUCCION
Example:

"PRODUCCION"

Response

Lo que el padrón tiene registrado. Un padronStatus distinto de VALIDATED no es un error: es que no se pudo saber.

cuit
string
required

El CUIT consultado, tal como se pidió.

Example:

"20437136697"

La razón social según ARCA, lista para mandar como legalName. null si el padrón no la resolvió: no se inventa un nombre.

Example:

"LIOTTA CAMILO"

vatStatus
string | null
required

La condición frente al IVA como emisor, lista para mandar como vatStatus. Es el vocabulario de POST /v1/taxpayers, no el de ReceptorValidadoDto.vatCondition, que es el del receptor.

null cuando el padrón no permite deducirla, y ahí no se adivina: suponer una condición decide la letra del comprobante, que es un error fiscal y no un detalle de presentación.

Example:

"Responsable Inscripto"

inscripcionActiva
boolean
required

true si el padrón le registra IVA o monotributo activos, o sea si está en condiciones de emitir. Es el mismo criterio que el estado SIN_INSCRIPCION_ACTIVA del diagnóstico de conexión.

Example:

true

condicionIvaId
enum<number> | null
required

El código de CONDICION_IVA_RECEPTOR — el que viaja en un comprobante como receiverVatConditionId. 1 responsable inscripto, 4 exento, 5 consumidor final, 6 monotributo, y así.

No es lo mismo que vatStatus, que describe a la persona como emisor y tiene tres valores. Para llenar el receptor de un comprobante el que sirve es éste.

null si el padrón no permitió deducirla.

Available options:
1,
4,
5,
6,
7,
8,
9,
10,
13,
15,
16
Example:

1

estadoClave
string | null
required

Estado de la clave fiscal según el padrón. Un CUIT INACTIVO no puede recibir un comprobante A, así que conviene mirarlo antes de emitir uno.

Example:

"ACTIVO"

padronStatus
enum<string>
required

Cómo salió la consulta.

  • VALIDATED — el padrón resolvió la persona.
  • NOT_FOUND — ARCA no reconoce ese CUIT.
  • UNAVAILABLE — no se pudo consultar. No quiere decir que el CUIT esté mal: quiere decir que no se sabe.
  • WARNING — no corresponde consultar.

Nunca es un error HTTP. Un padrón que no contesta no puede tumbar un alta, así que la respuesta es 200 con el estado adentro y legalName/vatStatus en null.

Available options:
VALIDATED,
NOT_FOUND,
UNAVAILABLE,
WARNING
Example:

"VALIDATED"

padronMessage
string | null
required

El detalle cuando padronStatus no es VALIDATED.

consultadoEn
string<date-time>
required

Cuándo se consultó. Siempre es ahora: esta consulta no usa cache, porque el cache del padrón vive colgado de una fila de cliente y acá todavía no hay ninguna.

Example:

"2026-08-22T04:31:00.000Z"