Documentación de la API

Referencia común a todos los países. Los campos de la respuesta de cada uno están en su página: República Dominicana, Ecuador y Argentina.

1. Cómo empezar
2. Autenticación
3. Consultar por identificador
4. Buscar por nombre
5. Estado de los datos
6. Límites
7. Errores

Cómo empezar

1. Crea una cuenta con tu email y una contraseña.
2. Genera tu API key en Mi cuenta.
3. Haz tu primera consulta:

curl -H "X-API-Key: TU_API_KEY" https://idfiscal.com/v1/do/rnc/101010632

Autenticación

Envía tu key en el header X-API-Key en cada petición. Cada cuenta tiene una sola key, válida para todos los países. Si la regeneras, la anterior deja de funcionar al instante.

No pongas la key en código que corre en el navegador o en apps móviles, porque cualquiera podría copiarla. Haz las consultas desde tu servidor.

Consultar por identificador

GET /v1/{pais}/{identificador}/{numero}

Devuelve el contribuyente con ese número, o 404 si no está en el padrón. El número se acepta con o sin guiones.

Buscar por nombre

GET /v1/{pais}/{identificador}?q={texto}&limit={n}&offset={n}

La búsqueda solo incluye personas jurídicas (empresas, asociaciones, entidades). Las personas físicas inscritas en el padrón se pueden validar por número exacto, pero no aparecen en la búsqueda.

Los resultados van ordenados del más al menos parecido al texto buscado. total es la cantidad de coincidencias. Quedan más páginas mientras offset + limit < total. Cada página cuenta como una consulta para tu límite.

curl -H "X-API-Key: TU_API_KEY" "https://idfiscal.com/v1/ar/cuit?q=mercadolibre&limit=2"

{
  "data": [
    { "cuit": "30703088534", "denominacion": "MERCADOLIBRE S.R.L.", ... },
    { "cuit": "30719373387", "denominacion": "MERCADOLIBRE FCI CERRADO DE CR", ... }
  ],
  "total": 2,
  "limit": 2,
  "offset": 0
}

Estado de los datos

GET /v1/meta

Devuelve, por país, la cantidad de registros y la fecha de la última actualización.

{
  "paises": {
    "do": { "pais": "República Dominicana", "total": 795983, "actualizado": "2026-10-28T03:09:32Z" },
    "ec": { "pais": "Ecuador", "total": 7155547, "actualizado": "2026-10-28T03:06:25Z" },
    "ar": { "pais": "Argentina", "total": 6211641, "actualizado": "2026-10-28T02:17:25Z" }
  }
}

Límites

Cada cuenta puede hacer 30 consultas por minuto y 1000 por día, sumando todos los países. Si necesitas más, escríbenos a soporte@idfiscal.com.

Cada respuesta incluye estos headers:

Si pasas el límite, la respuesta es 429, con el header Retry-After indicando cuántos segundos esperar.

Errores

Los errores se devuelven en JSON con este formato:

{ "error": "RNC no encontrado" }