Padrón API v1.0.0 PA-001

Consulta de cédulas de Costa Rica | soportereal.com

API público de consulta de identificaciones costarricenses: cédula física, cédula jurídica, DIMEX y NITE. Devuelve nombre, tipo de identificación, régimen tributario, situación ante Hacienda y actividades económicas.

A diferencia de api.hacienda.go.cr, este endpoint manda encabezados CORS: se puede llamar directo desde el navegador, sin necesidad de un proxy propio. Y mantiene un espejo local del padrón, así que sigue respondiendo cuando Hacienda se cae.

Consultar una identificación

GET https://www.soportereal.com/herramientas/contribuyentes/v1/contribuyente/{identificacion}

GET https://www.soportereal.com/herramientas/contribuyentes/v1/contribuyente?identificacion={identificacion}

La identificación se manda sin guiones ni espacios (igual se aceptan y se limpian).

Probarlo

Escriba una identificación y presione Consultar.

Respuesta

{
  "identificacion": "3102750810",
  "nombre": "SOPORTE REAL SOCIEDAD DE RESPONSABILIDAD LIMITADA",
  "tipoIdentificacion": "02",
  "tipoDescripcion": "Cédula Jurídica",
  "esContribuyente": true,
  "regimen":   { "codigo": 1, "descripcion": "Régimen general" },
  "situacion": { "estado": "Inscrito de oficio", "moroso": "NO",
                 "omiso": "NO", "administracionTributaria": "San José" },
  "actividades": [
    { "codigo": "6201.0", "tipo": "P", "estado": "A",
      "descripcion": "Actividades de programación informática" }
  ],
  "_meta": { "fuente": "local", "origenNombre": "hacienda",
             "actualizadoEn": "2026-07-24T11:20:31-06:00", "ms": 14 }
}

En personas físicas se agregan dos bloques más, tomados del padrón electoral del TSE: persona (nombre y apellidos por separado, sexo, vencimiento de la cédula) y domicilio (provincia, cantón, distrito).

Campos

Campo	Descripción
`nombre`	Razón social o nombre completo.
`tipoIdentificacion`	`01` física · `02` jurídica · `03` DIMEX · `04` NITE
`esContribuyente`	`false` = la identificación existe pero no está inscrita en Hacienda. El nombre en ese caso viene del padrón del TSE.
`regimen`	Régimen tributario. Solo si es contribuyente.
`situacion`	Estado ante Hacienda, y si está moroso u omiso.
`actividades`	Actividades económicas (CIIU). `tipo`: `P` principal, `S` secundaria.
`domicilio`	Domicilio electoral (TSE). Solo físicas.
`_meta.fuente`	`local` = del espejo · `hacienda` = recién traído · `tse` = solo padrón electoral.

Códigos HTTP

Código	Significado
`200`	Encontrado.
`400`	Identificación inválida o falta el parámetro.
`404`	No existe en Hacienda ni en el padrón.
`429`	Se pasó del límite de consultas. Espere y reintente.
`503`	Hacienda no responde y la identificación no está en el espejo local.

Límite de uso: 60 consultas por minuto por dirección IP. Si necesita más volumen, escriba a soporte@soportereal.com.

Ejemplos

curl "https://www.soportereal.com/herramientas/contribuyentes/v1/contribuyente/3102750810"

fetch('https://www.soportereal.com/herramientas/contribuyentes/v1/contribuyente/3102750810')
  .then(r => r.json())
  .then(console.log);

Estado del servicio

GET https://www.soportereal.com/herramientas/contribuyentes/v1/estado

Cuántos registros tiene el espejo local y si Hacienda está alcanzable en este momento.

Fuentes

Ministerio de Hacienda de Costa Rica (padrón de contribuyentes, /fe/ae) y Tribunal Supremo de Elecciones (padrón electoral). Los datos se sirven tal como los publican esas instituciones; este servicio no los modifica.