Documentación de la API

Consulta el estado concursal del Registro Público Concursal de forma programática.
Base URL: … Formato: JSON Auth: X-Api-Key header

🔑 Autenticación

Todas las peticiones deben incluir el header X-Api-Key con una clave válida. Las claves se generan desde el Dashboard → Ajustes → Claves API.

Cada clave solo se muestra una vez al generarla.

Ejemplo

curl /detalle/53676447J \
  -H "X-Api-Key: cc_TuClaveAqui"
GET
/health
Comprueba que el servidor está activo.

Ejemplo

curl /health \
  -H "X-Api-Key: cc_TuClaveAqui"

Respuesta

{
  "status": "ok"
}
POST
/consultar
Estado concursal básico para una lista de NIFs (sin detalle de secciones).

Body

CampoTipoObligatorioDescripción
nifsstring[]SíLista de NIFs a consultar

Ejemplo

curl -X POST /consultar \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: cc_TuClaveAqui" \
  -d '{"nifs":["53676447J","B12345678"]}'

Respuesta

{
  "resultados": [
    {
      "nif":          "53676447J",
      "nombre":       "JUAN GARCIA SA",
      "deudor":       true,
      "inhabilitado": false,
      "administrador":false,
      "encontrado":   true
    }
  ],
  "errors": []
}
GET
/consultar/{nif}
Estado concursal básico de un único NIF via parámetro de ruta.

Parámetros de ruta

NombreTipoDescripción
nifstringNIF o CIF a consultar

Ejemplo

curl /consultar/53676447J \
  -H "X-Api-Key: cc_TuClaveAqui"

Respuesta

{
  "nif":          "53676447J",
  "nombre":       "JUAN GARCIA SA",
  "deudor":       true,
  "inhabilitado": false,
  "administrador":false,
  "encontrado":   true
}
POST
/detalle
Detalle concursal completo (todas las secciones) para una lista de NIFs. Los NIFs se procesan en paralelo.

Body

CampoTipoObligatorioDescripción
nifsstring[]SíLista de NIFs

Ejemplo

curl -X POST /detalle \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: cc_TuClaveAqui" \
  -d '{"nifs":["53676447J"]}'

Respuesta

{
  "resultados": [
    {
      "nif":          "53676447J",
      "nombre":       "JUAN GARCIA SA",
      "deudor":       true,
      "inhabilitado": false,
      "administrador":false,
      "encontrado":   true,
      "edictos_concursales": [
        {
          "fechaResolucion":        "27/02/2026",
          "numProcedimiento":       "0000065/2026",
          "tipoResolucionProcesal": { "desTipoResoProcesales": "Auto de declaración de concurso" },
          "juzgadoIri": {
            "nombre": "SECCION MERCANTIL 1",
            "nombreJuezCompleto": "MIGUEL ALVAREZ PEREZ",
            "direccion": { "provincia": { "desProvincia": "ASTURIAS" } }
          },
          "datosResolucionS1": {
            "tipoConcurso":     { "desTipoConcurso":     "Voluntario" },
            "tipoProcedimiento": { "desTipoProcedimiento": "Abreviado" }
          },
          "contenidoEdicto": "Texto completo del edicto..."
        }
      ],
      "publicidad_registral_resoluciones": [],
      "exoneracion_pasivo_insatisfecho":   [],
      "administracion_concursal":          [],
      "publicidad_registro_mercantil":     [],
      "acuerdos_extrajudiciales":          []
    }
  ],
  "errors": []
}
GET
/detalle/{nif}
Detalle completo de un único NIF. Devuelve el mismo objeto que el ítem de resultados del POST.

Parámetros de ruta

NombreTipoDescripción
nifstringNIF o CIF a consultar

Ejemplo

curl /detalle/53676447J \
  -H "X-Api-Key: cc_TuClaveAqui"

Respuesta

// Misma estructura que el ítem de resultados del POST /detalle
{
  "nif": "53676447J",
  "nombre": "JUAN GARCIA SA",
  ...
}
POST
/detalle/nombre
Detalle completo para una lista de nombres o razones sociales. Cada nombre puede devolver múltiples afectados.

Body

CampoTipoObligatorioDescripción
nombresstring[]SíLista de nombres o razones sociales

Ejemplo

curl -X POST /detalle/nombre \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: cc_TuClaveAqui" \
  -d '{"nombres":["ANA LOPEZ"]}'

Respuesta

{
  "resultados": [
    { "nif": "12345678A", "nombre": "ANA LOPEZ GARCIA",   "deudor": true,  ... },
    { "nif": "87654321B", "nombre": "ANA LOPEZ MARTINEZ", "deudor": false, ... }
  ],
  "errors": []
}
GET
/detalle/nombre/{nombre}
Detalle para un único nombre. Devuelve un array de coincidencias (puede haber varias personas con el mismo nombre).

Parámetros de ruta

NombreTipoDescripción
nombrestringNombre o razón social (URL-encoded)

Ejemplo

curl "/detalle/nombre/ANA%20LOPEZ" \
  -H "X-Api-Key: cc_TuClaveAqui"

Respuesta

[
  { "nif": "12345678A", "nombre": "ANA LOPEZ GARCIA", "deudor": true, ... }
]