English

Referencia

Referencia de la API

Las cuatro APIs del portal —empresas (BORME), biblioteca jurídica, calculadoras y asistente—, cada endpoint documentado entero: para qué sirve, sus parámetros, la forma exacta de la respuesta, los errores que puede dar y un ejemplo en curl, Python y JavaScript.

Autenticación

Todas las llamadas necesitan la clave de API de tu cuenta de desarrollador en la cabecera Authorization, como bearer. Una clave de un despacho de la aplicación no vale aquí (401). No hay ningún otro método de autenticación, y nunca va en la URL ni en el cuerpo.

Authorization: Bearer iuris_sk_…

Dirección base

Mientras no exista un punto de conexión propio para la API (api.jurilia.com, todavía sin abrir), la plataforma vive en la misma dirección que el resto de la aplicación. Todas las rutas de este documento son relativas a ella:

https://api.jurilia.com/v1

Restricción por IP/CIDR

Una clave puede llevar una lista blanca de IPs o redes (CIDR, IPv4 o IPv6). Vacía —lo normal— significa sin restricción. Con la lista puesta, una llamada desde fuera de ella da 403 aunque la clave sea válida: ver Errores y límites. Pendiente: el panel de desarrollador todavía no permite configurarla.

Límite de peticiones

120 llamadas por minuto, por clave (también en las APIs gratuitas). Toda respuesta lleva las cabeceras `X-RateLimit-Limit`, `X-RateLimit-Remaining` y `X-RateLimit-Reset`: ver Errores y límites para el detalle.

Antes de los ejemplos: un ayudante en tres líneas

Cada endpoint de abajo muestra su `curl` completo, y además una llamada a este mismo ayudante en Python y en JavaScript, para no repetir la cabecera y la URL en cada ejemplo.

import requests

def dev_api(ruta, **parametros):
    r = requests.get(
        f"https://api.jurilia.com/v1/dev{ruta}",
        headers={"Authorization": "Bearer TU_CLAVE"},
        params=parametros,
    )
    r.raise_for_status()  # lanza si es 4xx/5xx — ver Errores y límites
    return r.json()

def dev_api_post(ruta, cuerpo):  # las calculadoras y el asistente son POST
    r = requests.post(
        f"https://api.jurilia.com/v1/dev{ruta}",
        headers={"Authorization": "Bearer TU_CLAVE"},
        json=cuerpo,
    )
    r.raise_for_status()
    return r.json()
async function devApi(ruta, parametros = {}) {
  const url = new URL(`https://api.jurilia.com/v1/dev${ruta}`);
  for (const [clave, valor] of Object.entries(parametros)) {
    url.searchParams.set(clave, valor);
  }
  const r = await fetch(url, { headers: { Authorization: "Bearer TU_CLAVE" } });
  if (!r.ok) throw new Error(`${r.status}: ${(await r.json()).mensaje}`);
  return r.json();
}

async function devApiPost(ruta, cuerpo) {  // las calculadoras y el asistente son POST
  const r = await fetch(`https://api.jurilia.com/v1/dev${ruta}`, {
    method: "POST",
    headers: { Authorization: "Bearer TU_CLAVE", "Content-Type": "application/json" },
    body: JSON.stringify(cuerpo),
  });
  if (!r.ok) throw new Error(`${r.status}: ${(await r.json()).mensaje}`);
  return r.json();
}

El contrato entero, en una línea

Todo lo de esta página sale de un único OpenAPI 3.1 que la propia API genera y expone en tiempo real. Pégalo en editor.swagger.io, o impórtalo en Postman o Insomnia, para una vista interactiva con la que probar llamadas sin escribir código:

https://api.jurilia.com/v1/openapi.json

Las cuatro APIs

Una misma clave y un mismo saldo para las cuatro: empresas (BORME), biblioteca jurídica, calculadoras y asistente. Todas son datos públicos u operaciones puras: nada de un despacho entra ni sale de ellas.

Qué cuesta cada llamada

Las APIs de pago (empresas y asistente) se descuentan de un único saldo de prepago (nunca hay deuda: sin saldo, la llamada no se sirve y da 402). Una petición mal formada, un fallo nuestro o un cálculo que no se puede hacer (409) no cuestan nada. Biblioteca y calculadoras no tocan el saldo; todas las APIs tienen el límite de 120 llamadas por minuto por clave.

  • Empresas (BORME). 3 céntimos por consulta, de saldo prepagado. Las rutas de servicio (ping, estado, provincias) son gratis.
  • Biblioteca y calculadoras. Biblioteca, calculadoras y plazos se cobran por llamada servida (ver la tabla de precios). Los catálogos (abreviaturas, listado de calculadoras, calendarios, municipios y reglas) son gratis.
  • Asistente. Sólo en modo rápido. Por token: 22 € por millón de tokens de entrada, 2,20 € de entrada en caché y 110 € de salida y de razonamiento, sin cuota fija (una pregunta normal, unos 30 céntimos; una larga, unos 90 céntimos). La respuesta dice los tokens de cada tipo, el precio aplicado y lo cobrado (`facturacion`) y lo que queda (`saldoCentimos`). Con archivos adjuntos, el texto del documento cuenta como tokens de entrada (mayor cuanto más largo sea el documento); la lectura de páginas escaneadas (OCR) cuesta 2 céntimos por página.

1. Empresas (BORME)

Los diez endpoints de arriba: el eco de comprobación, la búsqueda de empresas y personas, las fichas, los boletines y las estadísticas.

Los diez primeros: el eco de comprobación y los datos públicos del BORME (art. 13 LPI). Nada que cuelgue de un despacho —ni cartera, ni correo de novedades, ni vincular una parte a un expediente—: eso es terreno de la sesión del abogado, no de una clave de un tercero. Más abajo, la biblioteca, las calculadoras y el asistente.

GET/v1/dev/ping

Comprobar la clave

Confirma que la clave de tu cuenta de desarrollador es válida. No lee ni expone ningún dato de negocio ni de ningún despacho. Gratis, y el primer paso de cualquier integración, antes de construir nada encima.

Parámetros

Ninguno.

Respuesta

{
  "ok": true,
  "ambitos": [],
  "ahora": "2026-10-01T09:00:00.000Z"
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.)

curl

curl https://api.jurilia.com/v1/dev/ping \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/ping")

JavaScript

await devApi('/ping')
GET/v1/dev/empresas

Buscar empresas en el BORME

Entiende un CIF, una hoja registral («M 167931») o un nombre; menos de tres letras no busca. `provincia` y `cnae` filtran el resultado ya encontrado; `cnae` es la división (dos dígitos) del objeto social publicado, no el código completo del Registro.

Parámetros

  • qstringobligatorio— El CIF, la hoja o el nombre a buscar.
  • provinciastringopcional— Nombre exacto de la provincia.
  • cnaestringopcional— División CNAE, dos dígitos («62» = programación y consultoría informática).
  • limiteenteroopcional— Entre 1 y 100. Por defecto, 25.

Respuesta

{
  "tipo": "nombre",
  "sugerencia": null,
  "empresas": [
    {
      "id": "1234567",
      "denominacion": "ACME SOCIEDAD LIMITADA",
      "provincia": "Madrid",
      "hoja": "M 167931",
      "titular": "sociedad",
      "primeraPublicacion": "2010-03-15",
      "ultimaPublicacion": "2026-06-02",
      "concursalPublicadoEn": null,
      "disolucionPublicadaEn": null,
      "extincionPublicadaEn": null,
      "nombreQueCasa": null
    }
  ]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.)

curl

curl "https://api.jurilia.com/v1/dev/empresas?q=acme&provincia=Madrid" \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/empresas", q="acme", provincia="Madrid")

JavaScript

await devApi('/empresas', { q: 'acme', provincia: 'Madrid' })
GET/v1/dev/empresas/{empresaId}

Ficha de una empresa

Lo compacto de la ficha: situación (activa, concurso, disuelta, extinguida, con su fecha), capital, cargos vigentes y la última inscripción. `empresaId` es el que devuelve el buscador.

Parámetros

  • empresaIdstringobligatorio— El identificador, en la ruta.
  • paginaenteroopcional— De la cronología de inscripciones.

Respuesta

{
  "id": "1234567",
  "denominacion": "ACME SOCIEDAD LIMITADA",
  "provincia": "Madrid",
  "hoja": "M 167931",
  "titular": "sociedad",
  "situacion": "activa",
  "situacionFecha": null,
  "constitucionFecha": "2010-03-15",
  "primeraPublicacion": "2010-03-15",
  "ultimaPublicacion": "2026-06-02",
  "capitalCentimos": 300000,
  "totalInscripciones": 14,
  "denominaciones": [],
  "cargosVigentes": [{ "cargo": "Administrador único", "nombre": "…" }],
  "ultimaInscripcion": {
    "fecha": "2026-06-02",
    "boletin": "BORME-A-2026-104-12",
    "urlPdf": "https://www.boe.es/borme/dias/2026/06/02/pdfs/…pdf",
    "actos": [{ "tipo": "cambio_de_administradores", "etiqueta": null }]
  }
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 404 (No está en lo cargado (BORME) o la regla no existe.)

curl

curl https://api.jurilia.com/v1/dev/empresas/1234567 \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/empresas/1234567")

JavaScript

await devApi('/empresas/1234567')
GET/v1/dev/personas

Buscar personas en el BORME por su nombre

Dato público del boletín. El BORME no publica el DNI: nombres iguales pueden ser personas distintas, y la respuesta lo dice (`homonimos: "posibles"`). Nunca una etiqueta sobre la persona: sólo el hecho publicado, con su cita.

Parámetros

  • qstringobligatorio— El nombre a buscar.

Respuesta

{
  "personas": [
    {
      "slug": "juan-perez-garcia",
      "nombre": "JUAN PÉREZ GARCÍA",
      "empresas": 2,
      "ultimaAparicion": "2026-05-10",
      "homonimos": "posibles"
    }
  ]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.)

curl

curl "https://api.jurilia.com/v1/dev/personas?q=juan+perez" \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/personas", q="juan perez")

JavaScript

await devApi('/personas', { q: 'juan perez' })
GET/v1/dev/personas/{slug}

Ficha de una persona del BORME

Sus sociedades y las variantes con que ha aparecido su nombre. `slug` es el que devuelve el buscador de personas.

Parámetros

  • slugstringobligatorio— En la ruta.

Respuesta

{
  "slug": "juan-perez-garcia",
  "nombre": "JUAN PÉREZ GARCÍA",
  "variantes": ["JUAN PÉREZ GARCÍA"],
  "recortada": false,
  "homonimos": "posibles",
  "empresas": [{ "empresaId": "1234567", "denominacion": "ACME SOCIEDAD LIMITADA", "provincia": "Madrid" }]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 404 (No está en lo cargado (BORME) o la regla no existe.)

curl

curl https://api.jurilia.com/v1/dev/personas/juan-perez-garcia \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/personas/juan-perez-garcia")

JavaScript

await devApi('/personas/juan-perez-garcia')
GET/v1/dev/provincias

Provincias con algún boletín del BORME cargado

Para el filtro `provincia` de `GET /v1/dev/empresas`. Sin parámetros.

Parámetros

Ninguno.

Respuesta

{
  "provincias": ["Álava", "Albacete", "Alicante", "…"]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.)

curl

curl https://api.jurilia.com/v1/dev/provincias \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/provincias")

JavaScript

await devApi('/provincias')
GET/v1/dev/boletines

Los días con BORME cargado de un mes

Del más reciente al más antiguo.

Parámetros

  • mesAAAA-MMobligatorio— El mes a consultar.

Respuesta

{
  "dias": [
    { "fecha": "2026-09-30", "numero": 184, "documentos": 52, "inscripciones": 1402 }
  ]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.)

curl

curl "https://api.jurilia.com/v1/dev/boletines?mes=2026-09" \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/boletines", mes="2026-09")

JavaScript

await devApi('/boletines', { mes: '2026-09' })
GET/v1/dev/boletines/{fecha}

Las novedades publicadas en una fecha

Un día de BORME: sus boletines provinciales, con el PDF oficial de cada uno y cuántas inscripciones trae. 404 si ese día no se ha cargado —todavía, o nunca hubo boletín: fin de semana o festivo—.

Parámetros

  • fechaAAAA-MM-DDobligatorio— En la ruta.

Respuesta

{
  "fecha": "2026-09-30",
  "numero": 184,
  "documentos": 52,
  "inscripciones": 1402,
  "provincias": [
    {
      "identificador": "BORME-A-2026-184-28",
      "provincia": "Madrid",
      "urlPdf": "https://www.boe.es/borme/dias/2026/09/30/pdfs/…pdf",
      "anuncios": 311
    }
  ]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 404 (No está en lo cargado (BORME) o la regla no existe.)

curl

curl https://api.jurilia.com/v1/dev/boletines/2026-09-30 \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/boletines/2026-09-30")

JavaScript

await devApi('/boletines/2026-09-30')
GET/v1/dev/estadisticas

Cuántos actos por tipo y cuántas inscripciones por provincia

El intervalo se acota en el servidor a 31 días; si se recorta, la respuesta lo dice (`recortado: true`) y cuenta desde `hasta` hacia atrás.

Parámetros

  • desdeAAAA-MM-DDobligatorio
  • hastaAAAA-MM-DDobligatorio
  • provinciastringopcional— Acota el recuento a una provincia.

Respuesta

{
  "desde": "2026-09-01",
  "hasta": "2026-09-30",
  "recortado": false,
  "provincia": null,
  "dias": 22,
  "inscripciones": 38420,
  "actos": 41106,
  "porTipo": [{ "tipo": "cambio_de_administradores", "actos": 9122 }],
  "porProvincia": [{ "provincia": "Madrid", "inscripciones": 7310 }]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.)

curl

curl "https://api.jurilia.com/v1/dev/estadisticas?desde=2026-09-01&hasta=2026-09-30" \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/estadisticas", desde="2026-09-01", hasta="2026-09-30")

JavaScript

await devApi('/estadisticas', { desde: '2026-09-01', hasta: '2026-09-30' })
GET/v1/dev/estado

Hasta dónde está cargado el BORME

El último día con BORME cargado y cuántos días e inscripciones hay en total. Útil para saber si «no hay resultados» significa eso, o que el BORME lleva días sin actualizarse.

Parámetros

Ninguno.

Respuesta

{
  "ultimoDia": "2026-09-30",
  "diasCargados": 4215,
  "inscripciones": 9834201
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.)

curl

curl https://api.jurilia.com/v1/dev/estado \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/estado")

JavaScript

await devApi('/estado')

2. Biblioteca jurídica

La legislación cargada, con el texto consolidado del BOE: artículo por su cita, todas sus redacciones con su vigencia, la ley en la fecha de los hechos y búsqueda por texto. Cada resultado lleva su norma, su versión y el enlace oficial. «Cita o calla»: si no está, la respuesta lo dice; nunca se inventa un artículo.

GET/v1/dev/biblioteca/abreviaturas

Las normas cargadas

Las abreviaturas verificadas con artículos dentro («ET», «LEC», «CC»…), con el título de la norma y cuántos artículos hay. Sólo lo que de verdad está cargado: se cuenta, no se declara. Gratis.

Parámetros

Ninguno.

Respuesta

{
  "abreviaturas": [
    { "abreviatura": "ET", "titulo": "…", "orden": "social", "articulos": 0 }
  ]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.)

curl

curl https://api.jurilia.com/v1/dev/biblioteca/abreviaturas \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/biblioteca/abreviaturas")

JavaScript

await devApi('/biblioteca/abreviaturas')
GET/v1/dev/biblioteca/articulo

Un artículo por su cita, a una fecha

Como se cita de verdad: «art. 59.3 ET», «ET 59», «1902 CC». Devuelve el texto vigente en esa fecha con su vigencia y el enlace oficial. Los cuatro desenlaces (`encontrado`, `abreviatura_desconocida`, `articulo_no_esta`, `no_vigente_esa_fecha`) viajan con 200: «no encontrado» es información. Sólo una cita que no se entiende da 400.

Parámetros

  • citastringobligatorio— «art. 59.3 ET», «ET 59», «1902 CC».
  • fechaAAAA-MM-DDopcional— Por defecto, hoy.
  • ordenstringopcional— civil, penal, social o contencioso: desambigua siglas que se repiten.

Respuesta

{
  "desenlace": "encontrado",
  "abreviatura": "ET",
  "articulo": "59",
  "fecha": "2026-01-01",
  "boeId": "BOE-A-…",
  "bloqueId": "…",
  "tituloNorma": "…",
  "tituloBloque": "…",
  "texto": "…",
  "vigenciaDesde": "AAAA-MM-DD",
  "vigenciaHasta": null,
  "urlOficial": "https://www.boe.es/…",
  "aviso": null
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.)

curl

curl "https://api.jurilia.com/v1/dev/biblioteca/articulo?cita=ET+59&fecha=2026-01-01" \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/biblioteca/articulo", cita="ET 59", fecha="2026-01-01")

JavaScript

await devApi('/biblioteca/articulo', { cita: 'ET 59', fecha: '2026-01-01' })
GET/v1/dev/biblioteca/buscar

Buscar artículos por texto

Búsqueda por texto en la legislación cargada, a una fecha, del más al menos relevante. Si no hay nada, la lista va vacía: nunca se inventa un artículo.

Parámetros

  • qstringobligatorio— Entre 3 y 300 caracteres.
  • fechaAAAA-MM-DDopcional— Por defecto, hoy.
  • ordenstringopcional— civil, penal, social o contencioso: acerca los resultados, no filtra.
  • limiteenteroopcional— Entre 1 y 20. Por defecto, 6.

Respuesta

{
  "articulos": [
    {
      "boeId": "BOE-A-…",
      "bloqueId": "…",
      "tituloNorma": "…",
      "abreviatura": "ET",
      "articulo": "56",
      "tituloBloque": "…",
      "texto": "…",
      "vigenciaDesde": "AAAA-MM-DD",
      "vigenciaHasta": null,
      "urlOficial": "https://www.boe.es/…"
    }
  ]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.)

curl

curl "https://api.jurilia.com/v1/dev/biblioteca/buscar?q=despido+improcedente&orden=social" \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/biblioteca/buscar", q="despido improcedente", orden="social")

JavaScript

await devApi('/biblioteca/buscar', { q: 'despido improcedente', orden: 'social' })
GET/v1/dev/biblioteca/versiones

Todas las redacciones de un artículo

De la más antigua a la más reciente, cada una con su vigencia y su fuente, y las incidencias (huecos o solapes) que haya entre ellas. 422 si no se entiende qué artículo se pide.

Parámetros

  • articulostringobligatorio— «art. 2 CP», «ET 59».

Respuesta

{
  "desenlace": "encontrado",
  "abreviatura": "CP",
  "articulo": "2",
  "articuloConVersiones": {
    "boeId": "BOE-A-…",
    "tituloNorma": "…",
    "urlOficial": "https://www.boe.es/…",
    "orden": "penal",
    "versiones": [
      { "numero": 1, "bloqueId": "…", "tituloBloque": "…", "texto": "…",
        "vigenciaDesde": "AAAA-MM-DD", "vigenciaHasta": null, "fuenteUrl": "https://www.boe.es/…" }
    ],
    "incidencias": []
  }
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.) · 422 (No se entiende qué artículo se pide, o un archivo adjunto está dañado, protegido o sin texto: no se cobra.)

curl

curl "https://api.jurilia.com/v1/dev/biblioteca/versiones?articulo=art.+2+CP" \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/biblioteca/versiones", articulo="art. 2 CP")

JavaScript

await devApi('/biblioteca/versiones', { articulo: 'art. 2 CP' })
GET/v1/dev/biblioteca/ley-en-fecha

La ley en la fecha de los hechos

La redacción vigente el día de los hechos y todas las posteriores. En penal avisa de que hay reformas posteriores que valorar (art. 2.2 CP) pero NO decide cuál es más favorable: eso es juicio jurídico y el resultado nace `propuesto`.

Parámetros

  • articulostringobligatorio— «art. 2 CP», «ET 59».
  • fechaHechosAAAA-MM-DDobligatorio— El día de los hechos.
  • fechaReferenciaAAAA-MM-DDobligatorio— La fecha con la que se compara (normalmente, hoy).

Respuesta

{
  "desenlace": "encontrado",
  "abreviatura": "CP",
  "articulo": "…",
  "articuloConVersiones": { "…": "como en /versiones" },
  "enLaFecha": {
    "fechaHechos": "AAAA-MM-DD",
    "fechaReferencia": "AAAA-MM-DD",
    "vigenteEnLosHechos": { "…": "una versión" },
    "posteriores": [],
    "vigenteEnLaReferencia": { "…": "una versión" },
    "aviso": null,
    "estado": "propuesto"
  },
  "fundamento": null
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.) · 422 (No se entiende qué artículo se pide, o un archivo adjunto está dañado, protegido o sin texto: no se cobra.)

curl

curl "https://api.jurilia.com/v1/dev/biblioteca/ley-en-fecha?articulo=ET+59&fechaHechos=2019-05-01&fechaReferencia=2026-10-01" \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/biblioteca/ley-en-fecha", articulo="ET 59", fechaHechos="2019-05-01", fechaReferencia="2026-10-01")

JavaScript

await devApi('/biblioteca/ley-en-fecha', { articulo: 'ET 59', fechaHechos: '2019-05-01', fechaReferencia: '2026-10-01' })

3. Calculadoras y plazos

Las mismas calculadoras que usa la aplicación, expuestas como cálculos puros: se envían los datos del cálculo y se recibe el resultado con su traza, su fundamento y sus supuestos. No se guarda nada y no hay datos de ningún cliente. Los plazos con días hábiles usan los calendarios oficiales cargados y avisan cuando falta un año.

GET/v1/dev/calculadoras

Las calculadoras declaradas

Por cada orden, con su fundamento, el aviso orientativo que hay que enseñar y si ya calcula (`disponible`) o sólo está declarada. Gratis.

Parámetros

Ninguno.

Respuesta

{
  "calculadoras": [
    { "orden": "social", "clave": "social.indemnizacion_despido", "nombre": "…",
      "fundamento": ["art. 56.1 ET"], "disponible": true }
  ]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.)

curl

curl https://api.jurilia.com/v1/dev/calculadoras \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/calculadoras")

JavaScript

await devApi('/calculadoras')
POST/v1/dev/calculadoras/despido

Indemnización por despido (ejemplo de calculadora)

Arts. 56.1 y 53.1 ET y DT 11.ª ET. Devuelve el importe en céntimos con su traza, su fundamento y los supuestos que se han tomado. 409 con despidos anteriores al 13-11-2015: el régimen aplicable estaría en el ET de 1995 y ese texto no se ha contrastado. Todas las calculadoras funcionan igual: POST con un cuerpo JSON propio y respuesta con traza. Las demás rutas están en la tabla de debajo; el cuerpo de cada una, en el OpenAPI.

Parámetros

  • antiguedadAAAA-MM-DDobligatorio— Alta en la empresa.
  • extincionAAAA-MM-DDobligatorio— Fecha de extinción.
  • salarioDiarioCentimosenteroobligatorio— Salario regulador diario, en céntimos. Lo decide el abogado.
  • clasestringobligatorio— «improcedente» u «objetivo».
  • fechaContratoAAAA-MM-DDopcional— Si no coincide con la antigüedad (subrogación): decide si entra la DT 11.ª.
  • diasPorMensualidadenteroopcional— Entre 1 y 31. Por defecto, 30.

Respuesta

{
  "tramos": [
    { "etiqueta": "Servicio completo", "desde": "2015-01-01", "hasta": "2026-09-15",
      "meses": 141, "diasPorAnio": 33, "dias": 387.75 }
  ],
  "diasDevengados": 387.75,
  "diasIndemnizables": 387.75,
  "importeCentimos": 3877500,
  "tope": null,
  "preaviso": null,
  "fundamento": ["art. 56.1 ET"],
  "traza": ["Contrato suscrito a partir del 2012-02-12: se aplica sólo el art. 56.1 ET (DT 11.ª.1 ET).", "…"],
  "supuestos": ["El mes incompleto se computa como mes completo …", "…"]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.) · 409 (Falta un dato que decide el cálculo, o el régimen no está verificado: no se cobra.)

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/despido \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{"antiguedad":"2015-01-01","extincion":"2026-09-15","salarioDiarioCentimos":10000,"clase":"improcedente"}'

Python

dev_api_post("/calculadoras/despido", {
    "antiguedad": "2015-01-01", "extincion": "2026-09-15",
    "salarioDiarioCentimos": 10000, "clase": "improcedente",
})

JavaScript

await devApiPost('/calculadoras/despido', {
  antiguedad: '2015-01-01', extincion: '2026-09-15',
  salarioDiarioCentimos: 10000, clase: 'improcedente',
})
GET/v1/dev/plazos/reglas

Las reglas de cómputo de plazos

Las reglas declaradas por orden (`civil`, `penal`, `social`, `contencioso`), incluidas las que todavía no están verificadas contra el texto consolidado, con lo que les falta (`verificado`, `pendiente`): saber que no lo sabemos también es información. Gratis.

Parámetros

  • ordenstringopcional— Un orden; sin él, los cuatro.

Respuesta

{
  "reglas": [
    { "orden": "civil", "tipo": "civil.casacion", "etiqueta": "Recurso de casación",
      "regimen": "procesal", "unidad": "dias_habiles", "duracion": 20,
      "fundamento": ["art. 479.1 LEC"], "verificado": true }
  ],
  "modalidadesSociales": ["…"]
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.)

curl

curl "https://api.jurilia.com/v1/dev/plazos/reglas?orden=civil" \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/plazos/reglas", orden="civil")

JavaScript

await devApi('/plazos/reglas', { orden: 'civil' })
POST/v1/dev/plazos/vencimiento

Calcular el vencimiento de un plazo (días hábiles)

Suma la duración de la regla al día de partida con el calendario que corresponda (festivos oficiales de la sede si se indica; agosto y Navidad según el orden y la modalidad). La respuesta trae la traza y los avisos: si falta el calendario de un año lo dice, porque un año sin datos no es un año sin festivos. 409 cuando falta el dato que decide el calendario (`pregunta` dice cuál) o la regla no está verificada: nunca un valor por defecto. 404 si la regla no existe en ese orden.

Parámetros

  • ordenstringobligatorio— civil, penal, social o contencioso.
  • tipostringobligatorio— La clave de la regla, de /plazos/reglas.
  • diesAQuoAAAA-MM-DDobligatorio— Notificación, despido, publicación…
  • sedeDelOrganoobjetoopcional— { territorio?, municipioIne? }: aplica los festivos oficiales de esa sede.
  • festivosDelOrganolistaopcional— Festivos que se añaden a mano.
  • modalidadSocialstringopcional— Social: decide si agosto corre.
  • actuacionUrgentebooleanoopcional— Civil: art. 131.2 LEC.
  • derechosFundamentalesbooleanoopcional— Contencioso: art. 128.2 LJCA.
  • duracionenteroopcional— Si la regla no la trae fijada.

Respuesta

{
  "fechaLimite": "2026-03-30",
  "fechaLimiteGracia": null,
  "traza": [
    "Dies a quo: 2026-03-02 (el plazo empieza a correr el día siguiente).",
    "Régimen: procesal. Duración: 20 dias_habiles.",
    "Suma de 20 días hábiles con el calendario aplicable: 2026-03-30."
  ],
  "fundamento": ["art. 479.1 LEC"],
  "calendario": {
    "nombre": "Procesal, régimen general",
    "fundamento": ["art. 130.2 LEC", "art. 183 LOPJ"],
    "avisos": ["Agosto entero y del 24 de diciembre al 6 de enero son inhábiles (LO 14/2022)."],
    "festivosOficiales": []
  }
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.) · 404 (No está en lo cargado (BORME) o la regla no existe.) · 409 (Falta un dato que decide el cálculo, o el régimen no está verificado: no se cobra.)

curl

curl -X POST https://api.jurilia.com/v1/dev/plazos/vencimiento \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{"orden":"civil","tipo":"civil.casacion","diesAQuo":"2026-03-02"}'

Python

dev_api_post("/plazos/vencimiento", {
    "orden": "civil", "tipo": "civil.casacion", "diesAQuo": "2026-03-02",
})

JavaScript

await devApiPost('/plazos/vencimiento', {
  orden: 'civil', tipo: 'civil.casacion', diesAQuo: '2026-03-02',
})

Todas las calculadoras

Cada una es un POST con su propio cuerpo JSON (ver el OpenAPI) y devuelve el resultado con su traza, su fundamento y sus supuestos. Se cobran igual que cualquier otra consulta de dato.

  • /v1/dev/calculadoras/despido— Indemnización por despido
  • /v1/dev/calculadoras/finiquito— Finiquito (vacaciones, pagas extra, días del mes)
  • /v1/dev/calculadoras/salario-regulador— Salario regulador desde nóminas y convenio
  • /v1/dev/calculadoras/salarios-tramitacion— Salarios de tramitación
  • /v1/dev/calculadoras/interes-mora-salario— Interés por mora en el pago del salario
  • /v1/dev/calculadoras/recargo-cuotas— Recargo por ingreso fuera de plazo de las cuotas
  • /v1/dev/calculadoras/recargo-prestaciones— Recargo de prestaciones por falta de medidas de seguridad
  • /v1/dev/calculadoras/abono-preventiva— Abono de la prisión provisional y de las medidas cautelares (arts. 58 y 59 CP)
  • /v1/dev/calculadoras/limites-cumplimiento— Límites de cumplimiento de las penas de prisión (arts. 75, 76 y 78 CP)
  • /v1/dev/calculadoras/intereses-demora— Intereses de demora (art. 1108 CC, art. 20 LCS, art. 7 Ley 3/2004)
  • /v1/dev/calculadoras/mora-procesal— Interés de la mora procesal
  • /v1/dev/calculadoras/alimentos-ipc— Actualización de la pensión de alimentos por el IPC
  • /v1/dev/calculadoras/baremo— Baremo de accidentes de tráfico
  • /v1/dev/calculadoras/cancelacion-antecedentes— Cancelación de antecedentes penales
  • /v1/dev/calculadoras/condena— Fechas clave de una condena de prisión
  • /v1/dev/calculadoras/prescripcion-pena— Prescripción de la pena impuesta
  • /v1/dev/calculadoras/prescripcion-delito— Prescripción del delito (arts. 131 y 132 CP)
  • /v1/dev/calculadoras/conformidad— Rebaja por conformidad en juicio rápido
  • /v1/dev/calculadoras/determinacion-pena— Determinación de la pena
  • /v1/dev/calculadoras/prision— Límites de la prisión provisional
  • /v1/dev/calculadoras/suspension— Suspensión y sustitución de la pena
  • /v1/dev/calculadoras/silencio— Silencio administrativo
  • /v1/dev/plazos/calendarios-oficiales— Festivos oficiales cargados, con su boletín (gratis)
  • /v1/dev/plazos/municipios— Municipios con calendario local (gratis)

Calculadoras y plazos: el detalle de cada una, del contrato

Estas fichas se generan del contrato OpenAPI de la API (`openapi.dev.v1.json`): los campos, sus tipos, los valores admitidos y las respuestas posibles son exactamente los que la API valida. Los valores del esqueleto de cada cuerpo son de relleno para que veas la forma, no un caso real.

POST/v1/dev/calculadoras/abono-preventiva

Abono de la prisión provisional y de las medidas cautelares

Arts. 58 y 59 CP. Misma naturaleza: abono día por día (art. 58), con la exclusión de lo coincidente con otra causa. Distinta naturaleza: no sale una cifra, sale el margen del art. 59 (de nada a la pena entera) y quién decide. Con `inicioCumplimiento` y una pena de prisión, devuelve además las fechas de la condena ya desplazadas. Traza y supuestos incluidos; el abono lo acuerda el tribunal. Precio: 5 céntimos por llamada servida.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
penaobjetoobligatorio
fechaHechosfecha (AAAA-MM-DD)opcionalDía de los hechos; lo exige el art. 58.3 para el abono de lo sufrido en otra causa.
periodoslista de objetoobligatorio
privacionesEnOtraCausalista de objetoopcional
inicioCumplimientofecha (AAAA-MM-DD)opcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "pena": {
    "naturaleza": "prision"
  },
  "periodos": []
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
porPeriodolista de objetosiempre
diasAbonadosenterosiempreDías que se abonan por el art. 58 CP: el número que se lleva a la liquidación de condena.
diasNoAbonadosenterosiempre
compensacionobjeto o nulosiempreEl margen del art. 59 CP (no es una cifra: decide el tribunal).
duracionPenaobjeto o nulosiempre
penaExtinguidaPorElAbonoverdadero/falsosiempre
condenaobjeto o nulosiempreLas fechas clave de la condena ya desplazadas por el abono.
avisoslista de textosiempre
supuestoslista de textosiempre
fundamentolista de textosiempre
noCalculadolista de textosiempre
trazalista de textosiempre

Respuestas posibles

  • 200 — Cálculo con su traza
  • 400 — Datos no válidos
  • 401 — Falta la clave de API, o no existe, o ha sido revocada
  • 402 — Sin saldo disponible (5 céntimos por llamada; el verificador, 3 por cada 10 citas). La consulta no se sirve ni se cobra.
  • 403 — La clave no admite llamadas desde esta IP, o la cuenta no tiene la identidad verificada
  • 429 — Demasiadas llamadas seguidas con esta clave (Retry-After)

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/abono-preventiva \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "pena": { "naturaleza": "prision" }, "periodos": [] }'
POST/v1/dev/calculadoras/limites-cumplimiento

Límites de cumplimiento de las penas de prisión

Arts. 75, 76 y 78 CP: máximo de cumplimiento efectivo (triple de la más grave, tope absoluto de 20, 25, 30 o 40 años según las letras del art. 76.1, o la suma si no llega), orden de cumplimiento, puerta del art. 78 y fechas si se da el inicio. Cuando hay una prisión permanente revisable no hay límite numérico: se devuelven los mínimos de los arts. 92 y 78 bis. Traza y supuestos incluidos. Precio: 5 céntimos por llamada servida.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
condenaslista de objetoobligatorio
iniciofecha (AAAA-MM-DD)opcionalDía en que empieza a cumplirse el conjunto; con él se devuelven fechas además de duraciones.

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "condenas": []
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
regimentextosiempreuno de: numerico, permanente_revisable
limiteobjeto o nulosiempre
razonDelLimitetexto o nulosiempreuno de: suma, triple, tope
sumaobjetosiempre
masGraveobjeto o nulosiempre
tripleobjeto o nulosiempre
topeobjeto o nulosiempre
topesConcurrenteslista de objetosiempre
recortaverdadero/falsosiempre
puertaDelArt78verdadero/falsosiempre
basesDelComputolista de objetosiempre
ordenDeCumplimientolista de objetosiempre
hitoslista de objetosiempre
minimosPermanenteRevisablelista de objetosiempre
finDelLimitetexto o nulosiempre
trazalista de textosiempre
avisoslista de textosiempre
supuestoslista de textosiempre
fundamentolista de textosiempre
noCalculadolista de textosiempre

Respuestas posibles

  • 200 — Cálculo con su traza
  • 400 — Datos no válidos
  • 401 — Falta la clave de API, o no existe, o ha sido revocada
  • 402 — Sin saldo disponible (5 céntimos por llamada; el verificador, 3 por cada 10 citas). La consulta no se sirve ni se cobra.
  • 403 — La clave no admite llamadas desde esta IP, o la cuenta no tiene la identidad verificada
  • 429 — Demasiadas llamadas seguidas con esta clave (Retry-After)

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/limites-cumplimiento \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "condenas": [] }'
POST/v1/dev/calculadoras/cancelacion-antecedentes

Cancelación de antecedentes penales

art. 136 CP, con la clasificación de penas del art. 33 CP. Devuelve una fecha por pena y la más tardía de todas. Cuando el artículo no resuelve —pena grave impuesta por delito imprudente, pena menos grave sin duración— devuelve `letra: null` y, si procede, las dos lecturas posibles con sus dos fechas. No elige por el abogado.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
penaslista de objetoobligatorio

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "penas": []
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
porPenalista de objetosiempre
cancelableDesdetexto o nulosiempre
avisoslista de textosiempre
fundamentolista de textosiempre

Respuestas posibles

  • 200 — Cálculo con su traza y sus avisos
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/cancelacion-antecedentes \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "penas": [] }'
POST/v1/dev/calculadoras/condena

Fechas clave de una condena de prisión

Mitad, dos tercios, tres cuartos y fin, con el periodo de seguridad del art. 36.2 CP si se declara. Son la fecha MÁS TEMPRANA en que la ley permite plantear cada cosa, no una concesión: el art. 90.1 exige además tercer grado y buena conducta, y los apartados 2 y 3 dicen «podrá». El cuarto de condena no se calcula: sale del Reglamento Penitenciario, que no está verificado.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
iniciofecha (AAAA-MM-DD)obligatorio
duracionobjetoobligatorio
diasAbonadosenteroopcionalmínimo 0; máximo 36500
periodoSeguridadtextoopcionaluno de: no, acordado, obligatorio
primeraCondenaverdadero/falsoopcional
delitoContraLibertadSexualverdadero/falsoopcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "inicio": "2026-01-01",
  "duracion": {}
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
hitoslista de objetosiempre
diasTotalesenterosiempre
avisoslista de textosiempre
supuestoslista de textosiempre
fundamentolista de textosiempre
noCalculadolista de textosiempre

Respuestas posibles

  • 200 — Fechas con sus avisos y supuestos
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/condena \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "inicio": "2026-01-01", "duracion": {} }'
POST/v1/dev/calculadoras/prescripcion-pena

Prescripción de la pena impuesta

arts. 133 y 134 CP. NO es la prescripción del delito, que está en los arts. 131 y 132: se confunden y el plazo no es el mismo. El art. 133 es híbrido —primero tramos por duración de la prisión y de la inhabilitación, y sólo lo que no encaja va por la clase del art. 33—, así que la respuesta incluye SIEMPRE la regla aplicada, literal y citable. Con la prisión permanente revisable devuelve `prescribeEl: null`: el artículo no la contempla.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
naturalezatextoobligatoriouno de: prision, prision_permanente_revisable, multa, multa_proporcional, trabajos_en_beneficio_de_la_comunidad, localizacion_permanente, inhabilitacion_absoluta, inhabilitacion_especial, inhabilitacion_especial_animales, suspension_empleo_o_cargo_publico, privacion_derecho_conducir, privacion_tenencia_armas, privacion_derecho_residir, prohibicion_aproximarse, prohibicion_comunicarse, privacion_patria_potestad
duracionobjetoopcional
sentenciaFirmefecha (AAAA-MM-DD)obligatorio
quebrantamientofecha (AAAA-MM-DD)opcional
suspensioneslista de objetoopcional
claseDeclaradatextoopcionaluno de: grave, menos_grave, leve
delitoImprescriptibleverdadero/falsoopcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "naturaleza": "prision",
  "sentenciaFirme": "2026-01-01"
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
prescribeEltexto o nulosiempre
aniosentero o nulosiempre
reglatexto o nulosiempreuno de: prision_mas_de_20, prision_15_a_20, prision_mas_de_10_menos_de_15, prision_mas_de_5_hasta_10, inhabilitacion_mas_de_10, inhabilitacion_mas_de_6_hasta_10, restantes_graves, menos_graves, leves
clasetexto o nulosiempreuno de: grave, menos_grave, leve
diesAQuotextosiempre
diesAQuoMotivotextosiempre
diasSuspendidosenterosiempre
fundamentotextosiempre
avisoslista de textosiempre
noResueltolista de textosiempre

Respuestas posibles

  • 200 — Fecha con su regla, sus avisos y lo que el artículo no resuelve
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/prescripcion-pena \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "naturaleza": "prision", "sentenciaFirme": "2026-01-01" }'
POST/v1/dev/calculadoras/interes-mora-salario

Interés por mora en el pago del salario

art. 29.3 ET: «El interés por mora en el pago del salario será el diez por ciento de lo adeudado.» El artículo NO dice que ese diez por ciento sea anual, así que `interesCentimos` es el diez por ciento literal y la lectura anual viaja aparte, en `lecturaAnual`, sólo si se dan las dos fechas y con su advertencia dentro. Lo debe el empresario al TRABAJADOR: no confundir con los recargos de la Seguridad Social.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
adeudadoCentimosenteroobligatoriomínimo 0; máximo 100000000000
moraDesdefecha (AAAA-MM-DD)opcional
moraHastafecha (AAAA-MM-DD)opcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "adeudadoCentimos": 0
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
porcentajenúmerosiempre
interesCentimosenterosiempre
adeudadoCentimosenterosiempre
totalCentimosenterosiempre
lecturaAnualobjeto o nulosiempre
fundamentolista de textosiempre
trazalista de textosiempre
supuestoslista de textosiempre
noResuelvelista de textosiempre

Respuestas posibles

  • 200 — El diez por ciento literal, y aparte la lectura anual si procede
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/interes-mora-salario \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "adeudadoCentimos": 0 }'
POST/v1/dev/calculadoras/recargo-cuotas

Recargo por ingreso fuera de plazo de las cuotas

art. 30 LGSS, en la redacción de la Ley 6/2017 vigente desde el 01-01-2018. Cuatro tramos, no un tipo único: 10 % y 20 % si los documentos de cotización del art. 29 se presentaron en plazo (contando MESES NATURALES desde el vencimiento), y 20 % o 35 % si no se presentaron (midiendo contra la terminación del plazo de la reclamación de deuda, no contra el reglamentario). El apartado 2 da un 20 % único a los recursos distintos de cuotas. Devuelve 409 si el vencimiento es anterior al 01-01-2018: la redacción previa no está verificada.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
deudaCentimosenteroobligatoriomínimo 0; máximo 100000000000
clasetextoobligatoriouno de: cuotas, recursos_distintos_de_cuotas
documentostextoopcionaluno de: presentados_en_plazo, no_presentados_en_plazo
vencimientoPlazoReglamentariofecha (AAAA-MM-DD)obligatorio
fechaPagofecha (AAAA-MM-DD)obligatorio
finPlazoReclamacionDeudafecha (AAAA-MM-DD)opcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "deudaCentimos": 0,
  "clase": "cuotas",
  "vencimientoPlazoReglamentario": "2026-01-01",
  "fechaPago": "2026-01-01"
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
puntosnúmerosiempre
recargoCentimosenterosiempre
deudaCentimosenterosiempre
totalCentimosenterosiempre
citatexto o nulosiempre
fundamentolista de textosiempre
trazalista de textosiempre
supuestoslista de textosiempre
noResuelvelista de textosiempre
huecoDelArticulotexto o nulosiempre

Respuestas posibles

  • 200 — Recargo con el subapartado exacto del que sale
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.
  • 409 — Redacción no verificada

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/recargo-cuotas \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "deudaCentimos": 0, "clase": "cuotas", "vencimientoPlazoReglamentario": "2026-01-01", "fechaPago": "2026-01-01" }'
POST/v1/dev/calculadoras/recargo-prestaciones

Recargo de prestaciones por falta de medidas de seguridad

art. 164 LGSS. **Devuelve un RANGO, no un número**: las prestaciones se aumentan «según la gravedad de la falta, de un 30 a un 50 por ciento», y quién sitúa el porcentaje dentro de la horquilla es el órgano competente. `fijadoEnResolucion` sólo se rellena copiando el porcentaje de una resolución que ya lo haya fijado, y un valor fuera del 30–50 % devuelve 400. Las advertencias del art. 164.2 y .3 —recae sobre el empresario, no es asegurable, es compatible con la responsabilidad penal— van en la respuesta y hay que enseñarlas.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
prestacionesCentimosenteroobligatoriomínimo 0; máximo 100000000000
puntosFijadosEnResolucionnúmeroopcionalmínimo 30; máximo 50

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "prestacionesCentimos": 0
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
puntosMinimonúmerosiempre
puntosMaximonúmerosiempre
minimoCentimosenterosiempre
maximoCentimosenterosiempre
fijadoEnResolucionobjeto o nulosiempre
deQueDependetextosiempre
fundamentolista de textosiempre
trazalista de textosiempre
advertenciaslista de textosiempre
supuestoslista de textosiempre
noResuelvelista de textosiempre

Respuestas posibles

  • 200 — El rango, sus advertencias y lo que el artículo no resuelve
  • 400 — Datos no válidos, o porcentaje fuera de la horquilla del artículo
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/recargo-prestaciones \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "prestacionesCentimos": 0 }'
POST/v1/dev/calculadoras/mora-procesal

Interés de la mora procesal

art. 576 LEC: el interés legal del dinero incrementado en dos puntos, desde que la resolución se dicta en primera instancia. Sólo para condenas de cantidad LÍQUIDA, y sólo si no hay pacto ni disposición especial —el propio 576.1 cede ante ellos y entonces esta ruta devuelve `hay_otro_tipo` sin calcular—. Si algún día del periodo no tiene interés legal publicado, el desenlace es `faltan_tipos` y NO se da un total: los tramos que sí tienen tipo se devuelven igualmente, pero sumarlos y presentarlos como los del periodo daría una cifra menor que la real. Mira `cobertura` para distinguir «ese periodo tiene huecos» de «no hay nada descargado». Para calcular sin conexión, pide la serie en `GET /v1/datos-oficiales/interes-legal` y usa `interesDeMoraProcesal` de @iuris/core.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
principalCentimosenteroobligatoriomínimo 0; máximo 100000000000
desdefecha (AAAA-MM-DD)obligatorio
hastafecha (AAAA-MM-DD)obligatorio
hayPactoODisposicionEspecialverdadero/falsoopcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "principalCentimos": 0,
  "desde": "2026-01-01",
  "hasta": "2026-01-01"
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
desenlacetextosiempreuno de: calculado, faltan_tipos, antes_de_la_ley, hay_otro_tipo
principalCentimosenterosiempre
desdetextosiempre
hastatextosiempre
interesCentimosentero o nulosiempre
totalCentimosentero o nulosiempre
diasSinTipoenterosiempre
tramoslista de objetosiempre
coberturaobjetosiempre
fundamentolista de textosiempre
trazalista de textosiempre
supuestoslista de textosiempre
noResuelvelista de textosiempre

Respuestas posibles

  • 200 — El interés con su desglose, o el motivo por el que no se da un total
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/mora-procesal \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "principalCentimos": 0, "desde": "2026-01-01", "hasta": "2026-01-01" }'
POST/v1/dev/calculadoras/alimentos-ipc

Actualización de la pensión de alimentos por el IPC

Actualiza la pensión año a año con la serie oficial del INE y liquida los atrasos. Lo que decide el resultado NO es el índice: es lo que diga la resolución —desde cuándo se actualiza y qué mes de índice se toma—, así que se pregunta en vez de suponerse. Si no se manda `desfaseMeses` se devuelven LAS DOS lecturas con su argumento y `pensionActual` a `null`: no se inventa una media. Devuelve 409 si la serie del INE no llega a un mes que hace falta, o si no hay ninguna descargada: no se interpola ni se usa el mes más próximo. Para calcular sin conexión, pide la serie en `GET /v1/datos-oficiales/ipc`.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
fechaResolucionfecha (AAAA-MM-DD)obligatorio
pensionInicialCentimosenteroobligatoriomínimo 0; máximo 100000000000
criteriotextoobligatoriouno de: anio_natural, aniversario
siBajaElIndicetextoobligatoriouno de: aplicar_la_bajada, mantener_la_pension
hastafecha (AAAA-MM-DD)obligatorio
pagadoMensualCentimosenteroopcionalmínimo 0; máximo 100000000000
desfaseMesestextoopcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "fechaResolucion": "2026-01-01",
  "pensionInicialCentimos": 0,
  "criterio": "anio_natural",
  "siBajaElIndice": "aplicar_la_bajada",
  "hasta": "2026-01-01"
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
lecturaslista de objetosiempre
descartadaslista de objetosiempre
pensionActualCentimosentero o nulosiempre
serieobjetosiempre
fundamentolista de textosiempre
supuestoslista de textosiempre
avisoslista de textosiempre
decisionesDelAbogadolista de textosiempre

Respuestas posibles

  • 200 — Una o dos lecturas, con sus atrasos y la serie utilizada
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.
  • 409 — La serie del IPC no cubre el periodo, o no hay ninguna descargada

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/alimentos-ipc \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "fechaResolucion": "2026-01-01", "pensionInicialCentimos": 0, "criterio": "anio_natural", "siBajaElIndice": "aplicar_la_bajada", "hasta": "2026-01-01" }'
POST/v1/dev/calculadoras/conformidad

Rebaja por conformidad en juicio rápido

art. 801 LECrim, con la suspensión de la pena tras la rebaja (arts. 80 y 81 CP).

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
viatextoobligatoriouno de: juicio_rapido, abreviado, ordinario
penasPrivativasSolicitadaslista de objetoobligatorio
penaDelTipoobjetoopcional
acusacionParticularConstituidaverdadero/falsoobligatorio
fiscalPidioAperturaYAcusoEnElActoverdadero/falsoobligatorio
primerDelitoverdadero/falsoopcional
responsabilidadCivilAtendidaverdadero/falsoopcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "via": "juicio_rapido",
  "penasPrivativasSolicitadas": [],
  "acusacionParticularConstituida": false,
  "fiscalPidioAperturaYAcusoEnElActo": false
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
viatextosiempreuno de: juicio_rapido, abreviado, ordinario
rebajaobjeto o nulosiempre
requisitoslista de objetosiempre
penaSolicitadaobjetosiempre
penaResultanteobjetosiempre
suspensionobjetosiempre
fundamentolista de textosiempre
trazalista de textosiempre
avisoslista de textosiempre
supuestoslista de textosiempre

Respuestas posibles

  • 200 — Cálculo con su traza
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/conformidad \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "via": "juicio_rapido", "penasPrivativasSolicitadas": [], "acusacionParticularConstituida": false, "fiscalPidioAperturaYAcusoEnElActo": false }'
POST/v1/dev/calculadoras/determinacion-pena

Determinación de la pena

arts. 61 a 72 CP: del marco señalado al delito a la pena concreta, paso a paso.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
marcoobjetoobligatorio
gradoPreviotextoopcionaluno de: ninguno, tentativa, complicidad, eximente_incompleta, art_65_3
atenuantesenteroopcionalmínimo 0; máximo 20
agravantesenteroopcionalmínimo 0; máximo 20
atenuanteMuyCualificadaverdadero/falsoopcional
reincidenciaCualificadaverdadero/falsoopcional
fundamentoTrasCompensaciontextoopcionaluno de: ninguno, atenuacion, agravacion
delitoLeveverdadero/falsoopcional
delitoImprudenteverdadero/falsoopcional
personaJuridicaverdadero/falsoopcional
antecedentesDeDelitosLevesverdadero/falsoopcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "marco": {
    "naturaleza": "prision"
  }
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
partidaobjetosiempre
previoslista de objetosiempre
baseobjeto o nulosiempre
reglatexto o nulosiempreuno de: art_66_1_1, art_66_1_2, art_66_1_3, art_66_1_4, art_66_1_6, art_66_1_7, art_66_2
fundamentotextosiempre
resultadoslista de objetosiempre
alternativaslista de objetosiempre
avisoslista de textosiempre
noResueltolista de textosiempre
convenioslista de textosiempre
sustitucionobjeto o nulosiempre

Respuestas posibles

  • 200 — Cálculo con su traza
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/determinacion-pena \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "marco": { "naturaleza": "prision" } }'
POST/v1/dev/calculadoras/prision

Límites de la prisión provisional

art. 504 LECrim. Devuelve siempre el límite NOMINAL: el art. 504.5 excluye del cómputo las dilaciones no imputables a la Administración de Justicia, y eso lo aprecia el tribunal.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
iniciofecha (AAAA-MM-DD)obligatorio
motivotextoobligatoriouno de: ocultacion_de_pruebas, fuga_o_reiteracion
penaSenaladaAniosnúmeroopcionalmayor que 0; máximo 100
diasYaCumplidosenteroopcionalmínimo 0; máximo 36500
conProrrogaverdadero/falsoopcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "inicio": "2026-01-01",
  "motivo": "ocultacion_de_pruebas"
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
limitetextosiempre
mesesBasenúmerosiempre
mesesProrroganúmerosiempre
avisoDosTerciostextosiempre
prorrogaDisponibleMesesnúmerosiempre
fundamentolista de textosiempre
trazalista de textosiempre
avisoslista de textosiempre

Respuestas posibles

  • 200 — Cálculo con su traza
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/prision \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "inicio": "2026-01-01", "motivo": "ocultacion_de_pruebas" }'
POST/v1/dev/calculadoras/suspension

Suspensión y sustitución de la pena

arts. 80 a 89 CP: qué vías de suspensión son examinables, sus requisitos y sus plazos. Sólo información orientativa: la decisión corresponde al tribunal.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
penaslista de objetoobligatorio
computoDesdefecha (AAAA-MM-DD)opcional
acordadaEnSentenciaverdadero/falsoopcional
primeraVeztextoopcionaluno de: si, no, no_consta
responsabilidadCiviltextoopcionaluno de: satisfecha, compromiso_asumido, no_satisfecha, no_procede, no_consta
decomisotextoopcionaluno de: satisfecha, compromiso_asumido, no_satisfecha, no_procede, no_consta
reoHabitualtextoopcionaluno de: si, no, no_consta
enfermedadMuyGravetextoopcionaluno de: si, no, no_consta
otraPenaSuspendidaPorEnfermedadtextoopcionaluno de: si, no, no_consta
dependenciaDeSustanciastextoopcionaluno de: si, no, no_consta
deshabituacionAcreditadatextoopcionaluno de: si, no, no_consta
enTratamientoverdadero/falsoopcional
delitoSobreLaMujerPorLaParejaverdadero/falsoopcional
delitoContraLaLibertadSexualOTrataverdadero/falsoopcional
soloPerseguibleADenunciaOQuerellaverdadero/falsoopcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "penas": []
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
penaslista de objetosiempre
sumaComputablenúmerosiempre
mayorPenaDePrisionnúmero o nulosiempre
viaslista de objetosiempre
viasNoExaminadaslista de objetosiempre
loQueDecideElJuezlista de textosiempre
huecoslista de objetosiempre
supuestoslista de textosiempre
avisoslista de textosiempre
fundamentolista de textosiempre
trazalista de textosiempre

Respuestas posibles

  • 200 — Análisis con su traza
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/suspension \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "penas": [] }'
POST/v1/dev/calculadoras/salario-regulador

Salario regulador desde nóminas y convenio

ET y convenio aplicable. Devuelve las dos lecturas del salario diario siempre.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
conceptoslista de objetoobligatorio
pagasProrrateadasEnLaMensualidadverdadero/falsoopcional
periodotextoopcionalhasta 200 caracteres
criteriotextoopcionaluno de: anio-natural, mes-de-treinta-dias
diasDelAniotextoopcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "conceptos": []
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
lineaslista de objetosiempre
baseAnualenterosiempremínimo 0; máximo 100000000000
baseMensualenterosiempremínimo 0; máximo 100000000000
excluidoAnualenterosiempremínimo 0; máximo 100000000000
sinClasificarAnualenterosiempremínimo 0; máximo 100000000000
pendientesDeClasificarlista de textosiempre
lecturaslista de objetosiempre
salarioDiarioentero o nulosiempremínimo 0; máximo 100000000000
criterioElegidotexto o nulosiempreuno de: anio-natural, mes-de-treinta-dias
especieobjeto o nulosiempre
avisoslista de textosiempre
supuestoslista de textosiempre
fundamentolista de textosiempre
trazalista de textosiempre

Respuestas posibles

  • 200 — Cálculo con su traza
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/salario-regulador \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "conceptos": [] }'
POST/v1/dev/calculadoras/salarios-tramitacion

Salarios de tramitación

art. 56 ET, con el reparto con el desempleo (art. 268.5.b LGSS) y el cargo del Estado.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
despidofecha (AAAA-MM-DD)obligatorio
notificacionSentenciafecha (AAAA-MM-DD)obligatorio
salarioDiarioenteroobligatoriomínimo 0; máximo 100000000000
fallotextoobligatoriouno de: improcedente, nulo
opciontextoopcionaluno de: readmision, indemnizacion
representanteLegalOSindicalverdadero/falsoopcional
cierreobjetoopcional
otroEmpleoobjetoopcional
desempleoPercibidoenteroopcionalmínimo 0; máximo 100000000000
reclamacionAlEstadoobjetoopcional
extincionObjetivaverdadero/falsoopcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "despido": "2026-01-01",
  "notificacionSentencia": "2026-01-01",
  "salarioDiario": 0,
  "fallo": "improcedente"
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
procedeverdadero/falsosiempre
motivoNoProcedetexto o nulosiempre
computoobjeto o nulosiempre
lecturaslista de objetosiempre
fundamentolista de textosiempre
supuestoslista de textosiempre
avisoslista de textosiempre

Respuestas posibles

  • 200 — Cálculo con su traza
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/salarios-tramitacion \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "despido": "2026-01-01", "notificacionSentencia": "2026-01-01", "salarioDiario": 0, "fallo": "improcedente" }'
POST/v1/dev/calculadoras/silencio

Silencio administrativo

arts. 21 a 25 LPAC: plazo máximo para resolver, sentido del silencio y recurso.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
iniciotextoobligatoriouno de: solicitud_del_interesado, de_oficio
fechaIniciofecha (AAAA-MM-DD)obligatorio
plazoMaximoobjetoopcional
objetotextoopcionaluno de: ordinario, derecho_de_peticion, dominio_publico_o_servicio_publico, dano_al_medio_ambiente, responsabilidad_patrimonial, impugnacion_o_revision_de_oficio
alzadaContraSilencioDesestimatorioverdadero/falsoopcional
naturalezaDeOficiotextoopcionaluno de: favorable, gravamen_o_sancionador
sentidoSegunLaNormatextoopcionaluno de: estimatorio, desestimatorio
fuenteDelSentidotextoopcional
viaSiguientetextoopcionaluno de: recurso_contencioso, recurso_de_alzada, recurso_de_reposicion, sin_determinar
suspensioneslista de objetoopcional
festivoslista de fecha (AAAA-MM-DD)opcional
derechosFundamentalesverdadero/falsoopcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "inicio": "solicitud_del_interesado",
  "fechaInicio": "2026-01-01"
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
plazoParaResolverobjetosiempre
caducidadobjeto o nulosiempre
sentidotexto o nulosiempreuno de: estimatorio, desestimatorio
sentidoFundamentotextosiempre
reglaGeneraltextosiempre
lecturaslista de objetosiempre
recursoobjeto o nulosiempre
avisoslista de textosiempre
supuestoslista de textosiempre
fundamentolista de textosiempre

Respuestas posibles

  • 200 — Cálculo con su traza
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/silencio \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "inicio": "solicitud_del_interesado", "fechaInicio": "2026-01-01" }'
POST/v1/dev/calculadoras/finiquito

Finiquito (vacaciones, pagas extra, días del mes)

ET y convenio aplicable. Cada concepto lleva su fuente: la ley no fija el criterio de todos.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
antiguedadfecha (AAAA-MM-DD)obligatorio
extincionfecha (AAAA-MM-DD)obligatorio
causatextoobligatoriouno de: despido_improcedente, despido_objetivo, fin_contrato_temporal, muerte_jubilacion_incapacidad_empresario, dimision, otra
baseobjetoobligatorio
diasTrabajadosDelMesenteroopcionalmínimo 0; máximo 31
pagaslista de objetoobligatorio
vacacionesobjetoopcional
salarioReguladorDiarioenteroopcionalmínimo 0; máximo 100000000000
fechaContratofecha (AAAA-MM-DD)opcional
tipoContratoTemporaltextoopcionaluno de: formativo, sustitucion, otro

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "antiguedad": "2026-01-01",
  "extincion": "2026-01-01",
  "causa": "despido_improcedente",
  "base": {
    "modalidad": "mensual",
    "importeMensual": 0
  },
  "pagas": []
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
conceptoslista de objetosiempre
totalobjeto o nulosiempre
sumaDeLoCuantificadoobjetosiempre
sinCuantificarlista de textosiempre
supuestoslista de textosiempre
avisoslista de textosiempre
fundamentolista de textosiempre
trazalista de textosiempre

Respuestas posibles

  • 200 — Liquidación con su traza
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.
  • 409 — Redacción no verificada para esa fecha

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/finiquito \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "antiguedad": "2026-01-01", "extincion": "2026-01-01", "causa": "despido_improcedente", "base": { "modalidad": "mensual", "importeMensual": 0 }, "pagas": [] }'
POST/v1/dev/calculadoras/baremo

Baremo de accidentes de tráfico

TRLRCSCVM. La tabla la elige el art. 40.1 por la fecha del accidente y el año de determinación del importe; si no está cargada, 409 con qué tabla falta.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
secciontextoobligatoriouno de: muerte
fechaAccidentefecha (AAAA-MM-DD)obligatorio
anioDeterminacionenteroobligatoriomínimo 2016; máximo 2100
edadVictimaenteroopcionalmínimo 0; máximo 130. sólo en algunas variantes del cuerpo
perjudicadoslista de objetoopcionalsólo en algunas variantes del cuerpo
diasobjetoopcionalsólo en algunas variantes del cuerpo
puntosenteroopcionalmínimo 0; máximo 100. sólo en algunas variantes del cuerpo
puntosConcurrenteslista de enteroopcionalsólo en algunas variantes del cuerpo
puntosEsteticosenteroopcionalmínimo 0; máximo 50. sólo en algunas variantes del cuerpo
edadenteroopcionalmínimo 0; máximo 130. sólo en algunas variantes del cuerpo

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "seccion": "muerte",
  "fechaAccidente": "2026-01-01",
  "anioDeterminacion": 2016,
  "edadVictima": 0,
  "perjudicados": []
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
secciontextosiempreuno de: muerte, temporales, secuelas
partidaslista de objetoa veces
totalenteroa vecesmínimo 0; máximo 100000000000
tramoslista de objetoa veces
diasTotalesnúmeroa veces
importeDiasenteroa vecesmínimo 0; máximo 100000000000
intervencionesobjeto o nuloa veces
totalMinimoenteroa vecesmínimo 0; máximo 100000000000
totalMaximoenteroa vecesmínimo 0; máximo 100000000000
puntosnúmeroa veces
edadnúmeroa veces
columnaEdadDesdenúmeroa veces
psicofisicoobjeto o nuloa veces
esteticoobjeto o nuloa veces
concurrenciaobjeto o nuloa veces
fundamentolista de textosiempre
trazalista de textosiempre
supuestoslista de textosiempre
procedenciaobjetosiempre
tablaobjetosiempre

Respuestas posibles

  • 200 — Cálculo con su traza
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.
  • 409 — No hay tabla oficial cargada para ese año, o régimen anterior a 2016 no verificado

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/baremo \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "seccion": "muerte", "fechaAccidente": "2026-01-01", "anioDeterminacion": 2016, "edadVictima": 0, "perjudicados": [] }'
POST/v1/dev/calculadoras/prescripcion-delito

Prescripción del delito (arts. 131 y 132 CP)

NO es la prescripción de la pena ya impuesta (arts. 133 y 134, en /prescripcion-pena): aquí todavía no hay sentencia firme y se pregunta si el delito se puede perseguir. La pena máxima señalada por la ley, la calificación (leve, continuado, permanente…) y las interrupciones las decide el abogado; el programa computa.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
penaslista de objetoobligatorio
delitoLeveverdadero/falsoopcional
injuriasOCalumniasverdadero/falsoopcional
imprescriptibleverdadero/falsoopcional
modalidadtextoobligatoriouno de: instantaneo, continuado, permanente, habitualidad
fechaDeReferenciafecha (AAAA-MM-DD)obligatorio
victimaMenorobjetoopcional
interrupcioneslista de objetoopcional
hoyfecha (AAAA-MM-DD)opcional

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "penas": [],
  "modalidad": "instantaneo",
  "fechaDeReferencia": "2026-01-01"
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
estadotextosiempreuno de: prescribe, imprescriptible, sin_plazo, interrumpida, en_suspenso
prescribeEltexto o nulosiempre
aniosentero o nulosiempre
tramotexto o nulosiempreuno de: prision_15_o_mas, inhabilitacion_mas_de_10, prision_mas_de_10_menos_de_15, mas_de_5_hasta_10, demas_delitos, leves_injurias_calumnias
fundamentotextosiempre
diesAQuotextosiempre
diesAQuoMotivotextosiempre
yaPrescritoverdadero/falso o nulosiempre
trazalista de textosiempre
avisoslista de textosiempre
noResueltolista de textosiempre

Respuestas posibles

  • 200 — Fecha con su regla, sus avisos y lo que el artículo no resuelve
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/prescripcion-delito \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "penas": [], "modalidad": "instantaneo", "fechaDeReferencia": "2026-01-01" }'
POST/v1/dev/calculadoras/intereses-demora

Intereses de demora (art. 1108 CC, art. 20 LCS, art. 7 Ley 3/2004)

Tres regímenes con acreedor distinto, así que se elige con `regimen` y no se adivina. La serie de tipos legales para el art. 1108 sin pacto y para la LCS es la misma que usa el art. 576 LEC (`GET /v1/datos-oficiales/interes-legal`). Los tipos semestrales de la Ley 3/2004 no están cargados: hay que introducirlos con su referencia, o el desenlace es `faltan_tipos` y no se da un total.

Cuerpo JSON de la petición

CampoTipo¿Obligatorio?Valores y notas
principalCentimosenteroobligatoriomínimo 0
desdefecha (AAAA-MM-DD)obligatorio
hastafecha (AAAA-MM-DD)obligatorio
regimentextoobligatoriouno de: civil_1108
tipoPactadoobjetoopcionalsólo en algunas variantes del cuerpo
fechaSiniestrofecha (AAAA-MM-DD)opcionalsólo en algunas variantes del cuerpo
tiposSemestraleslista de objetoopcionalsólo en algunas variantes del cuerpo
costesDeCobroverdadero/falsoopcionalsólo en algunas variantes del cuerpo

Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)

{
  "principalCentimos": 0,
  "desde": "2026-01-01",
  "hasta": "2026-01-01",
  "regimen": "civil_1108"
}

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
desenlacetextosiempreuno de: calculado, faltan_tipos, antes_de_la_ley
regimentextosiempreuno de: civil_1108, seguro_lcs, comercial_3_2004
principalCentimosenterosiempre
desdetextosiempre
hastatextosiempre
tramoslista de objetosiempre
interesCentimosentero o nulosiempre
totalCentimosentero o nulosiempre
costesDeCobroCentimosentero o nulosiempre
diasSinTipoenterosiempre
fundamentolista de textosiempre
trazalista de textosiempre
supuestoslista de textosiempre
noResuelvelista de textosiempre

Respuestas posibles

  • 200 — El interés con su desglose, o el motivo por el que no se da un total
  • 400 — Datos no válidos
  • 401 — Sin autenticar
  • 402 — Sin saldo disponible: recarga tu saldo. La consulta no se sirve ni se cobra.

curl

curl -X POST https://api.jurilia.com/v1/dev/calculadoras/intereses-demora \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{ "principalCentimos": 0, "desde": "2026-01-01", "hasta": "2026-01-01", "regimen": "civil_1108" }'
GET/v1/dev/plazos/calendarios-oficiales

Festivos oficiales cargados, con su fuente

Las filas de `calendarios_habiles` de los años pedidos: las nacionales y autonómicas enteras, y las locales de los municipios pedidos en `municipios` (D-343). Con ellas el móvil calcula sin conexión con `@iuris/core`. Un año que no aparece no está cargado: no es un año sin festivos.

Parámetros de la URL

CampoTipo¿Obligatorio?Valores y notas
desdeenteroobligatoriomínimo 2000; máximo 2100
hastaenteroobligatoriomínimo 2000; máximo 2100
municipiostextoopcionalpatrón ^\d{5}(,\d{5}){0,19}$

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
calendarioslista de objetosiempre
municipioslista de objetosiempre

Respuestas posibles

  • 200 — Calendarios
  • 400 — Rango no válido
  • 401 — Sin autenticar

curl

curl "https://api.jurilia.com/v1/dev/plazos/calendarios-oficiales" \
  -H "Authorization: Bearer TU_CLAVE"
GET/v1/dev/plazos/municipios

Buscar el municipio de la sede del órgano

Busca entre los 8.132 municipios del INE (a 1-1-2026) por su nombre, en cualquiera de sus lenguas y con o sin artículo, o por su código. Devuelve como mucho 20, con su provincia, su comunidad y el territorio de festivos (la isla en Canarias, Arán en Cataluña).

Parámetros de la URL

CampoTipo¿Obligatorio?Valores y notas
qtextoobligatorioal menos 2 caracteres; hasta 80 caracteres

Campos de la respuesta (200)

CampoTipo¿Obligatorio?Valores y notas
municipioslista de objetosiempre

Respuestas posibles

  • 200 — Municipios
  • 400 — Búsqueda no válida
  • 401 — Sin autenticar

curl

curl "https://api.jurilia.com/v1/dev/plazos/municipios" \
  -H "Authorization: Bearer TU_CLAVE"

5. Tu cuenta: el saldo

Cuánto saldo tienes, cuánto está reservado y cuánto te queda disponible. Gratis y sin gastar saldo.

GET/v1/dev/saldo

Consultar el saldo

Devuelve el saldo de prepago de tu cuenta de desarrollador, lo reservado por consultas en curso, y lo disponible. Es gratis: no consume saldo, y cuenta para el límite de peticiones por minuto.

Parámetros

Ninguno.

Respuesta

{
  "saldoCentimos": 1000,
  "reservadoCentimos": 0,
  "disponibleCentimos": 1000
}

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.)

curl

curl https://api.jurilia.com/v1/dev/saldo \
  -H "Authorization: Bearer TU_CLAVE"

Python

dev_api("/saldo")

JavaScript

await devApi('/saldo')

4. Asistente jurídico

Una pregunta jurídica con respuesta citada y verificada, sólo con la biblioteca pública. No admite expedientes ni documentos: la petición con cualquier campo de más se rechaza. Lo que se escribe se seudonimiza antes de llegar al modelo. La respuesta nace «propuesto»: no es asesoramiento hasta que la valide un abogado.

POST/v1/dev/asistente

Preguntar al asistente jurídico

Contesta una pregunta jurídica SÓLO con la biblioteca pública, citando artículo, norma y versión, y verifica cada cita (`verificacion`: verde, ámbar o rojo). Si no hay fuente, `desenlace: "sin_fuentes"`: no contesta de memoria. Sólo responde en modo rápido. Se cobra POR TOKEN, sin cuota fija (22 € por millón de tokens de entrada, 2,20 € de entrada en caché y 110 € de salida y de razonamiento; mínimo 1 céntimo, hacia arriba): antes de llamar al modelo se reserva el precio máximo (los tokens de entrada y el tope de salida; 402 si el saldo no alcanza) y después se cobra sólo lo consumido, nunca más que lo reservado; si falla, no se cobra nada. La respuesta dice los tokens de cada tipo, el precio aplicado y el total (`facturacion`). La respuesta nace `estado: "propuesto"` y lleva el aviso de que la ha generado una IA. También admite ARCHIVOS adjuntos (PDF, Word .docx, JPEG o PNG) en una petición `multipart/form-data` con los campos `pregunta` y `ficheros[]`: se leen en memoria y no se guardan; ver la guía «Preguntar sobre un documento». Con archivos, el cuerpo de la tarjeta (JSON) no cambia: los archivos van en el multipart.

Parámetros

  • preguntastringobligatorio— Entre 3 y 2.000 caracteres.
  • ocultarlista de textosopcional— Nombres o direcciones que se tapan además de lo que se reconoce solo (hasta 50). Útil con archivos: un nombre sin «D.», «doña» o «contra» no se reconoce por su forma.
  • fechaAAAA-MM-DDopcional— Fecha a la que se consulta la ley. Por defecto, hoy.
  • ordenstringopcional— civil, penal, social o contencioso: acerca la búsqueda.
  • maxCosteCentimosenteroopcional— Tope de gasto en céntimos: si el peor caso que hay que reservar lo supera, 402 sin llamar al modelo ni cobrar.

Respuesta

{
  "desenlace": "respondido",
  "texto": "…respuesta con sus citas…",
  "fuentes": [
    { "boeId": "BOE-A-…", "bloqueId": "…", "tituloNorma": "…", "abreviatura": "ET",
      "articulo": "59", "tituloBloque": "…", "vigenciaDesde": "AAAA-MM-DD",
      "vigenciaHasta": null, "urlOficial": "https://www.boe.es/…" }
  ],
  "verificacion": {
    "resultado": "verde", "verdes": 1, "ambares": 0, "rojas": 0,
    "citas": [{ "referencia": "ET:59.2", "resultado": "verde", "motivo": "…", "fuenteUrl": "https://www.boe.es/…" }]
  },
  "truncado": false,
  "estado": "propuesto",
  "aviso": "Respuesta generada por inteligencia artificial … debe validarla un abogado antes de usarla.",
  "cobradoCentimos": 3,
  "saldoCentimos": 9997,
  "facturacion": { "cobradoCentimos": 3, "saldoRestanteCentimos": 9997, "ocrCentimos": 0 },
  "documentos": null  // con archivos: { "ficheros": 1, "paginas": 12, "paginasLeidasConOcr": 0, "caracteresEnviados": 21840, "recortado": false }
}  // cabeceras: X-Jurilia-Coste-Centimos, X-Jurilia-Saldo-Centimos

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.) · 402 (No hay saldo suficiente: recarga tu saldo. La llamada no se sirve ni se cobra.) · 413 (Los archivos adjuntos son demasiado grandes o demasiados: no se lee nada ni se cobra.) · 415 (Un archivo no es PDF, Word (.docx), JPEG ni PNG (se mira su contenido, no su nombre): no se cobra.) · 422 (No se entiende qué artículo se pide, o un archivo adjunto está dañado, protegido o sin texto: no se cobra.) · 502 (El modelo ha fallado: no se cobra nada.) · 503 (El asistente, la lectura de escaneados (OCR) o un proveedor acreditado para documentos no están disponibles ahora: no se cobra nada.)

curl

curl -X POST https://api.jurilia.com/v1/dev/asistente \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{"pregunta":"¿Cuánto tiempo hay para reclamar tras un despido?","orden":"social"}'

Python

dev_api_post("/asistente", {
    "pregunta": "¿Cuánto tiempo hay para reclamar tras un despido?", "orden": "social",
})

JavaScript

await devApiPost('/asistente', {
  pregunta: '¿Cuánto tiempo hay para reclamar tras un despido?', orden: 'social',
})
POST/v1/dev/preguntar

Pregúntale a Jurilia

La pregunta jurídica con la misma garantía que la aplicación: cita o calla. Contesta SÓLO con la biblioteca del BOE; cada afirmación va con su norma, su artículo y su versión vigente (`fuentes`), las citas se comprueban con el verificador de citas (`verificacion`) y, si no hay fuente, `encontrado` es `false`: no se afirma nada. La contesta Jurilia AI Lex y nace `estado: "propuesto"`. Es el mismo servicio que `/v1/dev/asistente`, con el mismo precio por token (22 € por millón de entrada, 2,20 € de entrada en caché y 110 € de salida y de razonamiento; mínimo 1 céntimo), la misma reserva del peor caso antes de consultar (402 si el saldo no alcanza o supera tu `maxCosteCentimos`) y cobro solo de un 2xx; solo JSON, sin archivos. Con una clave `iuris_test_…` devuelve una respuesta ficticia sin cobrar. Admite `?estimar=1`. Ver la guía «Pregúntale a Jurilia (respuesta citada)».

Parámetros

  • preguntastringobligatorio— Entre 3 y 2.000 caracteres.
  • fechaAAAA-MM-DDopcional— Fecha a la que se consulta la ley. Por defecto, hoy.
  • ordenstringopcional— civil, penal, social o contencioso: acerca la búsqueda.
  • maxCosteCentimosenteroopcional— Tope de gasto en céntimos: si el peor caso que hay que reservar lo supera, 402 sin consultar ni cobrar.

Respuesta

{
  "encontrado": true,
  "asistente": "Jurilia AI Lex",
  "desenlace": "respondido",
  "texto": "…respuesta con sus citas…",
  "fuentes": [
    { "boeId": "BOE-A-…", "tituloNorma": "…", "abreviatura": "ET", "articulo": "59",
      "vigenciaDesde": "AAAA-MM-DD", "vigenciaHasta": null, "urlOficial": "https://www.boe.es/…" }
  ],
  "verificacion": { "resultado": "verde", "verdes": 1, "ambares": 0, "rojas": 0, "citas": [ … ] },
  "estado": "propuesto",
  "aviso": "Respuesta generada por inteligencia artificial …",
  "facturacion": { "cobradoCentimos": 3, "saldoRestanteCentimos": 9997, "tokens": { … } }
}  // cabeceras: X-Jurilia-Coste-Centimos, X-Jurilia-Saldo-Centimos

Puede dar también

401 (Falta la clave, o no existe, o ha sido revocada, o no es de una cuenta de desarrollador.) · 403 (La clave no admite llamadas desde esta IP.) · 429 (Demasiadas llamadas seguidas con esta clave.) · 400 (Un parámetro no tiene la forma pedida.) · 402 (No hay saldo suficiente: recarga tu saldo. La llamada no se sirve ni se cobra.) · 502 (El modelo ha fallado: no se cobra nada.) · 503 (El asistente, la lectura de escaneados (OCR) o un proveedor acreditado para documentos no están disponibles ahora: no se cobra nada.)

curl

curl -X POST https://api.jurilia.com/v1/dev/preguntar \
  -H "Authorization: Bearer TU_CLAVE" -H "Content-Type: application/json" \
  -d '{"pregunta":"¿Cuál es el plazo para impugnar un despido?","orden":"social"}'

Python

dev_api_post("/preguntar", {
    "pregunta": "¿Cuál es el plazo para impugnar un despido?", "orden": "social",
})

JavaScript

await devApiPost('/preguntar', {
  pregunta: '¿Cuál es el plazo para impugnar un despido?', orden: 'social',
})

Empieza en 5 minutos

  1. 1. Crea una clave de pruebas en el panel (Claves de API, «Clave de pruebas»). Empieza por `iuris_test_`: devuelve datos ficticios con la forma exacta de los reales y no cobra.

    export JURILIA_API_KEY=iuris_test_xxxxxxxxxxxxxxxx
  2. 2. Encuentra una empresa a partir de lo que tengas: un nombre, un NIF, una hoja registral o la dirección de su ficha.

    curl "https://api.jurilia.com/v1/dev/empresas/resolver?q=Panader%C3%ADa%20L%C3%B3pez%20S.L." \
      -H "Authorization: Bearer $JURILIA_API_KEY"
  3. 3. Pide la ficha y varias partes en una sola llamada, y sólo los campos que necesitas.

    curl "https://api.jurilia.com/v1/dev/empresas/12345?incluir=red,cronologia,licitaciones&campos=denominacion,incluidos" \
      -H "Authorization: Bearer $JURILIA_API_KEY"
  4. 4. Antes de gastar, mira cuánto costaría (no se ejecuta ni se cobra).

    curl "https://api.jurilia.com/v1/dev/empresas/12345/dossier?estimar=1" \
      -H "Authorization: Bearer $JURILIA_API_KEY"
  5. 5. Que te avisemos en vez de preguntar: crea una suscripción, vigila una sociedad y prueba tu servidor.

    curl -X POST https://api.jurilia.com/v1/dev/avisos/suscripciones \
      -H "Authorization: Bearer $JURILIA_API_KEY" -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{"url":"https://hooks.miempresa.es/jurilia","grupos":["nombramientos","ceses"]}'

Cuando funcione, crea una clave real en el panel, compra saldo y cambia la clave: no hay nada más que cambiar. Las claves de pruebas no cobran y no escriben nada; no valoran el contenido de la petición con el detalle de la real.

Cabeceras y convenciones

Cabecera / parámetroQué hace
X-Request-IdEn toda respuesta. Si mandas uno (de 8 a 100 caracteres) lo devolvemos igual; así puedes correlacionar con tus registros. Va también como id_peticion en los errores.
Content-Type: application/problem+jsonTodo error (RFC 9457): type, title, status, detail, instance, además de codigo, mensaje, sugerencia, documentacion e id_peticion.
RateLimit-Limit, RateLimit-Remaining, RateLimit-ResetTu límite por minuto, lo que te queda y los segundos que faltan para que se reinicie (borrador del IETF). Las X-RateLimit-* de siempre siguen, con el reinicio en segundos Unix. Un 429 trae Retry-After.
ETag / If-None-MatchToda lectura JSON lleva ETag. Si repites la llamada con If-None-Match, un 304 no trae cuerpo y NO se cobra.
X-Coste-Centimos, X-Saldo-Restante-CentimosLo que ha costado la llamada y lo que te queda (también como X-Jurilia-*).
?estimar=1Cuánto costaría la llamada, sin ejecutarla ni cobrarla.
?campos=a,b.cSólo esos campos de la lectura (hasta 20 y 5 niveles); en una lista, de cada elemento. Un campo que no existe se ignora.
?cursor= y ?limite=Paginación: pide la siguiente página con siguienteCursor (o la cabecera X-Jurilia-Siguiente-Cursor). pagina sigue valiendo.
Idempotency-KeyAl crear una suscripción de avisos: repetir la petición con la misma clave devuelve la misma suscripción (200, Idempotent-Replayed: true, sin secreto y sin cobrar).
Deprecation, SunsetSi una ruta va a retirarse: desde cuándo está en desuso y cuándo se retira, con un Link a la guía de migración. Hoy ninguna.
X-Jurilia-Modo: pruebaLa respuesta es de una clave de pruebas: datos ficticios, nada cobrado ni escrito.

Lo que cuesta cada llamada

Se cobra cada llamada servida (un 2xx, o un 404 por un dato público que no está cargado). Una petición inválida, una rechazada por el límite, un fallo nuestro o el 404 de algo tuyo (un caso, una lista o una suscripción que no existen) no se cobran. Gestionar lo tuyo —crear, listar, ver, editar, cerrar y borrar casos, listas, etiquetas, notas y búsquedas— es gratis; lo que consulta el BORME cuesta. La respuesta lleva `X-Jurilia-Coste-Centimos` y `X-Jurilia-Saldo-Centimos`. Precios en céntimos de euro, sin IVA.

ClaseQué incluyePrecio
simpleUna lectura por índice: la ficha, un dato de una fuente, una marca.3 céntimos
cruceUn cruce de varias fuentes o una expansión de la red: vínculos, dinero público, cronología.8 céntimos
grafoUn recorrido del grafo de relaciones entre varias sociedades o personas.15 céntimos
avanceEl avance del dossier: los totales de las veinte secciones de la ficha.15 céntimos
dossierEl dossier profesional en PDF: todas las secciones, el mapa, el render, el cifrado y el código de verificación.250 céntimos
alta_vigiladaPoner una sociedad en una lista vigilada (una sola vez por sociedad y suscripción).15 céntimos
descargaLa descarga de una lista de prospección en Excel o CSV (hasta las filas que fija el servidor).200 céntimos
biblioteca_articuloUn artículo de la biblioteca jurídica por su referencia (o sus versiones, o su redacción a la fecha de los hechos).2 céntimos
biblioteca_busquedaUna búsqueda de artículos en la biblioteca jurídica.3 céntimos
calculadoraUn cálculo de cualquiera de las calculadoras jurídicas, con su fundamento.5 céntimos
plazoEl cómputo de un plazo (días hábiles y festivos de los cuatro órdenes).10 céntimos
prueba_avisoEl aviso de prueba de una suscripción.1 céntimo
loteUn lote: hasta 50 sociedades o nodos del mapa, comprobados uno a uno contra el BORME, que se añaden a un caso o a una lista.30 céntimos
caso_cronologiaLa cronología cruzada de un caso: los hechos publicados de todos sus elementos (hasta 200), cada uno con su fuente.15 céntimos
caso_redEl mapa de conexiones de un caso: la red de sus doce primeros elementos, lista para exportar.30 céntimos
caso_informeEl informe de un caso en PDF: cronología cruzada, resumen de cada sociedad (hasta 30), notas y fuentes, con huella verificable.400 céntimos
busqueda_comprobarVolver a ejecutar una búsqueda guardada y compararla con la vez anterior: quién entra y quién sale.15 céntimos
avisoCada aviso entregado (2xx de tu servidor)5 céntimos

Las listas con páginas aceptan `pagina` o un `cursor` opaco y devuelven `siguienteCursor` y las cabeceras `X-Jurilia-Siguiente-Cursor` y `Link: rel="next"`. Cada dato lleva su `fuente` (el boletín del BORME, con el enlace a su PDF oficial y su fecha de publicación): si no hay fuente, no hay dato. Los nombres vienen como los publica el BORME (en mayúsculas).

`GET /v1/dev/empresas/{empresaId}?incluir=red,cronologia,licitaciones` devuelve la ficha básica y, en `incluidos`, las partes que pidas (hasta ocho), cada una con la forma exacta de su endpoint. Se cobra la suma de las partes menos un 10 %. Cada error trae `codigo`, `mensaje`, `sugerencia` y `documentacion`; una búsqueda sin resultados propone «quizá quisiste decir…» en `quizaQuisisteDecir`.

Encontrar una empresa

Todo lo que una persona puede pegar sobre una empresa, entendido: nombre, NIF, hoja registral, identificador o la dirección de su ficha.

GET/v1/dev/empresas/resolver

Encontrar una empresa a partir de lo que sea: nombre, NIF, hoja registral, identificador o dirección de su ficha

Detecta solo qué has escrito (`tipoDetectado`: `url` de una ficha de empresas.jurilia.com, `id`, `nif`, `hoja` o `nombre`) y devuelve la mejor candidata con su `confianza` (de 0 a 1) y el `motivo`, y otras `alternativas`. Tolera tildes, mayúsculas, la forma social (SL, S.L., Sociedad Limitada) y erratas leves; una errata corregida baja la confianza y se dice. Nunca elige en silencio entre dos sociedades con el mismo nombre: la confianza baja y salen las dos. Si no hay resultados, `quizaQuisisteDecir` propone un nombre cercano. Reglas fijas, sin modelo de lenguaje. Un NIF con el dígito de control mal no se adivina: se trata como un nombre. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
qtextosíLo que se busca.. al menos 1 caracteres; hasta 300 caracteres
provinciatextonoNombre o slug de la provincia.. al menos 1 caracteres; hasta 60 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/resolver?q=Panader%C3%ADa+L%C3%B3pez+S.L." \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/resolver",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    params={"q":"Panadería López S.L."},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/resolver");
url.search = new URLSearchParams({"q":"Panadería López S.L."});
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "entrada": {
    "texto": "texto",
    "tipoDetectado": "url",
    "normalizada": "normalizada"
  },
  "mejor": {
    "empresa": {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "provincia": "MADRID",
      "hoja": "M-123456",
      "titular": "sociedad",
      "ultimaPublicacion": "ultimaPublicacion"
    },
    "confianza": 0,
    "motivo": "motivo",
    "motivoCodigo": "url_exacta"
  },
  "alternativas": [
    {
      "empresa": {
        "id": "12345",
        "denominacion": "ACME SERVICIOS SL",
        "provincia": "MADRID",
        "hoja": "M-123456",
        "titular": "sociedad",
        "ultimaPublicacion": "ultimaPublicacion"
      },
      "confianza": 0,
      "motivo": "motivo",
      "motivoCodigo": "url_exacta"
    }
  ],
  "quizaQuisisteDecir": [
    "quizaQuisisteDecir"
  ]
}

La ficha de una sociedad, sección a sección

La ficha de empresas.jurilia.com con un endpoint por sección y cada dato citado a su boletín. Para pedir varias secciones de una vez, usa `incluir=` en la ficha básica.

GET/v1/dev/empresas/{empresaId}/nif

El NIF de la sociedad, con su procedencia

Combina el BORME, la Plataforma de Contratación y la BDNS. Nunca se infiere: si las fuentes discrepan, o otra sociedad reclama el mismo NIF, no se enseña ninguno (`discrepancia`). Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
idiomatextonoIdioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/nif" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/nif",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/nif");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "tipo": "consta",
  "nif": "A58818501",
  "fuente": "borme",
  "fuentes": [
    "borme"
  ],
  "procedencia": "procedencia",
  "citaBorme": {
    "cve": "cve",
    "fecha": "2026-10-22",
    "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
    "fragmento": "fragmento"
  },
  "citaBdns": {
    "codConcesion": "codConcesion",
    "fechaConcesion": "2026-10-22",
    "urlConvocatoria": "https://empresas.jurilia.com/"
  },
  "citasRegistros": [
    {
      "conjuntoId": "conjuntoId",
      "registro": "registro",
      "organismo": "organismo",
      "licencia": "licencia",
      "urlLicencia": "https://empresas.jurilia.com/",
      "urlConjunto": "https://empresas.jurilia.com/",
      "fechaDatos": "2026-10-22"
    }
  ]
}
GET/v1/dev/empresas/{empresaId}/senales

Señales objetivas de la sociedad

Hechos publicados (ceses en bloque, cambios seguidos, concurso…) con los actos citados. Sin puntuación. Por páginas, las más recientes primero. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
cursortextonoCursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/senales" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/senales",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/senales");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "paginacion": {
    "pagina": 1,
    "paginas": 1,
    "total": 1,
    "porPagina": 20
  },
  "senales": [
    {
      "tipo": "tipo",
      "fecha": "2026-10-22",
      "desde": "2026-10-22",
      "cuantos": 0,
      "actos": [
        {
          "fecha": "2026-10-22",
          "tipo": "tipo",
          "fuente": {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        }
      ]
    }
  ],
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/empresas/{empresaId}/datos-objetivos

Datos que conviene mirar de una sociedad

Hechos medibles que constan en el BORME, cada uno con su número, cómo se calcula y su fuente: domicilio compartido, cambios de administrador en doce meses, constitución reciente, capital igual al mínimo legal y años sin anuncios. Nunca dicen qué significan: ni etiquetas, ni puntuaciones, ni colores. Un empresario individual no se perfila. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
idiomatextonoIdioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/datos-objetivos" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/datos-objetivos",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/datos-objetivos");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "resultado": "empresario_individual"
}
GET/v1/dev/empresas/{empresaId}/hechos

Hechos a revisar antes de contratar con la sociedad

Los hechos objetivos que el BORME ha publicado de la sociedad y que suelen preocupar antes de contratar: situación concursal, disolución y extinción, cierre de la hoja, reducción de capital, fusión, escisión, ceses en bloque, cambios seguidos de domicilio o de denominación, cese de auditor… Del más reciente al más antiguo, cada uno con su fecha y su boletín. No hay nota, puntuación, semáforo ni etiqueta. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
cursortextonoCursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/hechos" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/hechos",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/hechos");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "paginacion": {
    "pagina": 1,
    "paginas": 1,
    "total": 1,
    "porPagina": 20
  },
  "hechos": [
    {
      "tipo": "tipo",
      "fecha": "2026-10-22",
      "desde": "2026-10-22",
      "cuantos": 0,
      "administracion": {
        "nombramientos": 0,
        "ceses": 0
      },
      "actos": [
        {
          "fecha": "2026-10-22",
          "tipo": "tipo",
          "fuente": {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        }
      ]
    }
  ],
  "constitucion": {
    "fecha": "2026-10-22",
    "comienzoOperaciones": "2026-10-22",
    "fuente": {
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "numero": 7,
      "fecha": "2026-10-22"
    }
  },
  "cobertura": {
    "desde": "2026-10-22",
    "hasta": "2026-10-22",
    "anios": 0,
    "ventanaDeAdministradores": {
      "desde": "2026-10-22",
      "hasta": "2026-10-22"
    }
  },
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/empresas/{empresaId}/linea-de-tiempo

Línea de tiempo de la sociedad

Los hitos de su vida registral (constitución, administradores, capital, domicilio…) con el boletín. Por páginas. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
cursortextonoCursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/linea-de-tiempo" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/linea-de-tiempo",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/linea-de-tiempo");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "paginacion": {
    "pagina": 1,
    "paginas": 1,
    "total": 1,
    "porPagina": 20
  },
  "recortada": true,
  "hitos": [
    {
      "fecha": "2026-10-22",
      "numero": 7,
      "boletin": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "clases": [
        "clase"
      ],
      "capitalResultanteCentimos": 0,
      "domicilio": "domicilio",
      "denominacion": "ACME SERVICIOS SL"
    }
  ],
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/empresas/{empresaId}/anuncios

Secciones B y C del BORME de la sociedad

Actos de la Sección B y anuncios de la Sección C (convocatorias, cuentas…), paginados, y los NIF que constan en ellos. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
cursortextonoCursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/anuncios" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/anuncios",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/anuncios");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "actosB": {
    "filas": [
      {
        "identificador": "BORME-A-2026-200-28",
        "provincia": "MADRID",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "fecha": "2026-10-22",
        "numero": 7,
        "tipo": "tipo",
        "epigrafe": "epigrafe",
        "denominacion": "ACME SERVICIOS SL",
        "denominacionLegible": "Acme Servicios, S.L.",
        "ejercicio": 0,
        "fechaIndicada": "fechaIndicada",
        "detalle": "detalle"
      }
    ],
    "total": 1,
    "pagina": 1
  },
  "anunciosC": {
    "filas": [
      {
        "cve": "cve",
        "fecha": "2026-10-22",
        "tipo": "tipo",
        "departamento": "departamento",
        "titulo": "titulo",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "paginaInicial": 0,
        "conTexto": true
      }
    ],
    "total": 1,
    "pagina": 1
  },
  "nifsEnAnuncios": [
    {
      "nif": "A58818501",
      "cve": "cve",
      "fecha": "2026-10-22",
      "fragmento": "fragmento",
      "estado": "propuesto",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf"
    }
  ],
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/empresas/{empresaId}/marcas

Marcas de la OEPM de las que la sociedad es titular

Marcas y nombres comerciales de la Oficina Española de Patentes y Marcas cuyo titular es, de forma inequívoca, la sociedad: signo, número, clases de Niza, estado y fechas. Cinco por página. Nunca de personas físicas. Informativo: el Registro de la OEPM manda. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
cursortextonoCursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/marcas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/marcas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/marcas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "marcas": [
    {
      "signo": "signo",
      "numero": "numero",
      "urlOficial": "https://consultas2.oepm.es/ceo/jsp/busqueda/consultaAvanzada.xhtml",
      "modalidad": "M",
      "clases": [
        1
      ],
      "estado": "solicitada",
      "estadoPublicado": "estadoPublicado",
      "fechaEstado": "2026-10-22",
      "fechaSolicitud": "2026-10-22",
      "fechaRegistro": "2026-10-22"
    }
  ],
  "total": 1,
  "pagina": 1,
  "paginas": 1,
  "porPagina": 20,
  "porEstado": {
    "solicitada": 0,
    "concedida": 0,
    "caducada": 0,
    "otro": 0
  },
  "actualizadoEn": "2026-10-22T00:00:00.000Z",
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/empresas/{empresaId}/boe

Los anuncios del BOE y de los boletines autonómicos en que aparece la sociedad

Anuncios y disposiciones del BOE (secciones III, IV, V-B y V-C) y de los boletines autonómicos cargados en que aparece la sociedad, de más reciente a más antiguo, con su tipo y su enlace oficial. Sólo se casa una sociedad de forma inequívoca; aparecer en un anuncio no es una irregularidad. `cobertura` dice hasta qué día se ha revisado cada boletín. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
cursortextonoCursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/boe" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/boe",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/boe");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "paginacion": {
    "pagina": 1,
    "paginas": 1,
    "total": 1,
    "porPagina": 20
  },
  "filas": [
    {
      "identificador": "BORME-A-2026-200-28",
      "fecha": "2026-10-22",
      "seccion": "III",
      "organo": "organo",
      "titulo": "titulo",
      "tipo": "concurso",
      "urlHtml": "https://www.boe.es/diario_boe/txt.php?id=BOE-B-2026-12345",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf"
    }
  ],
  "cobertura": [
    {
      "seccion": "III",
      "desde": "2026-10-22",
      "hasta": "2026-10-22"
    }
  ],
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/empresas/{empresaId}/emisiones

Instalaciones y emisiones declaradas (PRTR) de la sociedad

Los complejos industriales cuya empresa matriz declarada en PRTR-España es la sociedad y, por año y complejo, lo que declaran emitir por contaminante y medio en kg/año. Sin juicios ni ordenaciones por cantidad. Fuente (obligatorio citarla): PRTR-España, Ministerio para la Transición Ecológica y el Reto Demográfico. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
cursortextonoCursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/emisiones" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/emisiones",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/emisiones");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "paginacion": {
    "pagina": 1,
    "paginas": 1,
    "total": 1,
    "porPagina": 20
  },
  "bloques": [
    {
      "codigoPrtr": 1,
      "nombre": "ANA GARCIA LOPEZ",
      "municipio": "municipio",
      "provincia": "MADRID",
      "anyo": 2001,
      "emisiones": [
        {
          "contaminante": "contaminante",
          "medio": "aire",
          "receptor": "receptor",
          "cantidadKg": "cantidadKg",
          "metodo": "M"
        }
      ]
    }
  ],
  "complejos": [
    {
      "codigoPrtr": 1,
      "nombre": "ANA GARCIA LOPEZ",
      "municipio": "municipio",
      "provincia": "MADRID",
      "actividad": "actividad",
      "anyos": {
        "desde": 0,
        "hasta": 0
      }
    }
  ],
  "totalComplejos": 0,
  "cobertura": {
    "desde": 0,
    "hasta": 0,
    "actualizadoEl": "2026-10-22"
  },
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/empresas/{empresaId}/ted

Contratos de la Unión Europea (TED) de la sociedad

Adjudicaciones publicadas en TED en las que la sociedad consta como adjudicataria, de más reciente a más antigua: fecha, comprador, objeto, CPV, importe y enlace oficial. Se casa por el NIF que consta sin ambigüedad en la ficha. Fuente: TED, Diario Oficial de la UE. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
cursortextonoCursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/ted" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/ted",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/ted");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "paginacion": {
    "pagina": 1,
    "paginas": 1,
    "total": 1,
    "porPagina": 20
  },
  "filas": [
    {
      "publicacion": "publicacion",
      "fecha": "2026-10-22",
      "comprador": "comprador",
      "compradorPais": "compradorPais",
      "compradores": 1,
      "objeto": "objeto",
      "cpv": "cpv",
      "importeCentimos": 1250000,
      "moneda": "moneda",
      "adjudicatarios": 1,
      "tamano": "pyme",
      "urlOficial": "https://consultas2.oepm.es/ceo/jsp/busqueda/consultaAvanzada.xhtml"
    }
  ],
  "cobertura": {
    "desde": "2026-10-22",
    "hasta": "2026-10-22"
  },
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/empresas/{empresaId}/cargos-en-fecha

¿Quién era administrador en una fecha?

Los cargos con nombramiento publicado en o antes de la fecha y sin cese anterior; aparte, los que sólo tienen cese en lo cargado. La respuesta dice si la fecha cae antes de lo cargado. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
fechafecha (AAAA-MM-DD)síFecha de calendario, AAAA-MM-DD.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/cargos-en-fecha?fecha=2026-06-30" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/cargos-en-fecha",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    params={"fecha":"2026-06-30"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/cargos-en-fecha");
url.search = new URLSearchParams({"fecha":"2026-06-30"});
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "fecha": "2026-10-22",
  "enLaFecha": [
    {
      "cargo": "Adm. Unico",
      "nombre": "ANA GARCIA LOPEZ",
      "nombreLegible": "Ana García López",
      "desde": {
        "fecha": "2026-10-22",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "hasta": {
        "fecha": "2026-10-22",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "finPor": "extincion",
      "enLiquidacion": true
    }
  ],
  "soloCese": [
    {
      "cargo": "Adm. Unico",
      "nombre": "ANA GARCIA LOPEZ",
      "nombreLegible": "Ana García López",
      "desde": {
        "fecha": "2026-10-22",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "hasta": {
        "fecha": "2026-10-22",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "finPor": "extincion",
      "enLiquidacion": true
    }
  ],
  "anteriorALoCargado": true,
  "incompleto": true,
  "cobertura": {
    "desde": "2026-10-22",
    "hasta": "2026-10-22",
    "diasConBoletin": 0,
    "continua": true
  }
}
GET/v1/dev/empresas/{empresaId}/lei

Código LEI de la sociedad y su matriz

El código LEI (ISO 17442) de la sociedad en el Golden Copy de GLEIF (CC0 1.0) y las matrices que declara. Sólo se casa de forma inequívoca; en la duda, `lei` es `null`. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/lei" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/lei",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/lei");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "lei": {
    "lei": "lei",
    "denominacion": "ACME SERVICIOS SL",
    "estadoLei": "estadoLei",
    "estadoEntidad": "estadoEntidad",
    "autoridadRegistro": "autoridadRegistro",
    "identificadorEnRegistro": "identificadorEnRegistro",
    "fechaActualizacion": "2026-10-22",
    "fechaDatos": "2026-10-22",
    "urlOficial": "https://consultas2.oepm.es/ceo/jsp/busqueda/consultaAvanzada.xhtml",
    "matrizDirecta": {
      "lei": "lei",
      "denominacion": "ACME SERVICIOS SL",
      "pais": "pais",
      "empresaId": "12345"
    },
    "matrizUltima": {
      "lei": "lei",
      "denominacion": "ACME SERVICIOS SL",
      "pais": "pais",
      "empresaId": "12345"
    }
  },
  "fuente": {
    "nombre": "ANA GARCIA LOPEZ",
    "licencia": "licencia",
    "urlLicencia": "https://empresas.jurilia.com/",
    "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf"
  }
}
GET/v1/dev/empresas/{empresaId}/fondos-ue

Fondos de la UE en gestión directa que recibe la sociedad (FTS)

Lo que el Financial Transparency System de la Comisión Europea (CC BY 4.0) publica de la sociedad como beneficiaria, por año y programa, en céntimos. `fuente` trae la atribución que hay que citar. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/fondos-ue" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/fondos-ue",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/fondos-ue");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "fondos": {
    "filas": [
      {
        "anio": 2007,
        "programa": "programa",
        "centimos": 0,
        "compromisos": 1
      }
    ],
    "totalFilas": 1,
    "totalCentimos": 0,
    "anioDesde": 0,
    "anioHasta": 0,
    "ultimoAnioCargado": 0,
    "fechaDatos": "2026-10-22"
  },
  "fuente": {
    "nombre": "ANA GARCIA LOPEZ",
    "licencia": "licencia",
    "urlLicencia": "https://empresas.jurilia.com/",
    "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf"
  }
}
GET/v1/dev/empresas/{empresaId}/registros-cataluna

Inscripciones de la sociedad en los registros de la Generalitat de Catalunya

Cooperativas, centros especiales de empleo, seguridad privada, agentes de seguridad industrial y grupos de interés, con la atribución que exige la licencia. Constar en un registro no indica nada más que estar inscrita. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/registros-cataluna" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/registros-cataluna",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/registros-cataluna");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "inscripciones": [
    {
      "registro": "cooperatives",
      "nombreDelRegistro": "nombreDelRegistro",
      "organismo": "organismo",
      "numero": "numero",
      "fecha": "2026-10-22",
      "denominacionPublicada": "denominacionPublicada",
      "urlConjunto": "https://empresas.jurilia.com/",
      "fechaDatos": "2026-10-22"
    }
  ],
  "fuente": {
    "nombre": "ANA GARCIA LOPEZ",
    "licencia": "licencia",
    "urlLicencia": "https://empresas.jurilia.com/",
    "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf"
  }
}
GET/v1/dev/empresas/{empresaId}/registro-transparencia-ue

Inscripciones de la sociedad en el Registro de Transparencia de la UE

Número de registro, categoría, fechas y tramo de costes anuales que declara. Constar en el Registro no indica nada más que estar inscrita como representante de intereses. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/registro-transparencia-ue" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/registro-transparencia-ue",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/registro-transparencia-ue");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "registros": [
    {
      "codigo": "ABCD-1234",
      "denominacionPublicada": "denominacionPublicada",
      "categoria": "categoria",
      "fechaRegistro": "2026-10-22",
      "fechaActualizacion": "2026-10-22",
      "costes": {
        "desde": "2026-10-22",
        "hasta": "2026-10-22",
        "minCentimos": 0,
        "maxCentimos": 0
      },
      "acreditados": 0,
      "fechaDatos": "2026-10-22"
    }
  ],
  "fuente": {
    "nombre": "ANA GARCIA LOPEZ",
    "licencia": "licencia",
    "urlLicencia": "https://empresas.jurilia.com/",
    "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf"
  }
}
GET/v1/dev/empresas/{empresaId}/vinculos

Sociedades que comparten administradores con ésta

De más a menos nombres en común. «Aparecer en la misma sociedad» no es «conocerse»: son nombres y pueden ser homónimos. Sin auditores. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
cursortextonoCursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/vinculos" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/vinculos",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/vinculos");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "pagina": 1,
  "hayMas": true,
  "homonimos": "posibles",
  "filas": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "personasEnComun": 0,
      "personas": [
        {
          "clave": "clave",
          "slug": "ana-garcia-lopez"
        }
      ],
      "rutaWeb": "rutaWeb"
    }
  ],
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/empresas/{empresaId}/genealogia

Genealogía de la sociedad: traslados, absorciones y sucesiones

Sólo lo que dicen los actos publicados, cada uno con su boletín. Nada se deduce. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
cursortextonoCursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/genealogia" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/genealogia",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/genealogia");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "paginacion": {
    "pagina": 1,
    "paginas": 1,
    "total": 1,
    "porPagina": 20
  },
  "procedeDe": {
    "empresaId": "12345",
    "denominacion": "ACME SERVICIOS SL",
    "denominacionLegible": "Acme Servicios, S.L.",
    "provincia": "MADRID",
    "cambioDeDomicilio": {
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "numero": 7,
      "fecha": "2026-10-22",
      "domicilio": "domicilio"
    },
    "ultimaEnElAnterior": "2026-10-22",
    "primeraEnElNuevo": "2026-10-22",
    "mismoNif": true,
    "rutaWeb": "rutaWeb"
  },
  "trasladadaA": {
    "empresaId": "12345",
    "denominacion": "ACME SERVICIOS SL",
    "denominacionLegible": "Acme Servicios, S.L.",
    "provincia": "MADRID",
    "cambioDeDomicilio": {
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "numero": 7,
      "fecha": "2026-10-22",
      "domicilio": "domicilio"
    },
    "ultimaEnElAnterior": "2026-10-22",
    "primeraEnElNuevo": "2026-10-22",
    "mismoNif": true,
    "rutaWeb": "rutaWeb"
  },
  "absorbidaPor": [
    {
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "numero": 7,
      "fecha": "2026-10-22",
      "empresaId": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "rutaWeb": "rutaWeb"
    }
  ],
  "actos": [
    {
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "numero": 7,
      "fecha": "2026-10-22",
      "tipo": "tipo",
      "detalle": "detalle"
    }
  ],
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/empresas/{empresaId}/dinero-publico

Dinero público de la sociedad: contratos, subvenciones y sanciones de la UE

Adjudicaciones de la Plataforma de Contratación (agregadas y menores aparte), concesiones de la BDNS de los últimos cuatro años (totales por instrumento, nunca una cifra mezclada) y sanciones de la UE validadas por una persona. Un empresario individual no se perfila. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/dinero-publico" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/dinero-publico",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/dinero-publico");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "contratos": {
    "filas": [
      {
        "id": "12345",
        "fichero": "perfiles",
        "fecha": "2026-10-22",
        "organo": "organo",
        "objeto": "objeto",
        "importeCentimos": 1250000,
        "urlAnuncio": "https://empresas.jurilia.com/"
      }
    ],
    "menores": {
      "filas": [
        {
          "id": "12345",
          "fichero": "perfiles",
          "fecha": "2026-10-22",
          "organo": "organo",
          "objeto": "objeto",
          "importeCentimos": 1250000,
          "urlAnuncio": "https://empresas.jurilia.com/"
        }
      ],
      "total": 1,
      "sinImporte": 0,
      "sumaCentimosConocidos": 0
    },
    "total": 1,
    "sinImporte": 0,
    "sumaCentimosConocidos": 0,
    "actualizadoEn": "2026-10-22T00:00:00.000Z"
  },
  "subvenciones": {
    "filas": [
      {
        "id": "12345",
        "codigoConcesion": "codigoConcesion",
        "fecha": "2026-10-22",
        "organo": [
          "organo"
        ],
        "convocatoria": "convocatoria",
        "numeroConvocatoria": "numeroConvocatoria",
        "urlConvocatoria": "https://empresas.jurilia.com/",
        "instrumento": "instrumento",
        "importeCentimos": 1250000,
        "ayudaEquivalenteCentimos": 0,
        "urlBasesReguladoras": "https://empresas.jurilia.com/"
      }
    ],
    "total": 1,
    "totalesPorInstrumento": [
      {
        "instrumento": "instrumento",
        "concesiones": 0,
        "importeCentimos": 1250000,
        "ayudaEquivalenteCentimos": 0
      }
    ],
    "desde": "2026-10-22",
    "actualizadoEn": "2026-10-22T00:00:00.000Z"
  },
  "sancionesUe": [
    {
      "denominacionEnLaLista": "denominacionEnLaLista",
      "acto": "acto",
      "fechaDelActo": "2026-10-22",
      "urlDelActo": "https://empresas.jurilia.com/",
      "fechaDeLaLista": "2026-10-22",
      "revisadaEn": "2026-10-22"
    }
  ]
}
GET/v1/dev/empresas/{empresaId}/comparativa

Cómo está la sociedad frente a su provincia y su sector

Antigüedad, capital y actividad en percentiles de su grupo (de al menos 30 sociedades). Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/comparativa" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/comparativa",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/comparativa");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "provincia": "MADRID",
  "provinciaLegible": "Madrid",
  "forma": "forma",
  "sector": {
    "codigo": "ABCD-1234",
    "titulo": "titulo"
  },
  "calculadoEn": "2026-10-22",
  "actividadDesde": "2026-10-22",
  "filas": [
    {
      "metrica": "antiguedad",
      "ambito": "provincia",
      "valor": 0,
      "lectura": {
        "metrica": "antiguedad",
        "modo": "mas",
        "porcentaje": 0
      },
      "sociedades": 0
    }
  ]
}
GET/v1/dev/empresas/{empresaId}/parecidas

Empresas parecidas, por hechos objetivos en común

Mismo domicilio, mismos administradores o mismo sector. Hechos, nunca una puntuación. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/parecidas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/parecidas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/parecidas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "parecidas": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "rutaWeb": "rutaWeb",
      "razones": [
        {
          "tipo": "domicilio",
          "domicilioPublicadoEn": "2026-10-22"
        }
      ]
    }
  ]
}
GET/v1/dev/empresas/{empresaId}/cronologia

Cronología completa de una sociedad

Todo lo cargado de la sociedad en una sola línea de tiempo, con la fecha y la fuente oficial de cada punto: actos del BORME, contratos públicos, subvenciones, sanciones de la UE confirmadas, anuncios del BOE y de los boletines autonómicos. Filtros: `tipo` (separado por comas), `anio`, `orden` (`reciente` o `antiguo`) y `pagina` (de veinte en veinte). Sólo hechos publicados: nunca una valoración. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
tipotextonoTipo: filtro separado por comas en cronologías y listados; empresa, persona o domicilio en los elementos de un caso.. hasta 400 caracteres
aniotextonoAño (AAAA).. hasta 4 caracteres
ordentextonoreciente (por defecto) o antiguo.. hasta 10 caracteres. por defecto: reciente
paginatextonoNúmero de página, desde 1. Alternativa: cursor.. hasta 6 caracteres. por defecto: 1
cursortextonoCursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/cronologia" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/cronologia",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/cronologia");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "resultado": "empresario_individual"
}
GET/v1/dev/empresas/{empresaId}/ficha

Ficha completa de una sociedad: resumen, datos registrales, cargos y cronología, todo con su cita

El núcleo de la ficha de empresas.jurilia.com. Cada dato lleva su `fuente` (el boletín del BORME, con su enlace al PDF oficial y su fecha de publicación). Los textos que redacta el servidor (`textos`) llegan en el idioma de `idioma` y sólo dicen hechos publicados; los nombres y las cifras no se traducen. Las listas largas van por páginas (`pagina`, `paginaCargosVigentes`, `paginaCargosCesados`, `paginaCapital`, `paginaDomicilios`); `listas` dice cuántas hay. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
idiomatextonoIdioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
paginaCargosVigentesenteronoPágina de la lista de cargos vigentes (20 por página).. mínimo 1; máximo 10000. por defecto: 1
paginaCargosCesadosenteronoPágina de la lista de cargos cesados (20 por página).. mínimo 1; máximo 10000. por defecto: 1
paginaCapitalenteronoPágina del historial de capital (10 por página).. mínimo 1; máximo 10000. por defecto: 1
paginaDomiciliosenteronoPágina del historial de domicilios (10 por página).. mínimo 1; máximo 10000. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/ficha" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/ficha",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/ficha");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "empresa": {
    "id": "12345",
    "denominacion": "ACME SERVICIOS SL",
    "denominacionLegible": "Acme Servicios, S.L.",
    "provincia": "MADRID",
    "provinciaLegible": "Madrid",
    "provinciaSlug": "madrid",
    "hoja": "M-123456",
    "titular": "sociedad",
    "primeraPublicacion": "2026-10-22",
    "ultimaPublicacion": "2026-10-22",
    "concursalPublicadoEn": "2026-10-22",
    "disolucionPublicadaEn": "2026-10-22",
    "extincionPublicadaEn": "2026-10-22",
    "rutaWeb": "rutaWeb"
  },
  "situacion": {
    "situacion": "activa",
    "hito": {
      "tipo": "tipo",
      "fecha": "2026-10-22",
      "numero": 7,
      "fuente": {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22"
      }
    },
    "concursal": {
      "tipo": "tipo",
      "fecha": "2026-10-22",
      "numero": 7,
      "fuente": {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22"
      }
    }
  },
  "constitucion": {
    "identificador": "BORME-A-2026-200-28",
    "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
    "numero": 7,
    "fecha": "2026-10-22",
    "comienzoOperaciones": "comienzoOperaciones",
    "fechaInscripcion": "2026-10-22"
  },
  "objetoSocial": {
    "identificador": "BORME-A-2026-200-28",
    "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
    "numero": 7,
    "fecha": "2026-10-22",
    "objeto": "objeto"
  },
  "datosRegistrales": {
    "identificador": "BORME-A-2026-200-28",
    "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
    "numero": 7,
    "fecha": "2026-10-22",
    "texto": "texto"
  },
  "capitalActual": {
    "identificador": "BORME-A-2026-200-28",
    "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
    "numero": 7,
    "fecha": "2026-10-22",
    "centimos": 0
  },
  "denominaciones": [
    {
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "primera": "2026-10-22",
      "ultima": "2026-10-22",
      "cambio": {
        "nueva": "nueva",
        "fecha": "2026-10-22",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      }
    }
  ],
  "hechos": [
    {
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "numero": 7,
      "fecha": "2026-10-22",
      "tipo": "tipo",
      "detalle": "detalle"
    }
  ],
  "cargos": {
    "vigentes": [
      {
        "cargo": "Adm. Unico",
        "nombre": "ANA GARCIA LOPEZ",
        "nombreLegible": "Ana García López",
        "desde": {
          "fecha": "2026-10-22",
          "fuente": {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        },
        "hasta": {
          "fecha": "2026-10-22",
          "fuente": {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        },
        "finPor": "extincion",
        "enLiquidacion": true
      }
    ],
    "cesados": [
      {
        "cargo": "Adm. Unico",
        "nombre": "ANA GARCIA LOPEZ",
        "nombreLegible": "Ana García López",
        "desde": {
          "fecha": "2026-10-22",
          "fuente": {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        },
        "hasta": {
          "fecha": "2026-10-22",
          "fuente": {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        },
        "finPor": "extincion",
        "enLiquidacion": true
      }
    ],
    "recortados": true
  },
  "capital": [
    {
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "numero": 7,
      "fecha": "2026-10-22",
      "tipo": "tipo",
      "importeCentimos": 1250000,
      "resultanteCentimos": 0
    }
  ],
  "domicilios": [
    {
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "numero": 7,
      "fecha": "2026-10-22",
      "tipo": "tipo",
      "domicilio": "domicilio"
    }
  ],
  "domicilioActual": {
    "identificador": "BORME-A-2026-200-28",
    "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
    "numero": 7,
    "fecha": "2026-10-22",
    "domicilio": "domicilio"
  },
  "inscripciones": [
    {
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "numero": 7,
      "fecha": "2026-10-22",
      "provincia": "MADRID",
      "datosRegistrales": "datosRegistrales",
      "fechaInscripcion": "2026-10-22",
      "actos": [
        {
          "tipo": "tipo",
          "etiqueta": "etiqueta",
          "capitalCentimos": 300000,
          "capitalResultanteCentimos": 0,
          "domicilio": "domicilio",
          "objeto": "objeto",
          "comienzoOperaciones": "comienzoOperaciones",
          "detalle": "detalle",
          "cargos": [
            {
              "cargo": "Adm. Unico",
              "nombre": "ANA GARCIA LOPEZ"
            }
          ]
        }
      ]
    }
  ],
  "paginacion": {
    "pagina": 1,
    "paginas": 1,
    "total": 1
  },
  "ultimaInscripcion": {
    "identificador": "BORME-A-2026-200-28",
    "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
    "numero": 7,
    "fecha": "2026-10-22",
    "actos": [
      {
        "tipo": "tipo",
        "etiqueta": "etiqueta"
      }
    ]
  },
  "listas": {
    "cargosVigentes": {
      "pagina": 1,
      "paginas": 1,
      "total": 1,
      "porPagina": 20
    },
    "cargosCesados": {
      "pagina": 1,
      "paginas": 1,
      "total": 1,
      "porPagina": 20
    },
    "capital": {
      "pagina": 1,
      "paginas": 1,
      "total": 1,
      "porPagina": 20
    },
    "domicilios": {
      "pagina": 1,
      "paginas": 1,
      "total": 1,
      "porPagina": 20
    }
  },
  "enlaceDeudoresAeat": {
    "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
    "publicadoEl": "2026-10-22",
    "disponibleHasta": "2026-10-22"
  },
  "textos": {
    "idioma": "es",
    "resumen": "resumen",
    "respuestaDirecta": {
      "actividad": {
        "texto": "texto",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "administracion": {
        "texto": "texto",
        "cargos": [
          {
            "cargo": "Adm. Unico",
            "nombre": "ANA GARCIA LOPEZ",
            "fuente": {
              "identificador": "BORME-A-2026-200-28",
              "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
              "numero": 7,
              "fecha": "2026-10-22"
            }
          }
        ]
      },
      "constitucion": {
        "texto": "texto",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "domicilio": {
        "texto": "texto",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "capital": {
        "texto": "texto",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      }
    },
    "preguntas": [
      {
        "clave": "administra",
        "pregunta": "pregunta",
        "respuesta": "respuesta",
        "fuentes": [
          {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        ]
      }
    ],
    "dineroPublico": {
      "nif": "A58818501",
      "subvenciones": "subvenciones",
      "contratos": "contratos"
    }
  }
}
GET/v1/dev/empresas/{empresaId}/resumen

Resumen en lenguaje llano de la sociedad

Lo mismo que el resumen y la respuesta directa de la ficha, sin el resto: un párrafo que se puede leer o mostrar tal cual, escrito sólo con hechos publicados en el BORME (nunca una etiqueta ni una valoración) y la última inscripción que lo respalda, con su boletín. Es texto de plantilla, no de un modelo de lenguaje. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
idiomatextonoIdioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/resumen" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/resumen",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/resumen");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "empresaId": "12345",
  "denominacion": "ACME SERVICIOS SL",
  "idioma": "es",
  "resumen": "resumen",
  "respuestaDirecta": {
    "actividad": {
      "texto": "texto",
      "fuente": {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22"
      }
    },
    "administracion": {
      "texto": "texto",
      "cargos": [
        {
          "cargo": "Adm. Unico",
          "nombre": "ANA GARCIA LOPEZ",
          "fuente": {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        }
      ]
    },
    "constitucion": {
      "texto": "texto",
      "fuente": {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22"
      }
    },
    "domicilio": {
      "texto": "texto",
      "fuente": {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22"
      }
    },
    "capital": {
      "texto": "texto",
      "fuente": {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22"
      }
    }
  },
  "ultimaInscripcion": {
    "identificador": "BORME-A-2026-200-28",
    "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
    "numero": 7,
    "fecha": "2026-10-22",
    "actos": [
      {
        "tipo": "tipo",
        "etiqueta": "etiqueta"
      }
    ]
  },
  "soloHechosPublicados": true
}
POST/v1/dev/empresas/{empresaId}/vies

¿Está la sociedad dada de alta como operador intracomunitario? (VIES)

Comprueba a demanda, en el VIES de la Comisión Europea, el número `ES` + NIF de una sociedad cuyo NIF consta sin ambigüedad. `alta`, `no_consta` (no es una irregularidad) o `no_disponible` (no se pudo preguntar; nunca equivale a «no consta»). El resultado se recuerda 24 h. Sólo sociedades. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/empresas/12345/vies" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/empresas/12345/vies",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/vies");
const r = await fetch(url, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "tipo": "alta",
  "numero": "numero",
  "consultadoEn": "2026-10-22T08:00:00.000Z",
  "nombre": "ANA GARCIA LOPEZ",
  "direccion": "direccion",
  "urlConsulta": "https://empresas.jurilia.com/"
}
GET/v1/dev/empresas/{empresaId}/noticias

Noticias que nombran a esa sociedad

Hasta cinco, las más recientes, en el idioma pedido. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
idiomatextonoIdioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/noticias" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/noticias",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/noticias");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "idioma": "es",
  "noticias": [
    {
      "slug": "ana-garcia-lopez",
      "titulo": "titulo",
      "plantilla": "semana-provincia",
      "publicadaEn": "publicadaEn",
      "rutaWeb": "rutaWeb"
    }
  ]
}

Personas (nombres del BORME)

Sólo el hecho publicado, con su cita. El BORME no publica el DNI: un nombre puede ser varias personas, y cada respuesta lo dice (`homonimos`). Nunca una etiqueta ni un juicio.

GET/v1/dev/personas/{slug}/cronologia

Cronología de un nombre de persona del BORME

Cada vez que ese nombre aparece en un acto de una sociedad, con el cargo tal como lo escribió el BORME, la sociedad y el boletín. Mismos filtros que la de una sociedad. El BORME no publica el DNI: un mismo nombre puede ser varias personas (`homonimos: posibles`). Nunca una etiqueta ni un juicio. 404 si no aparece o si ejerció su derecho de oposición o de supresión. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
slugtextosíSlug de un nombre de persona, de una noticia o de un domicilio, tal como lo devuelve la API.. al menos 1 caracteres; hasta 240 caracteres
tipotextonoTipo: filtro separado por comas en cronologías y listados; empresa, persona o domicilio en los elementos de un caso.. hasta 400 caracteres
aniotextonoAño (AAAA).. hasta 4 caracteres
ordentextonoreciente (por defecto) o antiguo.. hasta 10 caracteres. por defecto: reciente
paginatextonoNúmero de página, desde 1. Alternativa: cursor.. hasta 6 caracteres. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/cronologia" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/cronologia",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/cronologia");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "slug": "ana-garcia-lopez",
  "nombre": "ANA GARCIA LOPEZ",
  "nombreLegible": "Ana García López",
  "variantes": [
    "variante"
  ],
  "sociedades": 0,
  "homonimos": "posibles",
  "recortada": true,
  "filtro": {
    "tipos": [
      "constitucion"
    ],
    "anio": 0,
    "orden": "reciente"
  },
  "total": 1,
  "pagina": 1,
  "paginas": 1,
  "porPagina": 20,
  "porTipo": [
    {
      "tipo": "constitucion",
      "n": 0
    }
  ],
  "porAnio": [
    {
      "anio": 0,
      "n": 0
    }
  ],
  "hechos": [
    {
      "clave": "clave",
      "fecha": "2026-10-22",
      "tipo": "constitucion",
      "origen": "borme",
      "acto": "acto",
      "etiquetaPublicada": "etiquetaPublicada",
      "cargo": "Adm. Unico",
      "nombre": "ANA GARCIA LOPEZ",
      "nombreLegible": "Ana García López",
      "sociedad": {
        "id": "12345",
        "denominacion": "ACME SERVICIOS SL",
        "denominacionLegible": "Acme Servicios, S.L.",
        "provincia": "MADRID",
        "provinciaLegible": "Madrid",
        "rutaWeb": "rutaWeb"
      },
      "cita": {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22",
        "provincia": "MADRID",
        "provinciaLegible": "Madrid"
      }
    }
  ],
  "soloHechos": true
}
GET/v1/dev/personas/{slug}/coincidencias

Con quién coincide una persona en sus sociedades

«Figurar en la misma sociedad» no es «coincidir en el tiempo» ni «conocerse»: la respuesta separa los solapes publicados de los que no se tocan y de los que no tienen fechas. De diez en diez (`pagina`); `con` (el slug de una de ellas) abre sólo esa persona con sus sociedades en común. El BORME no publica el DNI: un mismo nombre puede ser varias personas (`homonimos: posibles`). Nunca una etiqueta ni un juicio. 404 si no aparece o si ejerció su derecho de oposición o de supresión. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
slugtextosíSlug de un nombre de persona, de una noticia o de un domicilio, tal como lo devuelve la API.. al menos 1 caracteres; hasta 240 caracteres
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
contextonoSlug de una de las personas que coinciden: abre sólo esa persona con sus sociedades en común.. al menos 1 caracteres; hasta 240 caracteres
paginaSociedadesenteronoPágina de la tabla de sociedades (en común: 10 por página; en la ficha de una persona: 50 filas de cargo por página).. mínimo 1; máximo 10000. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/coincidencias" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/coincidencias",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/coincidencias");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "coincidencias": [
    {
      "slug": "ana-garcia-lopez",
      "nombre": "ANA GARCIA LOPEZ",
      "nombreLegible": "Ana García López",
      "sociedadesEnComun": 0,
      "sociedadesConSolape": 0,
      "ultima": "2026-10-22",
      "rutaWeb": "rutaWeb",
      "sociedades": [
        {
          "empresaId": "12345",
          "denominacion": "ACME SERVICIOS SL",
          "tipo": "solapan",
          "tramos": [
            {
              "desde": "2026-10-22",
              "hasta": "2026-10-22"
            }
          ],
          "ultimaFecha": "2026-10-22",
          "cargosDeLaPersona": [
            "cargosDeLaPersona"
          ],
          "cargosDelOtro": [
            "cargosDelOtro"
          ],
          "anuncios": [
            {
              "fecha": "2026-10-22",
              "numero": 7,
              "fuente": {
                "identificador": "BORME-A-2026-200-28",
                "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
                "numero": 7,
                "fecha": "2026-10-22"
              }
            }
          ]
        }
      ]
    }
  ],
  "totalDePersonas": 0,
  "paginacion": {
    "pagina": 1,
    "paginas": 1,
    "total": 1,
    "porPagina": 20
  },
  "abierta": "abierta",
  "paginacionSociedades": {
    "pagina": 1,
    "paginas": 1,
    "total": 1,
    "porPagina": 20
  },
  "sociedadesMiradas": 0,
  "recortadaPorSociedades": true,
  "lecturaParcial": true,
  "agotada": true,
  "homonimos": "posibles"
}
GET/v1/dev/personas/{slug}/vinculos

Nombres que aparecen en las mismas sociedades que esta persona

De más a menos sociedades en común, sin auditores. Son nombres, no identificaciones. El BORME no publica el DNI: un mismo nombre puede ser varias personas (`homonimos: posibles`). Nunca una etiqueta ni un juicio. 404 si no aparece o si ejerció su derecho de oposición o de supresión. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
slugtextosíSlug de un nombre de persona, de una noticia o de un domicilio, tal como lo devuelve la API.. al menos 1 caracteres; hasta 240 caracteres
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/vinculos" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/vinculos",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/vinculos");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "pagina": 1,
  "hayMas": true,
  "homonimos": "posibles",
  "filas": [
    {
      "slug": "ana-garcia-lopez",
      "nombre": "ANA GARCIA LOPEZ",
      "nombreLegible": "Ana García López",
      "empresasEnComun": 0,
      "empresas": [
        {
          "id": "12345",
          "denominacion": "ACME SERVICIOS SL",
          "rutaWeb": "rutaWeb"
        }
      ],
      "rutaWeb": "rutaWeb"
    }
  ]
}
GET/v1/dev/personas/{slug}/datos-objetivos

Datos que conviene mirar de un nombre de persona del BORME

Cuántos nombramientos se han publicado con ese nombre, en cuántas sociedades y en cuántos años, con su cálculo y sus boletines. `avisoHomonimos` va siempre. El BORME no publica el DNI: un mismo nombre puede ser varias personas (`homonimos: posibles`). Nunca una etiqueta ni un juicio. 404 si no aparece o si ejerció su derecho de oposición o de supresión. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
slugtextosíSlug de un nombre de persona, de una noticia o de un domicilio, tal como lo devuelve la API.. al menos 1 caracteres; hasta 240 caracteres
idiomatextonoIdioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/datos-objetivos" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/datos-objetivos",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/datos-objetivos");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "senales": [
    {
      "clave": "domicilio_compartido",
      "cifra": 0,
      "fecha": "2026-10-22",
      "datos": {
        "desde": "2026-10-22",
        "hasta": "2026-10-22",
        "primera": "2026-10-22",
        "nombramientos": 0,
        "ceses": 0,
        "sociedades": 0,
        "anios": 0,
        "alMenos": 0,
        "forma": "forma"
      },
      "frase": "frase",
      "comoSeCalcula": "comoSeCalcula",
      "fuentes": [
        {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      ],
      "norma": {
        "norma": "norma",
        "articulo": "articulo",
        "apartado": "apartado",
        "version": "version",
        "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "textoLiteral": "textoLiteral"
      },
      "enlace": {
        "rutaWeb": "rutaWeb",
        "texto": "texto"
      }
    }
  ],
  "datosHasta": "2026-10-22",
  "aviso": "aviso",
  "soloHechos": true,
  "resultado": "persona",
  "slug": "ana-garcia-lopez",
  "homonimos": "posibles",
  "avisoHomonimos": "avisoHomonimos"
}
GET/v1/dev/personas/{slug}/ficha

Ficha completa de una persona del BORME: sus sociedades con el cargo y las fechas, y su cronología

Lo mismo que la ficha de la web: sus sociedades, con el cargo y las fechas de cada una, y la cronología de apariciones, todo con su cita. El BORME no publica el DNI: nombres iguales pueden ser personas distintas (`homonimos: posibles`). Nunca una etiqueta ni un juicio. 404 si no aparece o si ejerció su derecho de oposición o de supresión. La tabla de sociedades (`paginaSociedades`, de cincuenta en cincuenta filas de cargo) y la cronología (`paginaCronologia`, de cincuenta en cincuenta) van por páginas: `listas` dice cuántas hay y `totales`, cuántas sociedades y apariciones tiene la persona. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
slugtextosíSlug de un nombre de persona, de una noticia o de un domicilio, tal como lo devuelve la API.. al menos 1 caracteres; hasta 240 caracteres
paginaSociedadesenteronoPágina de la tabla de sociedades (en común: 10 por página; en la ficha de una persona: 50 filas de cargo por página).. mínimo 1; máximo 10000. por defecto: 1
paginaCronologiaenteronoPágina de la cronología de apariciones (50 por página).. mínimo 1; máximo 10000

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/ficha" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/ficha",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/personas/ana-garcia-lopez/ficha");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "slug": "ana-garcia-lopez",
  "nombre": "ANA GARCIA LOPEZ",
  "nombreLegible": "Ana García López",
  "variantes": [
    "variante"
  ],
  "homonimos": "posibles",
  "recortada": true,
  "empresas": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "titular": "sociedad",
      "concursalPublicadoEn": "2026-10-22",
      "disolucionPublicadaEn": "2026-10-22",
      "extincionPublicadaEn": "2026-10-22",
      "cargos": {
        "vigentes": [
          {
            "cargo": "Adm. Unico",
            "nombre": "ANA GARCIA LOPEZ",
            "desde": {
              "fecha": "2026-10-22",
              "fuente": {
                "identificador": "BORME-A-2026-200-28",
                "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
                "numero": 7,
                "fecha": "2026-10-22"
              }
            },
            "hasta": {
              "fecha": "2026-10-22",
              "fuente": {
                "identificador": "BORME-A-2026-200-28",
                "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
                "numero": 7,
                "fecha": "2026-10-22"
              }
            }
          }
        ],
        "cesados": [
          {
            "cargo": "Adm. Unico",
            "nombre": "ANA GARCIA LOPEZ",
            "desde": {
              "fecha": "2026-10-22",
              "fuente": {
                "identificador": "BORME-A-2026-200-28",
                "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
                "numero": 7,
                "fecha": "2026-10-22"
              }
            },
            "hasta": {
              "fecha": "2026-10-22",
              "fuente": {
                "identificador": "BORME-A-2026-200-28",
                "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
                "numero": 7,
                "fecha": "2026-10-22"
              }
            }
          }
        ]
      },
      "otras": [
        {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22",
          "empresaId": "12345",
          "denominacion": "ACME SERVICIOS SL",
          "provincia": "MADRID",
          "tipo": "tipo",
          "cargo": "Adm. Unico",
          "nombre": "ANA GARCIA LOPEZ"
        }
      ],
      "primera": "2026-10-22",
      "ultima": "2026-10-22",
      "rutaWeb": "rutaWeb"
    }
  ],
  "cronologia": [
    {
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "numero": 7,
      "fecha": "2026-10-22",
      "empresaId": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "tipo": "tipo",
      "cargo": "Adm. Unico",
      "nombre": "ANA GARCIA LOPEZ",
      "nombreLegible": "Ana García López"
    }
  ],
  "rutaWeb": "rutaWeb",
  "ultima": {
    "identificador": "BORME-A-2026-200-28",
    "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
    "numero": 7,
    "fecha": "2026-10-22",
    "empresaId": "12345",
    "denominacion": "ACME SERVICIOS SL",
    "denominacionLegible": "Acme Servicios, S.L.",
    "provincia": "MADRID",
    "tipo": "tipo",
    "cargo": "Adm. Unico",
    "nombre": "ANA GARCIA LOPEZ",
    "nombreLegible": "Ana García López"
  },
  "totales": {
    "sociedades": 0,
    "sociedadesVigentes": 0,
    "apariciones": 0
  },
  "listas": {
    "sociedades": {
      "pagina": 1,
      "paginas": 1,
      "total": 1,
      "porPagina": 20
    },
    "cronologia": {
      "pagina": 1,
      "paginas": 1,
      "total": 1,
      "porPagina": 20
    }
  }
}

Red de relaciones

Conexiones sociedad–persona–sociedad con el acto del BORME que prueba cada salto.

GET/v1/dev/red

Los vecinos de un nodo del mapa de conexiones

`nodo` es `e:<id>` (sociedad), `p:<slug>` (persona) o `d:<clave>` (domicilio). Cada vecino lleva lo que lo une al nodo (el cargo o el domicilio compartido) y si es demasiado común para seguir expandiéndolo. 404 si el nodo no existe o es una persona excluida. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
nodotextosíNodo del grafo: e:<id> sociedad, p:<slug> nombre de persona, d:<clave> domicilio.. al menos 3 caracteres; hasta 320 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/red?nodo=e%3A12345" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/red",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    params={"nodo":"e:12345"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/red");
url.search = new URLSearchParams({"nodo":"e:12345"});
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "nodo": {
    "valor": "valor",
    "tipo": "empresa",
    "nombre": "ANA GARCIA LOPEZ",
    "nombreLegible": "Ana García López",
    "provincia": "MADRID",
    "provinciaLegible": "Madrid",
    "extinguida": true,
    "sociedades": 0,
    "sociedadesAcotadas": true,
    "grado": 0,
    "comun": true,
    "rutaWeb": "rutaWeb"
  },
  "vecinos": [
    {
      "valor": "valor",
      "tipo": "empresa",
      "nombre": "ANA GARCIA LOPEZ",
      "nombreLegible": "Ana García López",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "extinguida": true,
      "sociedades": 0,
      "sociedadesAcotadas": true,
      "grado": 0,
      "comun": true,
      "rutaWeb": "rutaWeb",
      "union": {
        "tipo": "cargo",
        "cargo": "Adm. Unico"
      },
      "relaciones": [
        {
          "familia": "administracion",
          "tipo": "tipo",
          "vigente": true,
          "desde": "2026-10-22",
          "hasta": "2026-10-22",
          "cita": {
            "origen": "borme",
            "etiqueta": "etiqueta",
            "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "fecha": "2026-10-22",
            "numero": 7
          }
        }
      ],
      "sentido": "entrante"
    }
  ],
  "total": 1
}
GET/v1/dev/rastro

El camino más corto entre dos sociedades o personas

`a` y `b` son `e:<id>` o `p:<slug>`. Cada paso del camino lleva el boletín que lo prueba. Si no hay camino, lo dice; nunca inventa uno. Se cobra por consulta servida (clase «grafo»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

15 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
atextosíUn extremo: e:<id> o p:<slug>.. al menos 3 caracteres; hasta 320 caracteres
btextosíEl otro extremo: e:<id> o p:<slug>.. al menos 3 caracteres; hasta 320 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/rastro?a=e%3A12345&b=e%3A67890" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/rastro",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    params={"a":"e:12345","b":"e:67890"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/rastro");
url.search = new URLSearchParams({"a":"e:12345","b":"e:67890"});
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "resultado": "no_valido"
}
GET/v1/dev/conexion

¿Cómo están conectados? Hasta tres caminos entre dos sociedades o personas

`a` y `b` son `e:<id>` o `p:<slug>`. El camino más corto y hasta dos alternativas que no comparten ningún nodo intermedio con él, de hasta cinco saltos; cada salto lleva el acto del BORME que lo prueba. Las personas son NOMBRES (el BORME no publica DNI). Los nodos con muchos vecinos no se atraviesan salvo con `nodosGrandes=1`. Una conexión no implica relación personal ni irregularidad: sólo hechos publicados. Se cobra por consulta servida (clase «grafo»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

15 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
atextosíUn extremo: e:<id> o p:<slug>.. al menos 3 caracteres; hasta 320 caracteres
btextosíEl otro extremo: e:<id> o p:<slug>.. al menos 3 caracteres; hasta 320 caracteres
nodosGrandestextono1 para poder atravesar nodos muy comunes (se marcan en la respuesta).. uno de: 0, 1. por defecto: 0

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/conexion?a=e%3A12345&b=e%3A67890" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/conexion",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    params={"a":"e:12345","b":"e:67890"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/conexion");
url.search = new URLSearchParams({"a":"e:12345","b":"e:67890"});
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "resultado": "no_valido"
}
GET/v1/dev/comparar

Comparar de dos a ocho sociedades lado a lado

`ids` son identificadores de sociedad separados por comas. Un id que no existe, repetido o de un empresario individual simplemente no aparece. Nunca un ranking ni una nota. Se cobra por consulta servida (clase «cruce»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idstextosíIdentificadores de sociedad separados por comas (de 2 a 8).. patrón ^\d{1,18}(,\d{1,18}){0,7}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/comparar?ids=12345%2C67890" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/comparar",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    params={"ids":"12345,67890"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/comparar");
url.search = new URLSearchParams({"ids":"12345,67890"});
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "sociedades": [
    {
      "empresaId": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "hoja": "M-123456",
      "situacion": "activa",
      "capital": {
        "centimos": 0,
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "constitucion": {
        "fecha": "2026-10-22",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "domicilio": {
        "domicilio": "domicilio",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "administradoresVigentes": 0,
      "ultimoActo": {
        "tipo": "tipo",
        "etiqueta": "etiqueta",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "senales": [
        {
          "tipo": "tipo",
          "fecha": "2026-10-22",
          "desde": "2026-10-22",
          "cuantos": 0,
          "actos": [
            {
              "fecha": "2026-10-22",
              "tipo": "tipo",
              "fuente": {
                "identificador": "BORME-A-2026-200-28",
                "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
                "numero": 7,
                "fecha": "2026-10-22"
              }
            }
          ]
        }
      ],
      "rutaWeb": "rutaWeb"
    }
  ],
  "minimo": 0,
  "maximo": 0
}
GET/v1/dev/comparar/cronologia

Cronología comparada de 2 a 4 sociedades

Las líneas de tiempo de varias sociedades en columnas por año y las coincidencias entre ellas dichas como hecho (mismo día y boletín, mismo domicilio, mismo nombre en cargos). `e` es la lista como `e:<id>` separada por comas (o `ids` con los números). 404 si no quedan al menos dos sociedades. Se cobra por consulta servida (clase «grafo»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

15 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
etextonoSociedades como e:<id> separadas por comas.. hasta 1000 caracteres
idstextonoIdentificadores de sociedad separados por comas (de 2 a 8).. hasta 1000 caracteres
tipotextonoTipo: filtro separado por comas en cronologías y listados; empresa, persona o domicilio en los elementos de un caso.. hasta 400 caracteres
aniotextonoAño (AAAA).. hasta 4 caracteres
ordentextonoreciente (por defecto) o antiguo.. hasta 10 caracteres. por defecto: reciente
paginatextonoNúmero de página, desde 1. Alternativa: cursor.. hasta 6 caracteres. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/comparar/cronologia" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/comparar/cronologia",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/comparar/cronologia");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "sociedades": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "rutaWeb": "rutaWeb",
      "total": 1,
      "conNif": true,
      "sinFecha": {
        "placsp": 0,
        "sanciones_ue": 0
      },
      "recortadas": [
        "borme"
      ]
    }
  ],
  "filtro": {
    "tipos": [
      "constitucion"
    ],
    "anio": 0,
    "orden": "reciente"
  },
  "total": 1,
  "pagina": 1,
  "paginas": 1,
  "aniosPorPagina": 1,
  "porTipo": [
    {
      "tipo": "constitucion",
      "n": 0
    }
  ],
  "porAnio": [
    {
      "anio": 0,
      "n": 0
    }
  ],
  "anios": [
    {
      "anio": 0,
      "celdas": [
        {
          "sociedadId": "sociedadId",
          "total": 1,
          "restantes": 0,
          "hechos": [
            {
              "clave": "clave",
              "fecha": "2026-10-22",
              "tipo": "constitucion",
              "origen": "borme",
              "acto": "acto",
              "etiquetaPublicada": "etiquetaPublicada",
              "capitalCentimos": 300000,
              "capitalResultanteCentimos": 0,
              "domicilio": "domicilio",
              "objeto": "objeto",
              "comienzoOperaciones": "comienzoOperaciones",
              "detalle": "detalle",
              "cargos": [],
              "cargosOmitidos": 0,
              "datosRegistrales": "datosRegistrales",
              "fechaInscripcion": "2026-10-22",
              "cita": {
                "identificador": "BORME-A-2026-200-28",
                "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
                "numero": 7,
                "fecha": "2026-10-22",
                "provincia": "MADRID",
                "provinciaLegible": "Madrid"
              }
            }
          ]
        }
      ]
    }
  ],
  "coincidencias": {
    "boletin": {
      "total": 1,
      "lista": [
        {
          "identificador": "BORME-A-2026-200-28",
          "fecha": "2026-10-22",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "provincia": "MADRID",
          "provinciaLegible": "Madrid",
          "sociedades": [
            {
              "sociedadId": "sociedadId",
              "numero": 7
            }
          ]
        }
      ]
    },
    "domicilio": {
      "total": 1,
      "lista": [
        {
          "clave": "clave",
          "rutaWeb": "rutaWeb",
          "sociedades": [
            {
              "sociedadId": "sociedadId",
              "texto": "texto",
              "cita": {
                "identificador": "BORME-A-2026-200-28",
                "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
                "numero": 7,
                "fecha": "2026-10-22",
                "provincia": "MADRID",
                "provinciaLegible": "Madrid"
              }
            }
          ]
        }
      ]
    },
    "nombres": {
      "total": 1,
      "lista": [
        {
          "slug": "ana-garcia-lopez",
          "nombre": "ANA GARCIA LOPEZ",
          "homonimos": "posibles",
          "rutaWeb": "rutaWeb",
          "sociedades": [
            {
              "sociedadId": "sociedadId",
              "cargo": "Adm. Unico",
              "cita": {
                "identificador": "BORME-A-2026-200-28",
                "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
                "numero": 7,
                "fecha": "2026-10-22",
                "provincia": "MADRID",
                "provinciaLegible": "Madrid"
              }
            }
          ],
          "sociedadesEnElBorme": 0,
          "sociedadesAcotadas": true,
          "frecuente": true
        }
      ]
    }
  },
  "excluidas": [
    {
      "id": "12345",
      "motivo": "no_encontrada"
    }
  ],
  "conexiones": [
    {
      "a": "a",
      "b": "b",
      "rutaWeb": "rutaWeb"
    }
  ],
  "soloHechos": true
}

Marcas

Marcas españolas por denominación, clase de Niza, estado y titular.

GET/v1/dev/marcas

Buscar marcas de la OEPM por denominación, clase de Niza, estado y tipo

`q` (la denominación, o un número de solicitud como `M1234567`), `modo` (contiene, empieza o exacta), `clase` (1 a 45), `estado` (concedida, solicitada, caducada u otro), `tipo` (M marca, N nombre comercial, R rótulo) y `pagina` (25 por página). Sólo marcas españolas de la OEPM. Que una marca no conste NO dice que esté libre ni que se pueda registrar: manda el Registro de la OEPM. De una persona física sale la marca y nada del titular. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
qtextonoLo que se busca.. hasta 300 caracteres
modotextonoModo de coincidencia o de búsqueda.. hasta 300 caracteres. por defecto: contiene / empresa (según la ruta)
clasetextonoClase de Niza (1 a 45).. hasta 300 caracteres
estadotextonoFiltro por estado: abierto o cerrado en los casos; rojo, ambar o verde en la cartera.. hasta 300 caracteres
tipotextonoTipo: filtro separado por comas en cronologías y listados; empresa, persona o domicilio en los elementos de un caso.. hasta 300 caracteres
paginatextonoNúmero de página, desde 1. Alternativa: cursor.. hasta 300 caracteres. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/marcas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/marcas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/marcas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "resultado": "ok",
  "minimo": 0,
  "ignorados": [
    "ignorado"
  ],
  "total": 1,
  "acotado": true,
  "pagina": 1,
  "paginas": 1,
  "porPagina": 20,
  "actualizadoEn": "2026-10-22T00:00:00.000Z",
  "marcas": [
    {
      "signo": "signo",
      "numero": "numero",
      "urlOficial": "https://consultas2.oepm.es/ceo/jsp/busqueda/consultaAvanzada.xhtml",
      "modalidad": "M",
      "clases": [
        1
      ],
      "estado": "solicitada",
      "estadoPublicado": "estadoPublicado",
      "fechaEstado": "2026-10-22",
      "titular": {
        "tipo": "sociedad",
        "empresaId": "12345",
        "denominacion": "ACME SERVICIOS SL",
        "denominacionLegible": "Acme Servicios, S.L.",
        "provincia": "MADRID",
        "rutaWeb": "rutaWeb"
      }
    }
  ]
}
GET/v1/dev/marcas/{numero}

La ficha de una marca de la OEPM por su número de solicitud

El signo, número, tipo, clases de Niza, estado y fechas, el titular (la ficha de la sociedad o, sin ella, la entidad y su país), las otras marcas del mismo titular y los signos parecidos (una coincidencia de letras, no un juicio sobre si pueden confundirse). De una marca de persona física sale la marca y nada del titular. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
numerotextosíNúmero de solicitud de la marca, por ejemplo M1167553.. patrón ^[A-Za-z][0-9]{5,10}[A-Za-z0-9]{0,6}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/marcas/M1167553" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/marcas/M1167553",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/marcas/M1167553");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "signo": "signo",
  "numero": "numero",
  "rutaWeb": "rutaWeb",
  "urlOficial": "https://consultas2.oepm.es/ceo/jsp/busqueda/consultaAvanzada.xhtml",
  "modalidad": "M",
  "clases": [
    1
  ],
  "estado": "solicitada",
  "estadoPublicado": "estadoPublicado",
  "fechaEstado": "2026-10-22",
  "fechaSolicitud": "2026-10-22",
  "fechaRegistro": "2026-10-22",
  "personaFisica": true,
  "titulares": [
    {
      "tipo": "sociedad",
      "empresaId": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "rutaWeb": "rutaWeb"
    }
  ],
  "actualizadoEn": "2026-10-22T00:00:00.000Z",
  "delMismoTitular": {
    "marcas": [
      {
        "signo": "signo",
        "numero": "numero",
        "rutaWeb": "rutaWeb",
        "modalidad": "M",
        "clases": [
          1
        ],
        "estado": "solicitada",
        "estadoPublicado": "estadoPublicado",
        "fechaEstado": "2026-10-22"
      }
    ],
    "total": 1
  },
  "parecidas": [
    {
      "signo": "signo",
      "numero": "numero",
      "rutaWeb": "rutaWeb",
      "modalidad": "M",
      "clases": [
        1
      ],
      "estado": "solicitada",
      "estadoPublicado": "estadoPublicado",
      "fechaEstado": "2026-10-22"
    }
  ]
}

Dossier (PDF) y verificación

El dossier profesional de una sociedad y la comprobación de que un PDF es auténtico.

GET/v1/dev/empresas/{empresaId}/dossier/avance

Avance del dossier: cuántos datos tiene la sociedad en cada sección

Por cada una de las 20 secciones elegibles del dossier, cuántos datos publicados tiene la sociedad y una frase de qué incluye. Sólo números y frases fijas: ninguna valoración y ningún dato de una persona. Sólo sociedades. Se cobra por consulta servida (clase «avance»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

15 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
idiomatextonoIdioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/12345/dossier/avance" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/dossier/avance",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/dossier/avance");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "empresaId": "12345",
  "idioma": "es",
  "titulo": "titulo",
  "intro": "intro",
  "resumen": "resumen",
  "sinDatos": "sinDatos",
  "conDatos": 0,
  "total": 1,
  "secciones": [
    {
      "seccion": "seccion",
      "etiqueta": "etiqueta",
      "estado": "con-datos",
      "recuento": "recuento",
      "incluye": "incluye"
    }
  ],
  "mapaNiveles": [
    {
      "nivel": "1",
      "etiqueta": "etiqueta",
      "recuento": "recuento"
    }
  ],
  "grupos": [
    {
      "grupo": "registro",
      "titulo": "titulo",
      "intro": "intro",
      "cierre": "cierre",
      "secciones": [
        "seccione"
      ]
    }
  ]
}
GET/v1/dev/empresas/{empresaId}/dossier

Dossier profesional de la sociedad en PDF

El dossier profesional de la sociedad: portada con QR, índice, resumen ejecutivo y las secciones de la ficha con su cita oficial, en el idioma pedido y completo o por secciones (`secciones=`; `red=` elige hasta dónde llega el mapa de conexiones cuando `secciones` incluye `mapa`). Lleva un código único con su QR, una marca de agua y el PDF va cifrado con permisos; su huella SHA-256 queda registrada y se comprueba en `GET /v1/dev/verificar-dossier/{codigo}`. Sin cupo diario: se paga cada dossier. Sólo sociedades: el dossier de un empresario individual sería perfilar a una persona física. La cabecera `x-dossier-codigo` trae el código. Se cobra por consulta servida (clase «dossier»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

250 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$
idiomatextonoIdioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es
seccionestextonoLas secciones del dossier, separadas por comas: identificacion, registrales, cargos, hechos, denominaciones, actos, relacionadas, mapa, contratos, ted, subvenciones, fondos_ue, boe, marcas, lei, cataluna, transparencia, sanciones, comparativa, noticias. El resumen ejecutivo, las fuentes y el aviso legal van siempre. Sin este parámetro, o con todas, el dossier completo.. hasta 300 caracteres. por defecto: todas
redtextonoHasta dónde llega el mapa de conexiones del dossier: 1 (conexiones directas), 2, 3 o completo (hasta donde llegue la red, con topes). Sólo cuenta si secciones incluye mapa; sin secciones (dossier completo) el mapa es siempre el completo. Por defecto, 1.. uno de: 1, 2, 3, completo. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -o salida.pdf "https://api.jurilia.com/v1/dev/empresas/12345/dossier" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/12345/dossier",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
open("salida.pdf", "wb").write(r.content)

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/12345/dossier");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
await (await import("node:fs/promises")).writeFile("salida.pdf", Buffer.from(await r.arrayBuffer()));

Respuesta de ejemplo

Esta ruta devuelve un fichero (PDF, Excel o CSV), no JSON.

GET/v1/dev/verificar-dossier/{codigo}

Verificar un dossier por su código

Lo que Jurilia registró al generar un dossier con ese código: la sociedad, el idioma, las secciones, la fecha y la hora y la huella SHA-256 del fichero. Se calcula el SHA-256 del PDF y se compara con `sha256`. Detecta cualquier cambio; no es una firma electrónica. No dice nada de quien lo descargó. Se cobra por consulta servida (clase «simple»; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
codigotextosíCódigo de verificación impreso en el PDF.. al menos 1 caracteres; hasta 40 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/verificar-dossier/ABCD-1234" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/verificar-dossier/ABCD-1234",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/verificar-dossier/ABCD-1234");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "codigo": "ABCD-1234",
  "empresaId": "12345",
  "denominacion": "ACME SERVICIOS SL",
  "denominacionLegible": "Acme Servicios, S.L.",
  "idioma": "es",
  "secciones": [
    "seccione"
  ],
  "generadoEn": "2026-10-22T08:00:00.000Z",
  "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "tamanoEnBytes": 0
}

Explorar: provincias, sectores, rankings, noticias e informes

Las mismas rutas de la web pública de Empresas, con clave de API en vez de cupo diario.

GET/v1/dev/empresas/portada

Portada: cifras del BORME, últimas novedades y provincias

Lo que enseña la portada de Empresas: cuántas sociedades, cargos, inscripciones y días hay cargados, las últimas constituciones, concursos y disoluciones, y las provincias con su número de empresas. Igual para todos, con caché corta. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Errores y cómo resolverlos

  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/portada" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/portada",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/portada");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "cifras": {
    "sociedades": 0,
    "cargos": 0,
    "inscripciones": 0,
    "dias": 0,
    "ultimoDia": "2026-10-22"
  },
  "novedades": {
    "constitucion": [
      {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22",
        "empresaId": "12345",
        "denominacion": "ACME SERVICIOS SL",
        "denominacionLegible": "Acme Servicios, S.L.",
        "provincia": "MADRID",
        "provinciaLegible": "Madrid",
        "tipo": "tipo",
        "capitalCentimos": 300000,
        "rutaWeb": "rutaWeb"
      }
    ],
    "situacion_concursal": [
      {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22",
        "empresaId": "12345",
        "denominacion": "ACME SERVICIOS SL",
        "denominacionLegible": "Acme Servicios, S.L.",
        "provincia": "MADRID",
        "provinciaLegible": "Madrid",
        "tipo": "tipo",
        "capitalCentimos": 300000,
        "rutaWeb": "rutaWeb"
      }
    ],
    "disolucion": [
      {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22",
        "empresaId": "12345",
        "denominacion": "ACME SERVICIOS SL",
        "denominacionLegible": "Acme Servicios, S.L.",
        "provincia": "MADRID",
        "provinciaLegible": "Madrid",
        "tipo": "tipo",
        "capitalCentimos": 300000,
        "rutaWeb": "rutaWeb"
      }
    ]
  },
  "provincias": [
    {
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "provinciaSlug": "madrid",
      "empresas": 0
    }
  ],
  "tiposDestacados": [
    "tiposDestacado"
  ]
}
GET/v1/dev/empresas/buscar

Buscar empresas (o personas) en el BORME

Entiende un CIF/NIF (pegado de cualquier forma: `A-08000143`, `ES A08000143`, `NIF: A 08.000.143`; sólo con su dígito de control válido), una hoja registral o un nombre. En un nombre ignora tildes, mayúsculas, puntos y comas, la forma jurídica (S.L., S.A., sociedad limitada…) y «en liquidación», y corrige erratas de escritura (`telefnica`, `telefonika`, `espana`): lo corregido se ordena justo después de lo escrito tal cual y, si hace falta, `sugerencia` propone la denominación publicada. Orden: coincidencia exacta, luego sociedades activas con más actividad y, al final, las extinguidas (con su fecha). Con `modo=persona` busca personas por su nombre (dato público del boletín, con homónimos posibles). Menos de tres letras no busca. Los filtros `provincia`, `titular` y `estado` sólo valen en modo empresa. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
qtextosíLo que se busca.. al menos 1 caracteres; hasta 120 caracteres
modotextonoModo de coincidencia o de búsqueda.. uno de: empresa, persona. por defecto: contiene / empresa (según la ruta)
provinciatextonoNombre o slug de la provincia.. al menos 1 caracteres; hasta 60 caracteres
titulartextonoTipo de titular: sociedad o empresario_individual.. uno de: sociedad, empresario_individual
estadotextonoFiltro por estado: abierto o cerrado en los casos; rojo, ambar o verde en la cartera.. uno de: concurso, disolucion, extincion
limiteenteronoMáximo de resultados.. mínimo 1; máximo 50. por defecto: 50 (avisos: entregas) · 100 (eventos) · 20 (búsquedas)

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/buscar?q=Panader%C3%ADa+L%C3%B3pez+S.L." \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/buscar",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    params={"q":"Panadería López S.L."},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/buscar");
url.search = new URLSearchParams({"q":"Panadería López S.L."});
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "modo": "empresa",
  "tipo": "nombre",
  "sugerencia": "sugerencia",
  "empresas": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "provinciaSlug": "madrid",
      "hoja": "M-123456",
      "titular": "sociedad",
      "primeraPublicacion": "2026-10-22",
      "ultimaPublicacion": "2026-10-22",
      "concursalPublicadoEn": "2026-10-22",
      "disolucionPublicadaEn": "2026-10-22",
      "extincionPublicadaEn": "2026-10-22",
      "nombreQueCasa": "nombreQueCasa",
      "cambioDeNombre": {
        "nombreAnterior": "nombreAnterior",
        "fecha": "2026-10-22",
        "fuente": {
          "identificador": "BORME-A-2026-200-28",
          "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
          "numero": 7,
          "fecha": "2026-10-22"
        }
      },
      "rutaWeb": "rutaWeb"
    }
  ],
  "personas": [
    {
      "slug": "ana-garcia-lopez",
      "nombre": "ANA GARCIA LOPEZ",
      "nombreLegible": "Ana García López",
      "empresas": 0,
      "ultimaAparicion": "2026-10-22",
      "homonimos": "posibles",
      "casa": "exacto",
      "rutaWeb": "rutaWeb"
    }
  ],
  "tambienPuedeBuscar": [
    {
      "clase": "municipio",
      "id": "12345",
      "nombre": "ANA GARCIA LOPEZ",
      "provincia": "MADRID",
      "sociedades": 0,
      "rutaWeb": "rutaWeb",
      "extinguida": true,
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L."
    }
  ]
}
GET/v1/dev/empresas/sugerencias

Sugerencias mientras se escribe en el buscador

Hasta ocho empresas cuya denominación empieza por lo escrito (o la sociedad de un CIF, pegado de cualquier forma, o de una hoja registral), con la exacta primero y después las activas con más actividad; si no hay bastantes, completa con las que contienen las palabras y con las que se escriben casi igual (erratas, sin tildes ni eñe). Con `personas=true`, hasta cinco personas; sin ella, además municipios, sectores y domicilios. Menos de dos letras no sugiere. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
qtextosíLo que se busca.. al menos 1 caracteres; hasta 120 caracteres
personastextonotrue para sugerir sólo personas (hasta cinco); sin él, empresas, municipios, sectores y domicilios.. uno de: true, false

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/sugerencias?q=Panader%C3%ADa+L%C3%B3pez+S.L." \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/sugerencias",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    params={"q":"Panadería López S.L."},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/sugerencias");
url.search = new URLSearchParams({"q":"Panadería López S.L."});
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "sugerencias": [
    {
      "tipo": "empresa",
      "id": "12345",
      "nombre": "ANA GARCIA LOPEZ",
      "nombreLegible": "Ana García López",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "sociedades": 0,
      "rutaWeb": "rutaWeb",
      "extinguida": true,
      "valor": "valor",
      "fuenteNif": "borme"
    }
  ]
}
GET/v1/dev/empresas/provincias

Las provincias con su número de empresas

Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/provincias" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/provincias",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/provincias");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "provincias": [
    {
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "provinciaSlug": "madrid",
      "empresas": 0
    }
  ]
}
GET/v1/dev/empresas/provincias/{provincia}

Una provincia: sus empresas, municipios, sectores e iniciales

`provincia` es el trozo de URL que da `GET /provincias` (`provinciaSlug`). Lo último publicado se pagina hasta la página 10; lo demás se recorre por iniciales. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
provinciatextosíNombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres
estadotextonoFiltro por estado: abierto o cerrado en los casos; rojo, ambar o verde en la cartera.. uno de: concurso, disolucion, extincion
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/provincias/madrid" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/provincias/madrid",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/provincias/madrid");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "provincia": {
    "provincia": "MADRID",
    "provinciaLegible": "Madrid",
    "provinciaSlug": "madrid"
  },
  "empresas": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "titular": "sociedad",
      "primeraPublicacion": "2026-10-22",
      "ultimaPublicacion": "2026-10-22",
      "concursalPublicadoEn": "2026-10-22",
      "disolucionPublicadaEn": "2026-10-22",
      "extincionPublicadaEn": "2026-10-22",
      "rutaWeb": "rutaWeb"
    }
  ],
  "pagina": 1,
  "hayMas": true,
  "total": 1,
  "municipios": [
    {
      "slug": "ana-garcia-lopez",
      "nombre": "ANA GARCIA LOPEZ",
      "empresas": 0,
      "ultimaPublicacion": "2026-10-22",
      "rutaWeb": "rutaWeb",
      "codigo": "ABCD-1234"
    }
  ],
  "sectores": [
    {
      "slug": "ana-garcia-lopez",
      "nombre": "ANA GARCIA LOPEZ",
      "empresas": 0,
      "ultimaPublicacion": "2026-10-22",
      "rutaWeb": "rutaWeb",
      "division": {
        "codigo": "ABCD-1234",
        "titulo": "titulo"
      }
    }
  ],
  "iniciales": [
    {
      "letra": "letra",
      "slug": "ana-garcia-lopez",
      "fichas": 0
    }
  ]
}
GET/v1/dev/empresas/provincias/{provincia}/municipios/{municipio}

Las empresas de un municipio, por orden alfabético

Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
provinciatextosíNombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres
municipiotextosíNombre o slug del municipio.. al menos 1 caracteres; hasta 120 caracteres
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/provincias/madrid/municipios/madrid" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/provincias/madrid/municipios/madrid",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/provincias/madrid/municipios/madrid");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "provincia": {
    "provincia": "MADRID",
    "provinciaLegible": "Madrid",
    "provinciaSlug": "madrid"
  },
  "titulo": "titulo",
  "fichas": 0,
  "pagina": 1,
  "paginas": 1,
  "empresas": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "titular": "sociedad",
      "primeraPublicacion": "2026-10-22",
      "ultimaPublicacion": "2026-10-22",
      "concursalPublicadoEn": "2026-10-22",
      "disolucionPublicadaEn": "2026-10-22",
      "extincionPublicadaEn": "2026-10-22",
      "rutaWeb": "rutaWeb"
    }
  ]
}
GET/v1/dev/empresas/provincias/{provincia}/sectores/{sector}

Las empresas de un sector (CNAE) en una provincia, por orden alfabético

`sector` es el trozo que da la provincia (`68-actividades-inmobiliarias`); sólo cuenta su código. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
provinciatextosíNombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres
sectortextosíSector: división CNAE de dos cifras, o su slug.. al menos 1 caracteres; hasta 120 caracteres
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/provincias/madrid/sectores/comercio" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/provincias/madrid/sectores/comercio",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/provincias/madrid/sectores/comercio");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "provincia": {
    "provincia": "MADRID",
    "provinciaLegible": "Madrid",
    "provinciaSlug": "madrid"
  },
  "titulo": "titulo",
  "fichas": 0,
  "pagina": 1,
  "paginas": 1,
  "empresas": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "titular": "sociedad",
      "primeraPublicacion": "2026-10-22",
      "ultimaPublicacion": "2026-10-22",
      "concursalPublicadoEn": "2026-10-22",
      "disolucionPublicadaEn": "2026-10-22",
      "extincionPublicadaEn": "2026-10-22",
      "rutaWeb": "rutaWeb"
    }
  ]
}
GET/v1/dev/empresas/provincias/{provincia}/letras/{letra}

Las empresas de una provincia con una inicial, por orden alfabético

`letra` es `a`–`z` o `simbolos`. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
provinciatextosíNombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres
letratextosíLetra inicial.. al menos 1 caracteres; hasta 10 caracteres
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/provincias/madrid/letras/a" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/provincias/madrid/letras/a",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/provincias/madrid/letras/a");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "provincia": {
    "provincia": "MADRID",
    "provinciaLegible": "Madrid",
    "provinciaSlug": "madrid"
  },
  "titulo": "titulo",
  "fichas": 0,
  "pagina": 1,
  "paginas": 1,
  "empresas": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "titular": "sociedad",
      "primeraPublicacion": "2026-10-22",
      "ultimaPublicacion": "2026-10-22",
      "concursalPublicadoEn": "2026-10-22",
      "disolucionPublicadaEn": "2026-10-22",
      "extincionPublicadaEn": "2026-10-22",
      "rutaWeb": "rutaWeb"
    }
  ]
}
GET/v1/dev/empresas/provincias/{provincia}/observatorio

Observatorio de la provincia: constituciones, disoluciones, extinciones y concursos por mes

Los últimos meses con la cobertura de cada uno. Una comparación sólo existe entre meses completos; un mes sin días cargados no es un cero, es «sin datos» (`actos: null`). 404 mientras la vista no esté calculada. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
provinciatextosíNombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/provincias/madrid/observatorio" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/provincias/madrid/observatorio",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/provincias/madrid/observatorio");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "provincia": {
    "provincia": "MADRID",
    "provinciaLegible": "Madrid",
    "provinciaSlug": "madrid"
  },
  "meses": [
    {
      "mes": "mes",
      "cobertura": {
        "estado": "completo",
        "diasCargados": 0,
        "diasDelMes": 0
      },
      "cifras": [
        {
          "acto": "constitucion",
          "actos": 0,
          "frenteAlAnterior": {
            "diferencia": 0,
            "porcentaje": 0
          },
          "frenteAlAnioAnterior": {
            "diferencia": 0,
            "porcentaje": 0
          }
        }
      ]
    }
  ]
}
GET/v1/dev/empresas/provincias/{provincia}/actos/{acto}/{mes}

Lo publicado de un tipo de acto en una provincia y un mes

`acto`: constitucion, disolucion, extincion o situacion_concursal. `mes`: AAAA-MM. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
provinciatextosíNombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres
actotextosíTipo de acto del BORME (por ejemplo constitucion, nombramientos, disolucion).. al menos 1 caracteres; hasta 40 caracteres
mestextosíMes, AAAA-MM.. patrón ^\d{4}-(0[1-9]|1[0-2])$
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/provincias/madrid/actos/nombramientos/2026-09" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/provincias/madrid/actos/nombramientos/2026-09",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/provincias/madrid/actos/nombramientos/2026-09");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "provincia": {
    "provincia": "MADRID",
    "provinciaLegible": "Madrid",
    "provinciaSlug": "madrid"
  },
  "acto": "constitucion",
  "mes": "mes",
  "total": 1,
  "cobertura": {
    "estado": "completo",
    "diasCargados": 0,
    "diasDelMes": 0
  },
  "pagina": 1,
  "hayMas": true,
  "actos": [
    {
      "empresaId": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "fecha": "2026-10-22",
      "numero": 7,
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "rutaWeb": "rutaWeb"
    }
  ]
}
GET/v1/dev/empresas/actos/{tipo}

Lo último publicado de un tipo de acto (constitución, concurso, cambio de domicilio…)

Los últimos 92 días cargados. `tipo` es el trozo de URL del tipo (`cambio-de-domicilio`). `provincia` filtra por el nombre tal como lo publica el BORME. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
tipotextosíTipo: filtro separado por comas en cronologías y listados; empresa, persona o domicilio en los elementos de un caso.. al menos 1 caracteres; hasta 120 caracteres
provinciatextonoNombre o slug de la provincia.. al menos 1 caracteres; hasta 60 caracteres
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/actos/constitucion" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/actos/constitucion",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/actos/constitucion");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "tipo": "tipo",
  "desde": "2026-10-22",
  "hasta": "2026-10-22",
  "recortado": true,
  "pagina": 1,
  "hayMas": true,
  "actos": [
    {
      "fecha": "2026-10-22",
      "numero": 7,
      "identificador": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "provincia": "MADRID",
      "empresaId": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "tipo": "tipo",
      "etiqueta": "etiqueta",
      "capitalCentimos": 300000,
      "capitalResultanteCentimos": 0,
      "domicilio": "domicilio",
      "detalle": "detalle",
      "rutaWeb": "rutaWeb"
    }
  ]
}
GET/v1/dev/empresas/rankings

Rankings: capital social, sociedades más antiguas y últimas constituidas

`criterio`: capital, antiguedad o recientes (las últimas constituidas sólo existen de toda España). `ambito`: nacional (por defecto), comunidad (`valor`: código de dos letras, `MD`), provincia (`valor`: el trozo de URL) o sector (`valor`: el trozo del sector). Cada fila lleva la cita del boletín. Un ámbito que no existe es un 404; mientras el refresco nocturno no ha poblado las vistas, `disponible: false`. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
criteriotextonoQué se ordena: capital, antiguedad o recientes (las últimas constituidas sólo existen de toda España). Por defecto capital.. uno de: capital, antiguedad, recientes
ambitotextonoDónde: nacional (por defecto), comunidad, provincia o sector.. uno de: nacional, comunidad, provincia, sector
valortextonoEl ámbito concreto: código de dos letras de la comunidad (MD), trozo de URL de la provincia o del sector.. al menos 1 caracteres; hasta 120 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/rankings" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/rankings",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/rankings");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "criterio": "capital",
  "ambito": "nacional",
  "valor": "valor",
  "disponible": true,
  "filas": [
    {
      "posicion": 0,
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "valor": 0,
      "fuente": {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22"
      },
      "rutaWeb": "rutaWeb"
    }
  ]
}
GET/v1/dev/empresas/indice/{letra}

El índice alfabético: las provincias con fichas de una inicial

Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
letratextosíLetra inicial.. al menos 1 caracteres; hasta 10 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/indice/a" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/indice/a",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/indice/a");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "letra": "letra",
  "provincias": [
    {
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "provinciaSlug": "madrid",
      "fichas": 0
    }
  ]
}
GET/v1/dev/empresas/barometro

Barómetro nacional del BORME: seis actos por día, semana o mes, con su desglose

`granularidad`: dia, semana (por defecto) o mes. El desglose por provincia y comunidad y las constituciones por sector son del periodo `clave` (por defecto el último ya terminado, nunca el que está en curso). 404 mientras el barómetro no esté calculado. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
granularidadtextonodia, semana (por defecto) o mes.. uno de: dia, semana, mes
clavetextonoEl periodo del desglose (por defecto el último ya terminado, nunca el que está en curso).. al menos 1 caracteres; hasta 20 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/barometro" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/barometro",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/barometro");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "granularidad": "dia",
  "hoy": "2026-10-22",
  "actos": [
    "constitucion"
  ],
  "periodos": [
    {
      "clave": "clave",
      "etiqueta": "etiqueta",
      "etiquetaCorta": "etiquetaCorta",
      "completo": true,
      "porActo": {
        "constitucion": {
          "actos": 0,
          "comparacion": {
            "diferencia": 0,
            "porcentaje": 0
          }
        },
        "disolucion": {
          "actos": 0,
          "comparacion": {
            "diferencia": 0,
            "porcentaje": 0
          }
        },
        "extincion": {
          "actos": 0,
          "comparacion": {
            "diferencia": 0,
            "porcentaje": 0
          }
        },
        "ampliacion_de_capital": {
          "actos": 0,
          "comparacion": {
            "diferencia": 0,
            "porcentaje": 0
          }
        },
        "reduccion_de_capital": {
          "actos": 0,
          "comparacion": {
            "diferencia": 0,
            "porcentaje": 0
          }
        },
        "cambio_de_domicilio": {
          "actos": 0,
          "comparacion": {
            "diferencia": 0,
            "porcentaje": 0
          }
        }
      }
    }
  ],
  "desglose": {
    "clave": "clave",
    "etiqueta": "etiqueta",
    "completo": true,
    "porProvincia": [
      {
        "provincia": "MADRID",
        "provinciaLegible": "Madrid",
        "comunidad": "comunidad",
        "comunidadNombre": "comunidadNombre",
        "porActo": {
          "constitucion": 0,
          "disolucion": 0,
          "extincion": 0,
          "ampliacion_de_capital": 0,
          "reduccion_de_capital": 0,
          "cambio_de_domicilio": 0
        },
        "total": 1
      }
    ],
    "porComunidad": [
      {
        "comunidad": "comunidad",
        "comunidadNombre": "comunidadNombre",
        "porActo": {
          "constitucion": 0,
          "disolucion": 0,
          "extincion": 0,
          "ampliacion_de_capital": 0,
          "reduccion_de_capital": 0,
          "cambio_de_domicilio": 0
        },
        "total": 1
      }
    ]
  },
  "constitucionesPorSector": {
    "clave": "clave",
    "etiqueta": "etiqueta",
    "completo": true,
    "constituciones": 0,
    "conSector": 0,
    "sectores": [
      {
        "codigo": "ABCD-1234",
        "titulo": "titulo",
        "constituciones": 0
      }
    ]
  }
}
GET/v1/dev/empresas/mapa

Constituciones recientes cerca de un municipio

Con `q` (el nombre de un municipio) devuelve los que casan para desambiguar; con `municipio` (y `provincia` si el nombre se repite) devuelve las constituciones de los últimos 92 días cuyo domicilio cae allí. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
qtextonoLo que se busca.. hasta 120 caracteres
municipiotextonoNombre o slug del municipio.. al menos 1 caracteres; hasta 120 caracteres
provinciatextonoNombre o slug de la provincia.. al menos 1 caracteres; hasta 60 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/mapa" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/mapa",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/mapa");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "municipios": [
    {
      "codigo": "ABCD-1234",
      "nombre": "ANA GARCIA LOPEZ",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid"
    }
  ],
  "constituciones": {
    "municipio": "municipio",
    "desde": "2026-10-22",
    "hasta": "2026-10-22",
    "hayMas": true,
    "filas": [
      {
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7,
        "fecha": "2026-10-22",
        "empresaId": "12345",
        "denominacion": "ACME SERVICIOS SL",
        "denominacionLegible": "Acme Servicios, S.L.",
        "provincia": "MADRID",
        "domicilio": "domicilio",
        "geocodificado": true,
        "rutaWeb": "rutaWeb"
      }
    ]
  }
}
GET/v1/dev/empresas/domicilios/{slug}

Quién ha estado domiciliado en una dirección

Las sociedades que han publicado esa dirección, con el acto que la abre y el que la cierra, y la cronología. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
slugtextosíSlug de un nombre de persona, de una noticia o de un domicilio, tal como lo devuelve la API.. al menos 1 caracteres; hasta 240 caracteres
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/domicilios/ana-garcia-lopez" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/domicilios/ana-garcia-lopez",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/domicilios/ana-garcia-lopez");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "slug": "ana-garcia-lopez",
  "domicilio": "domicilio",
  "provincia": "MADRID",
  "provinciaLegible": "Madrid",
  "total": 1,
  "vigentes": 0,
  "recortado": true,
  "pagina": 1,
  "hayMas": true,
  "sociedades": [
    {
      "empresa": {
        "id": "12345",
        "denominacion": "ACME SERVICIOS SL",
        "denominacionLegible": "Acme Servicios, S.L.",
        "provincia": "MADRID",
        "concursalPublicadoEn": "2026-10-22",
        "disolucionPublicadaEn": "2026-10-22",
        "extincionPublicadaEn": "2026-10-22",
        "rutaWeb": "rutaWeb"
      },
      "vigente": true,
      "tramos": [
        {
          "altaPor": "constitucion",
          "desde": {
            "fecha": "2026-10-22",
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7
          },
          "hasta": {
            "fecha": "2026-10-22",
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7
          }
        }
      ]
    }
  ],
  "cronologia": [
    {
      "tipo": "alta",
      "fecha": "2026-10-22",
      "empresa": {
        "id": "12345",
        "denominacion": "ACME SERVICIOS SL",
        "denominacionLegible": "Acme Servicios, S.L.",
        "provincia": "MADRID",
        "concursalPublicadoEn": "2026-10-22",
        "disolucionPublicadaEn": "2026-10-22",
        "extincionPublicadaEn": "2026-10-22",
        "rutaWeb": "rutaWeb"
      },
      "cita": {
        "fecha": "2026-10-22",
        "identificador": "BORME-A-2026-200-28",
        "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "numero": 7
      },
      "altaPor": "constitucion"
    }
  ],
  "eventosTotales": 0
}
GET/v1/dev/empresas/avanzada

Búsqueda avanzada: filtros combinados sobre hechos publicados

Los mismos parámetros que la dirección de `empresas.jurilia.com/buscar` (provincia, municipio, forma, sector, situacion, const_desde, const_hasta, fin_desde, fin_hasta, vida_max, cap_min, cap_max, cambios_min, traslados_min, organo, nif, contratos, subvenciones, persona, vigente, domicilio, orden, pagina). Lo que no se entiende se ignora y se devuelve en `ignorados`. Se cobra por consulta servida (clase «cruce», 8 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
provinciatextonoNombre o slug de la provincia.. hasta 300 caracteres
municipiotextonoNombre o slug del municipio.. hasta 300 caracteres
formatextonoSiglas de la forma social: SL, SA, SLU, SAU, SLP, SLL, SCOOP…. hasta 300 caracteres
sectortextonoSector: división CNAE de dos cifras, o su slug.. hasta 300 caracteres
situaciontexto o lista de textonoSituación: activa, concurso, disuelta o extinguida. Puede repetirse (cualquiera de ellas).
const_desdetextonoConstituida desde esta fecha (AAAA-MM-DD).. hasta 300 caracteres
const_hastatextonoConstituida hasta esta fecha (AAAA-MM-DD).. hasta 300 caracteres
fin_desdetextonoDisolución o extinción publicada desde esta fecha (la primera de las dos).. hasta 300 caracteres
fin_hastatextonoDisolución o extinción publicada hasta esta fecha.. hasta 300 caracteres
vida_maxtextonoVida publicada (de la constitución a la disolución o extinción) de como mucho tantos meses (máximo 1.200).. hasta 300 caracteres
cap_mintextonoCapital mínimo, en euros.. hasta 300 caracteres
cap_maxtextonoCapital máximo, en euros.. hasta 300 caracteres
cambios_mintextonoAl menos tantos cambios de administración publicados (en el periodo, si lo pones).. hasta 300 caracteres
traslados_mintextonoAl menos tantos traslados de domicilio publicados (en el periodo, si lo pones).. hasta 300 caracteres
organotextonoÓrgano de administración: administrador único, mancomunado, solidario, consejo…. hasta 300 caracteres
niftextono1 para sólo sociedades con NIF conocido sin ambigüedad.. hasta 300 caracteres
contratostextono1 para sólo sociedades con contratos públicos adjudicados.. hasta 300 caracteres
subvencionestextono1 para sólo sociedades con subvenciones concedidas.. hasta 300 caracteres
personatextonoNombre de una persona con cargo, con nombre y apellidos como los publica el BORME. Un nombre no es una identidad.. hasta 300 caracteres
vigentetextono1 para sólo sociedades donde esa persona tiene el cargo sin cese publicado.. hasta 300 caracteres
domiciliotextonoLa dirección entera como la publica el BORME («C/ MAYOR 12 (MADRID)»).. hasta 300 caracteres
calletextonoCalle del domicilio social publicado en el BORME, en cualquier orden de palabras y sin «de», «del»… Exige municipio. Mientras la búsqueda por lugar no esté activa se ignora.. hasta 300 caracteres
portaltextonoNúmero de portal, con calle. Sin él salen todas las sociedades de la calle.. hasta 300 caracteres
edificiotextonoTipo de edificio del Catastro: oficinas, industrial, comercio, servicios_publicos o agrario. Solo sociedades cuyo edificio hemos podido identificar; exige municipio o provincia.. hasta 300 caracteres
const_aniotextonoAño de constitución.. hasta 300 caracteres
comparte_mintextonoComparte el último domicilio publicado con al menos tantas sociedades, ella incluida (de 2 a 5.000).. hasta 300 caracteres
periodo_desdetextonoAño desde el que cuentan los cambios y traslados mínimos (sólo con cambios_min o traslados_min).. hasta 300 caracteres
periodo_hastatextonoAño hasta el que cuentan, ambos incluidos.. hasta 300 caracteres
ordentextonoreciente (por defecto) o antiguo.. hasta 300 caracteres. por defecto: reciente
paginatextonoNúmero de página, desde 1. Alternativa: cursor.. hasta 300 caracteres. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/avanzada" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/avanzada",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/avanzada");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "resultado": "ok",
  "ignorados": [
    "ignorado"
  ],
  "total": 1,
  "acotado": true,
  "pagina": 1,
  "paginas": 1,
  "municipioNoReconocido": true,
  "alDia": "2026-10-22",
  "filas": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "constitucion": "2026-10-22",
      "disolucion": "2026-10-22",
      "extincion": "2026-10-22",
      "concursal": "2026-10-22",
      "capitalCentimos": 300000,
      "cambiosAdministracion": 0,
      "traslados": 0,
      "pruebas": [
        {
          "criterio": "constitucion",
          "fuente": "borme",
          "fecha": "2026-10-22",
          "cantidad": 0,
          "importeCentimos": 1250000,
          "texto": "texto",
          "periodo": {
            "desde": 0,
            "hasta": 0
          },
          "cita": {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        }
      ],
      "rutaWeb": "rutaWeb"
    }
  ]
}
GET/v1/dev/empresas/prospeccion

Lista de prospección: sociedades que han publicado un acto en el BORME

Los mismos parámetros que la dirección de `empresas.jurilia.com/prospeccion`: `acto` (constitucion, ampliacion_de_capital, cambio_de_domicilio, nombramientos, cambio_de_objeto, ampliacion_de_objeto), `periodo` (semana, mes, mes_anterior, treinta_dias, rango; con `desde` y `hasta`), `provincia`, `municipio`, `forma`, `sector` (división CNAE), `cap_min` (euros) y `pagina`. Cada fila es un acto publicado sobre una SOCIEDAD (nunca una persona física), con su domicilio publicado, su capital y la cita del boletín. Sin teléfonos ni correos: el BORME no los publica. Lo que no se entiende se ignora y se devuelve en `ignorados`. Se cobra por consulta servida (clase «grafo», 15 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

15 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
actotextonoTipo de acto del BORME (por ejemplo constitucion, nombramientos, disolucion).. hasta 300 caracteres
periodotextonoPeriodo de la lista: semana, mes (por defecto), mes_anterior, treinta_dias o rango (con desde y hasta; como mucho 93 días).. hasta 300 caracteres
desdetextonoFecha de inicio, AAAA-MM-DD.. hasta 300 caracteres
hastatextonoFecha final del rango (AAAA-MM-DD), con periodo=rango.. hasta 300 caracteres
provinciatextonoNombre o slug de la provincia.. hasta 300 caracteres
municipiotextonoNombre o slug del municipio.. hasta 300 caracteres
formatextonoSiglas de la forma social: SL, SA, SLU, SAU, SLP, SLL, SCOOP…. hasta 300 caracteres
sectortextonoSector: división CNAE de dos cifras, o su slug.. hasta 300 caracteres
cap_mintextonoCapital mínimo, en euros.. hasta 300 caracteres
paginatextonoNúmero de página, desde 1. Alternativa: cursor.. hasta 300 caracteres. por defecto: 1

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/prospeccion" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/prospeccion",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/prospeccion");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "resultado": "ok",
  "motivo": "rango_incompleto",
  "ignorados": [
    "ignorado"
  ],
  "desde": "2026-10-22",
  "hasta": "2026-10-22",
  "total": 1,
  "acotado": true,
  "pagina": 1,
  "paginas": 1,
  "municipioNoReconocido": true,
  "alDia": "2026-10-22",
  "filas": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "formaSocial": "formaSocial",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "sector": "sector",
      "acto": "constitucion",
      "fechaDelActo": "2026-10-22",
      "capitalCentimos": 300000,
      "domicilio": "domicilio",
      "boletin": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "numeroDeAnuncio": 0,
      "rutaWeb": "rutaWeb"
    }
  ]
}
GET/v1/dev/empresas/prospeccion/descarga

Descargar una lista de prospección en Excel o CSV

Hasta 1000 filas, de más reciente a más antigua, con la cita del boletín de cada una y una hoja con las condiciones. 6 descargas por hora y dirección, sin cuenta. Los mismos parámetros que la lista, más `formato` (xlsx por defecto, o csv) e `idioma` de las cabeceras. Se cobra por consulta servida (clase «descarga», 200 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

200 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
actotextonoTipo de acto del BORME (por ejemplo constitucion, nombramientos, disolucion).. hasta 300 caracteres
periodotextonoPeriodo de la lista: semana, mes (por defecto), mes_anterior, treinta_dias o rango (con desde y hasta; como mucho 93 días).. hasta 300 caracteres
desdetextonoFecha de inicio, AAAA-MM-DD.. hasta 300 caracteres
hastatextonoFecha final del rango (AAAA-MM-DD), con periodo=rango.. hasta 300 caracteres
provinciatextonoNombre o slug de la provincia.. hasta 300 caracteres
municipiotextonoNombre o slug del municipio.. hasta 300 caracteres
formatextonoSiglas de la forma social: SL, SA, SLU, SAU, SLP, SLL, SCOOP…. hasta 300 caracteres
sectortextonoSector: división CNAE de dos cifras, o su slug.. hasta 300 caracteres
cap_mintextonoCapital mínimo, en euros.. hasta 300 caracteres
formatotextonoFormato del fichero: xlsx (por defecto) o csv en la descarga de prospección; csv o graphml en la exportación de la red.. uno de: xlsx, csv. por defecto: xlsx
idiomatextonoIdioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -o salida.pdf "https://api.jurilia.com/v1/dev/empresas/prospeccion/descarga" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/prospeccion/descarga",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
open("salida.pdf", "wb").write(r.content)

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/prospeccion/descarga");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
await (await import("node:fs/promises")).writeFile("salida.pdf", Buffer.from(await r.arrayBuffer()));

Respuesta de ejemplo

Esta ruta devuelve un fichero (PDF, Excel o CSV), no JSON.

GET/v1/dev/empresas/noticias

Noticias de Jurilia Empresas, firmadas, en el idioma pedido

De la más reciente a la más antigua, doce por página. `tema` es el trozo de URL del tema (`semana-en-la-provincia`, `ampliaciones-de-capital`, `sectores`, `actualidad`) y `provincia` el de la provincia; uno que no existe da 404. En otro idioma que el español sólo salen las que tienen traducción. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idiomatextonoIdioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1
tematextonoTrozo de URL del tema: semana-en-la-provincia, ampliaciones-de-capital, sectores o actualidad.. al menos 1 caracteres; hasta 120 caracteres
provinciatextonoNombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/noticias" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/noticias",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/noticias");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "idioma": "es",
  "noticias": [
    {
      "slug": "ana-garcia-lopez",
      "titulo": "titulo",
      "entradilla": "entradilla",
      "plantilla": "semana-provincia",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "periodoDesde": "2026-10-22",
      "periodoHasta": "2026-10-22",
      "publicadaEn": "publicadaEn",
      "actualizadaEn": "actualizadaEn",
      "autorNombre": "autorNombre",
      "autorSlug": "autorSlug",
      "rutaWeb": "rutaWeb"
    }
  ],
  "total": 1,
  "pagina": 1,
  "porPagina": 20,
  "temas": [
    {
      "slug": "ana-garcia-lopez",
      "plantilla": "semana-provincia",
      "n": 0
    }
  ],
  "provincias": [
    {
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "provinciaSlug": "madrid",
      "n": 0
    }
  ]
}
GET/v1/dev/empresas/noticias/{slug}

Una noticia, con sus cifras citadas

`cuerpo` es Markdown. Cada cifra lleva de qué consulta sale. Una noticia sin traducción al idioma pedido no existe en ese idioma (404). Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
slugtextosíSlug de un nombre de persona, de una noticia o de un domicilio, tal como lo devuelve la API.. al menos 1 caracteres; hasta 240 caracteres
idiomatextonoIdioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/noticias/ana-garcia-lopez" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/noticias/ana-garcia-lopez",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/noticias/ana-garcia-lopez");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "slug": "ana-garcia-lopez",
  "titulo": "titulo",
  "entradilla": "entradilla",
  "plantilla": "semana-provincia",
  "provincia": "MADRID",
  "provinciaLegible": "Madrid",
  "periodoDesde": "2026-10-22",
  "periodoHasta": "2026-10-22",
  "publicadaEn": "publicadaEn",
  "actualizadaEn": "actualizadaEn",
  "autorNombre": "autorNombre",
  "autorSlug": "autorSlug",
  "rutaWeb": "rutaWeb",
  "idioma": "es",
  "idiomas": [
    "es"
  ],
  "cuerpo": "cuerpo",
  "metaTitulo": "metaTitulo",
  "metaDescripcion": "metaDescripcion",
  "comunidad": "comunidad",
  "cifras": [
    {
      "id": "12345",
      "etiqueta": "etiqueta",
      "valor": 0,
      "texto": "texto",
      "origen": "origen"
    }
  ],
  "autorBio": "autorBio",
  "autorCredenciales": "autorCredenciales",
  "empresas": [
    {
      "empresaId": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "rutaWeb": "rutaWeb"
    }
  ]
}
GET/v1/dev/empresas/informes

Los informes mensuales publicados

El archivo: del más reciente al más antiguo, con la huella de cada uno. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/informes" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/informes",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/informes");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "informes": [
    {
      "mes": "mes",
      "version": 0,
      "extraidoEn": "extraidoEn",
      "publicadoEn": "publicadoEn",
      "huella": "huella"
    }
  ]
}
GET/v1/dev/empresas/informes/{mes}

El informe mensual del BORME: nacional, por comunidad y por provincia

Ocho cifras (constituciones, disoluciones, extinciones, concursos, ampliaciones y reducciones de capital, nombramientos y ceses de administración) del mes, del anterior y del mismo mes del año anterior. El nacional es la suma de las provincias. `descargas` apunta al PDF, al CSV, a la imagen y a los gráficos de la web. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
mestextosíMes, AAAA-MM.. patrón ^\d{4}-(0[1-9]|1[0-2])$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/informes/2026-09" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/informes/2026-09",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/informes/2026-09");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "mes": "mes",
  "version": 0,
  "extraidoEn": "extraidoEn",
  "publicadoEn": "publicadoEn",
  "huella": "huella",
  "huellaCoincide": true,
  "mesAnterior": "mesAnterior",
  "mesAnioAnterior": "mesAnioAnterior",
  "ultimoDiaCargado": "2026-10-22",
  "coberturas": {
    "actual": {
      "estado": "completo",
      "diasCargados": 0,
      "diasDelMes": 0
    },
    "anterior": {
      "estado": "completo",
      "diasCargados": 0,
      "diasDelMes": 0
    },
    "anioAnterior": {
      "estado": "completo",
      "diasCargados": 0,
      "diasDelMes": 0
    }
  },
  "nacional": {
    "actual": {
      "constituciones": 0,
      "disoluciones": 0,
      "extinciones": 0,
      "concursos": 0,
      "ampliaciones_de_capital": 0,
      "reducciones_de_capital": 0,
      "nombramientos_de_administracion": 0,
      "ceses_de_administracion": 0
    },
    "anterior": {
      "constituciones": 0,
      "disoluciones": 0,
      "extinciones": 0,
      "concursos": 0,
      "ampliaciones_de_capital": 0,
      "reducciones_de_capital": 0,
      "nombramientos_de_administracion": 0,
      "ceses_de_administracion": 0
    },
    "anioAnterior": {
      "constituciones": 0,
      "disoluciones": 0,
      "extinciones": 0,
      "concursos": 0,
      "ampliaciones_de_capital": 0,
      "reducciones_de_capital": 0,
      "nombramientos_de_administracion": 0,
      "ceses_de_administracion": 0
    }
  },
  "comunidades": [
    {
      "comunidad": "comunidad",
      "provincias": 0,
      "valores": {
        "actual": {
          "constituciones": 0,
          "disoluciones": 0,
          "extinciones": 0,
          "concursos": 0,
          "ampliaciones_de_capital": 0,
          "reducciones_de_capital": 0,
          "nombramientos_de_administracion": 0,
          "ceses_de_administracion": 0
        },
        "anterior": {
          "constituciones": 0,
          "disoluciones": 0,
          "extinciones": 0,
          "concursos": 0,
          "ampliaciones_de_capital": 0,
          "reducciones_de_capital": 0,
          "nombramientos_de_administracion": 0,
          "ceses_de_administracion": 0
        },
        "anioAnterior": {
          "constituciones": 0,
          "disoluciones": 0,
          "extinciones": 0,
          "concursos": 0,
          "ampliaciones_de_capital": 0,
          "reducciones_de_capital": 0,
          "nombramientos_de_administracion": 0,
          "ceses_de_administracion": 0
        }
      }
    }
  ],
  "provincias": [
    {
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "provinciaSlug": "madrid",
      "codigo": "ABCD-1234",
      "comunidad": "comunidad",
      "valores": {
        "actual": {
          "constituciones": 0,
          "disoluciones": 0,
          "extinciones": 0,
          "concursos": 0,
          "ampliaciones_de_capital": 0,
          "reducciones_de_capital": 0,
          "nombramientos_de_administracion": 0,
          "ceses_de_administracion": 0
        },
        "anterior": {
          "constituciones": 0,
          "disoluciones": 0,
          "extinciones": 0,
          "concursos": 0,
          "ampliaciones_de_capital": 0,
          "reducciones_de_capital": 0,
          "nombramientos_de_administracion": 0,
          "ceses_de_administracion": 0
        },
        "anioAnterior": {
          "constituciones": 0,
          "disoluciones": 0,
          "extinciones": 0,
          "concursos": 0,
          "ampliaciones_de_capital": 0,
          "reducciones_de_capital": 0,
          "nombramientos_de_administracion": 0,
          "ceses_de_administracion": 0
        }
      }
    }
  ],
  "provinciasSinComunidad": 0,
  "descargas": {
    "pdf": "pdf",
    "csv": "csv",
    "imagen": "imagen",
    "graficos": [
      {
        "metrica": "constituciones",
        "ruta": "ruta"
      }
    ]
  }
}
GET/v1/dev/empresas/informes/{mes}/{provincia}

El informe mensual de una provincia

Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
mestextosíMes, AAAA-MM.. patrón ^\d{4}-(0[1-9]|1[0-2])$
provinciatextosíNombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/informes/2026-09/madrid" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/informes/2026-09/madrid",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/informes/2026-09/madrid");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "mes": "mes",
  "version": 0,
  "extraidoEn": "extraidoEn",
  "publicadoEn": "publicadoEn",
  "huella": "huella",
  "huellaCoincide": true,
  "mesAnterior": "mesAnterior",
  "mesAnioAnterior": "mesAnioAnterior",
  "ultimoDiaCargado": "2026-10-22",
  "coberturas": {
    "actual": {
      "estado": "completo",
      "diasCargados": 0,
      "diasDelMes": 0
    },
    "anterior": {
      "estado": "completo",
      "diasCargados": 0,
      "diasDelMes": 0
    },
    "anioAnterior": {
      "estado": "completo",
      "diasCargados": 0,
      "diasDelMes": 0
    }
  },
  "provincia": {
    "provincia": "MADRID",
    "provinciaLegible": "Madrid",
    "provinciaSlug": "madrid",
    "codigo": "ABCD-1234",
    "comunidad": "comunidad",
    "valores": {
      "actual": {
        "constituciones": 0,
        "disoluciones": 0,
        "extinciones": 0,
        "concursos": 0,
        "ampliaciones_de_capital": 0,
        "reducciones_de_capital": 0,
        "nombramientos_de_administracion": 0,
        "ceses_de_administracion": 0
      },
      "anterior": {
        "constituciones": 0,
        "disoluciones": 0,
        "extinciones": 0,
        "concursos": 0,
        "ampliaciones_de_capital": 0,
        "reducciones_de_capital": 0,
        "nombramientos_de_administracion": 0,
        "ceses_de_administracion": 0
      },
      "anioAnterior": {
        "constituciones": 0,
        "disoluciones": 0,
        "extinciones": 0,
        "concursos": 0,
        "ampliaciones_de_capital": 0,
        "reducciones_de_capital": 0,
        "nombramientos_de_administracion": 0,
        "ceses_de_administracion": 0
      }
    }
  },
  "descargas": {
    "csv": "csv"
  }
}
GET/v1/dev/empresas/verificar-informe/{huella}

Comprobar que Jurilia generó un informe con esa huella

Sólo dice que Jurilia generó un informe con esa huella SHA-256, cuándo y de cuántas páginas. No guarda nada de quien pregunta. 256 bits no se adivinan probando. Se cobra por consulta servida (clase «simple», 3 céntimos; la tabla de precios está en la documentación). Mismo dato y mismas reglas que la consulta pública gratuita de empresas.jurilia.com, sin su cupo por dirección.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
huellatextosíHuella SHA-256 del informe.. patrón ^[0-9a-fA-F]{64}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/empresas/verificar-informe/e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/empresas/verificar-informe/e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/empresas/verificar-informe/e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "coincideCon": "contenido",
  "generadoEn": "2026-10-22T08:00:00.000Z",
  "paginas": 1
}
POST/v1/dev/citas/verificar

Verificar las citas de un texto

Detecta cada cita legal (artículo de una norma, rangos incluidos) y jurisprudencial (ECLI, ROJ, número de sentencia) del texto y la contrasta con la biblioteca a la fecha del escrito. Devuelve, por cita, `estado` (`verificada` / `no_encontrada`), el semáforo (`verde`, `ambar`, `rojo`), el motivo y el enlace al fragmento de la fuente oficial. **Cita o calla:** lo que no se encuentra no lleva enlace ni se da por bueno; ámbar significa «no verificable con nuestra base», nunca «falsa». Es el mismo verificador de la app. Precio: 3 céntimos por cada 10 citas o fracción (como una búsqueda de biblioteca; mínimo 3). Máximo 100 citas por llamada: con más, 422 sin cobrar.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
textotextosíEl texto cuyas citas se verifican (escrito, sentencia, respuesta de una IA…). Hasta 100000 caracteres y 100 citas por llamada (un rango «arts. 130 a 133» cuenta como cuatro).. al menos 1 caracteres; hasta 100000 caracteres
fechafecha (AAAA-MM-DD)noFecha del escrito (AAAA-MM-DD). Las normas se comprueban con la redacción que regía ese día, no con la de hoy. Por defecto, hoy en España.
ordenJurisdiccionaltextonoOrden jurisdiccional, para desambiguar siglas que se repiten entre órdenes.. uno de: civil, penal, social, contencioso

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/citas/verificar" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"texto":"texto"}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/citas/verificar",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"texto":"texto"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/citas/verificar");
const r = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"texto":"texto"}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "resultado": "verde",
  "fecha": "2026-10-22",
  "resumen": {
    "total": 1,
    "verificadas": 0,
    "noEncontradas": 0,
    "verdes": 0,
    "ambares": 0,
    "rojas": 0
  },
  "citas": [
    {
      "tipo": "articulo",
      "texto": "texto",
      "posicion": {
        "inicio": 0,
        "fin": 0
      },
      "estado": "verificada",
      "semaforo": "verde",
      "motivo": "motivo",
      "fuente": {
        "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
        "fragmento": "fragmento"
      },
      "sugerencia": "sugerencia"
    }
  ]
}
POST/v1/dev/documentos/extraer-texto

Extraer el texto de un documento (PDF, Word, imagen) con OCR

Sube hasta 5 archivos (PDF, Word .docx, JPEG o PNG) como `multipart/form-data` y recibe su texto. Lo escaneado y las fotos se leen con OCR propio, sin enviar nada a terceros y **sin ningún modelo de IA**. **Retención: nada se guarda** (ni el archivo, ni su nombre, ni el texto): se procesa en memoria y se descarta al responder. Precio: 2 céntimos por página leída con OCR (mínimo 1 céntimo por llamada servida; un PDF con texto o un Word cuestan el mínimo). El precio se calcula al inspeccionar el archivo y se reserva entero antes de leer: 402 si el saldo no alcanza, y si la lectura falla no se cobra nada. `?estimar=1` dice el mínimo sin leer nada.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/documentos/extraer-texto" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/documentos/extraer-texto",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/documentos/extraer-texto");
const r = await fetch(url, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "ficheros": [
    {
      "tipo": "pdf",
      "paginas": 1,
      "paginasConOcr": 0,
      "fuente": "texto_del_documento",
      "texto": "texto",
      "caracteres": 0
    }
  ],
  "resumen": {
    "ficheros": 0,
    "paginas": 1,
    "paginasConOcr": 0,
    "caracteres": 0
  },
  "facturacion": {
    "cobradoCentimos": 0,
    "saldoRestanteCentimos": 0
  }
}
GET/v1/dev/jurisprudencia/materias

Los ámbitos y las materias por las que se filtra la jurisprudencia

Penal, civil, familia, contencioso-administrativo, laboral, constitucional y Derecho de la UE, con las materias de cada uno. Es el árbol que pidió el abogado validador; no depende de la base.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Errores y cómo resolverlos

  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/jurisprudencia/materias" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/jurisprudencia/materias",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/jurisprudencia/materias");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "ambitos": [
    {
      "clave": "clave",
      "nombre": "ANA GARCIA LOPEZ",
      "materias": [
        {
          "codigo": "ABCD-1234",
          "nombre": "ANA GARCIA LOPEZ"
        }
      ]
    }
  ]
}
GET/v1/dev/jurisprudencia

Listar jurisprudencia con filtros, ficha y peso

Filtros: ámbito, materia, órgano, fechas y texto (o un ECLI). Cada resolución trae su ficha (lo que no consta, dicho) y su peso con la razón. Sólo lo visible: validadas y, si la bandera está apagada, sin las copias anonimizadas por Jurilia. Más reciente primero.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
ambitotextonoDónde: nacional (por defecto), comunidad, provincia o sector.. uno de: penal, civil, familia, contencioso, laboral, constitucional, ue, militar
materiatextonoCódigo o nombre de la materia (ver /v1/dev/jurisprudencia/materias).. al menos 3 caracteres; hasta 80 caracteres
organotextonoÓrgano de administración: administrador único, mancomunado, solidario, consejo…. uno de: TJUE, TC, TS, AN, TSJ, AP, JM, JPI, JS, JCA, DGSJFP, CEST, TEAC, TEAR
desdefecha (AAAA-MM-DD)noFecha de inicio, AAAA-MM-DD.
hastafecha (AAAA-MM-DD)noFecha final del rango (AAAA-MM-DD), con periodo=rango.
textotextonoTexto que se busca (o un ECLI).. al menos 2 caracteres; hasta 200 caracteres
paginaenteronoNúmero de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 500. por defecto: 1
tamanoenteronoResultados por página (1 a 50).. mínimo 1; máximo 50

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/jurisprudencia" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/jurisprudencia",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/jurisprudencia");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "total": 1,
  "pagina": 1,
  "tamano": 0,
  "analizadas": true,
  "resoluciones": [
    {
      "id": "12345",
      "identificador": "BORME-A-2026-200-28",
      "organo": "organo",
      "fecha": "2026-10-22",
      "ficha": {
        "organo": {
          "sigla": "sigla",
          "nombre": "ANA GARCIA LOPEZ"
        },
        "naturaleza": "jurisprudencia",
        "sala": {
          "valor": "valor",
          "procedencia": "guardado",
          "fragmento": "fragmento"
        },
        "seccion": {
          "valor": "valor",
          "procedencia": "guardado",
          "fragmento": "fragmento"
        },
        "lugar": {
          "valor": "valor",
          "procedencia": "guardado",
          "fragmento": "fragmento"
        },
        "formacion": "pleno",
        "fecha": "2026-10-22",
        "fechaEnLetra": "fechaEnLetra",
        "clase": {
          "valor": "valor",
          "procedencia": "guardado",
          "fragmento": "fragmento"
        },
        "numeroResolucion": {
          "valor": "valor",
          "procedencia": "guardado",
          "fragmento": "fragmento"
        },
        "numeroRecurso": {
          "valor": "valor",
          "procedencia": "guardado",
          "fragmento": "fragmento"
        },
        "etiquetaDelRecurso": "recurso",
        "tipoProcedimiento": {
          "valor": "valor",
          "procedencia": "guardado",
          "fragmento": "fragmento"
        },
        "ecli": {
          "valor": "valor",
          "procedencia": "guardado",
          "fragmento": "fragmento"
        },
        "enlaceOficial": {
          "valor": "valor",
          "procedencia": "guardado",
          "fragmento": "fragmento"
        },
        "copiaAnonimizada": true,
        "identificador": "BORME-A-2026-200-28",
        "noConstan": [
          "noConstan"
        ],
        "avisos": [
          "aviso"
        ]
      },
      "ambitos": [
        "ambito"
      ],
      "materias": [
        {
          "codigo": "ABCD-1234",
          "nombre": "ANA GARCIA LOPEZ"
        }
      ],
      "peso": {
        "nivel": "muy_alta",
        "nombreDelNivel": "nombreDelNivel",
        "razones": [
          "razone"
        ],
        "caracterizacion": "caracterizacion",
        "consolidada": true,
        "estado": "rectificada",
        "estadoEnTexto": "estadoEnTexto",
        "senales": [
          {
            "codigo": "ABCD-1234",
            "descripcion": "Integración con el CRM",
            "fragmento": "fragmento",
            "fundamento": "fundamento",
            "baseLegal": "baseLegal"
          }
        ],
        "recuentos": {
          "citadaPor": 0,
          "citadaPorIgualOSuperior": 0,
          "siguePrevias": 0
        },
        "evidencias": [
          {
            "direccion": "posterior",
            "relacion": "rectifica",
            "resolucion": {
              "id": "12345",
              "organo": "organo",
              "clase": "sentencia",
              "fecha": "2026-10-22",
              "identificador": "BORME-A-2026-200-28"
            },
            "fundamento": "fundamento",
            "fragmento": "fragmento",
            "expresion": "expresion"
          }
        ]
      }
    }
  ]
}
GET/v1/dev/jurisprudencia/{id}

La ficha completa de una resolución, con su peso y su línea temporal

Ficha (órgano, sala, sección, fecha, número de resolución, número de recurso, tipo de procedimiento, ECLI, enlace; lo que no consta se dice), materias con su porqué, peso con las razones y las citas que lo sostienen, quién la cita y a quién cita, y la línea temporal del criterio. `fecha` consulta el estado a una fecha: lo posterior no cuenta.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del recurso (suscripción de avisos, caso, lista, etiqueta o búsqueda guardada), el que devuelve la API al crearlo.
fechafecha (AAAA-MM-DD)noFecha de calendario, AAAA-MM-DD.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 no_encontrado — No está en lo cargado del BORME, o es una persona que ejerció su derecho de oposición o de supresión. Comprueba el identificador. Si sólo tienes el nombre, usa `GET /v1/dev/empresas/resolver?q=` o `GET /v1/dev/empresas?q=`. Una persona que ejerció su derecho de oposición o de supresión también da 404.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/jurisprudencia/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/jurisprudencia/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/jurisprudencia/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "12345",
  "resumen": {
    "id": "12345",
    "organo": "organo",
    "clase": "sentencia",
    "fecha": "2026-10-22",
    "identificador": "BORME-A-2026-200-28"
  },
  "ficha": {
    "organo": {
      "sigla": "sigla",
      "nombre": "ANA GARCIA LOPEZ"
    },
    "naturaleza": "jurisprudencia",
    "sala": {
      "valor": "valor",
      "procedencia": "guardado",
      "fragmento": "fragmento"
    },
    "seccion": {
      "valor": "valor",
      "procedencia": "guardado",
      "fragmento": "fragmento"
    },
    "lugar": {
      "valor": "valor",
      "procedencia": "guardado",
      "fragmento": "fragmento"
    },
    "formacion": "pleno",
    "fecha": "2026-10-22",
    "fechaEnLetra": "fechaEnLetra",
    "clase": {
      "valor": "valor",
      "procedencia": "guardado",
      "fragmento": "fragmento"
    },
    "numeroResolucion": {
      "valor": "valor",
      "procedencia": "guardado",
      "fragmento": "fragmento"
    },
    "numeroRecurso": {
      "valor": "valor",
      "procedencia": "guardado",
      "fragmento": "fragmento"
    },
    "etiquetaDelRecurso": "recurso",
    "tipoProcedimiento": {
      "valor": "valor",
      "procedencia": "guardado",
      "fragmento": "fragmento"
    },
    "ecli": {
      "valor": "valor",
      "procedencia": "guardado",
      "fragmento": "fragmento"
    },
    "enlaceOficial": {
      "valor": "valor",
      "procedencia": "guardado",
      "fragmento": "fragmento"
    },
    "copiaAnonimizada": true,
    "identificador": "BORME-A-2026-200-28",
    "noConstan": [
      "noConstan"
    ],
    "avisos": [
      "aviso"
    ]
  },
  "orden": "orden",
  "ambitos": [
    "ambito"
  ],
  "materias": [
    {
      "codigo": "ABCD-1234",
      "nombre": "ANA GARCIA LOPEZ",
      "motivos": [
        {
          "tipo": "tipo",
          "detalle": "detalle"
        }
      ]
    }
  ],
  "peso": {
    "nivel": "muy_alta",
    "nombreDelNivel": "nombreDelNivel",
    "razones": [
      "razone"
    ],
    "caracterizacion": "caracterizacion",
    "consolidada": true,
    "estado": "rectificada",
    "estadoEnTexto": "estadoEnTexto",
    "senales": [
      {
        "codigo": "ABCD-1234",
        "descripcion": "Integración con el CRM",
        "fragmento": "fragmento",
        "fundamento": "fundamento",
        "baseLegal": "baseLegal"
      }
    ],
    "recuentos": {
      "citadaPor": 0,
      "citadaPorIgualOSuperior": 0,
      "siguePrevias": 0
    },
    "evidencias": [
      {
        "direccion": "posterior",
        "relacion": "rectifica",
        "resolucion": {
          "id": "12345",
          "organo": "organo",
          "clase": "sentencia",
          "fecha": "2026-10-22",
          "identificador": "BORME-A-2026-200-28"
        },
        "fundamento": "fundamento",
        "fragmento": "fragmento",
        "expresion": "expresion"
      }
    ]
  },
  "citadaPor": [
    {
      "resolucion": {
        "id": "12345",
        "organo": "organo",
        "clase": "sentencia",
        "fecha": "2026-10-22",
        "identificador": "BORME-A-2026-200-28"
      },
      "relacion": "rectifica",
      "expresion": "expresion",
      "fundamento": "fundamento",
      "fragmento": "fragmento"
    }
  ],
  "cita": [
    {
      "resolucion": {
        "id": "12345",
        "organo": "organo",
        "clase": "sentencia",
        "fecha": "2026-10-22",
        "identificador": "BORME-A-2026-200-28"
      },
      "relacion": "rectifica",
      "expresion": "expresion",
      "fundamento": "fundamento",
      "fragmento": "fragmento"
    }
  ],
  "linea": {
    "hitos": [
      {
        "resolucion": {
          "id": "12345",
          "organo": "organo",
          "clase": "sentencia",
          "fecha": "2026-10-22",
          "identificador": "BORME-A-2026-200-28"
        },
        "rol": "origen",
        "conLaAnterior": {
          "resolucion": {
            "id": "12345",
            "organo": "organo",
            "clase": "sentencia",
            "fecha": "2026-10-22",
            "identificador": "BORME-A-2026-200-28"
          },
          "relacion": "rectifica"
        },
        "fundamento": "fundamento",
        "fragmento": "fragmento",
        "esLaConsultada": true
      }
    ],
    "resumen": "resumen",
    "sinHistoria": true,
    "recortada": true
  },
  "sinAnalizar": true,
  "urlOficial": "https://consultas2.oepm.es/ceo/jsp/busqueda/consultaAvanzada.xhtml"
}

Avisos automáticos (webhooks)

Que te avisemos cuando el BORME publique un acto de una sociedad que vigilas, en vez de preguntar tú cada día.

Cómo verificar la firma de un aviso

Cada aviso es un POST con la cabecera `Jurilia-Firma: t=<segundos Unix>,v1=<hex>`, donde hex = HMAC-SHA256(secreto, "<t>.<cuerpo tal cual>"). Calcúlala sobre el cuerpo SIN tocar (los bytes recibidos), compárala en tiempo constante y rechaza las marcas de tiempo de hace más de cinco minutos. `Jurilia-Idempotency-Key` es la misma en cada reintento o reenvío del mismo aviso: guárdala e ignora las repetidas. Responde 2xx cuanto antes (antes de 5 segundos) y procesa después.

Cabeceras que lleva cada aviso

CabeceraQué lleva
Jurilia-Firmat=<segundos Unix>,v1=<hex>. Con dos v1 si acabas de rotar el secreto: vale cualquiera.
Jurilia-Idempotency-KeyEl id del aviso (evt_… o res_…). Igual en reintentos y reenvíos.
Jurilia-EventoEl tipo: empresa.acto_publicado, empresa.alta_en_domicilio, empresa.resumen_diario, norma.cambio_detectado o prueba.
Jurilia-EntregaEl identificador de esta entrega, el que ves en el registro de entregas.
Jurilia-IntentoEl número de intento, desde 1.

Reintentos y desactivación

Si tu servidor no contesta 2xx se reintenta hasta cinco veces más, con espera creciente (1 min, 5 min, 30 min, 2 h y 6 h; se respeta `Retry-After` si pides más, hasta 6 h). Un 4xx que no sea 408, 425 o 429 no se reintenta. Un 410 desactiva la suscripción al instante. Cinco entregas fallidas seguidas la desactivan. Sin saldo para cobrar un aviso se pausa. Se reactiva con `POST …/reactivar`, y puedes recuperar lo perdido con `GET …/eventos` o `POST …/reenviar`.

Topes: 5 suscripciones por cuenta, 500 sociedades vigiladas por suscripción, respuesta en menos de 5 segundos.

JavaScript (Node)

import { createHmac, timingSafeEqual } from 'node:crypto';

// `cuerpoCrudo` es el Buffer/texto EXACTO que llegó (no lo vuelvas a serializar).
export function firmaValida(secreto, cabecera, cuerpoCrudo, tolerancia = 300) {
  const partes = Object.fromEntries(cabecera.split(',').map((p) => p.trim().split('=')));
  const t = Number(partes.t);
  if (!Number.isInteger(t) || Math.abs(Date.now() / 1000 - t) > tolerancia) return false;
  const esperada = createHmac('sha256', secreto).update(`${t}.${cuerpoCrudo}`).digest();
  const recibida = Buffer.from(partes.v1 ?? '', 'hex');
  return recibida.length === esperada.length && timingSafeEqual(recibida, esperada);
}

// Express: app.post('/jurilia', express.raw({ type: '*/*' }), (req, res) => {
//   if (!firmaValida(process.env.JURILIA_SECRETO, req.get('Jurilia-Firma') ?? '', req.body)) return res.sendStatus(400);
//   const clave = req.get('Jurilia-Idempotency-Key'); // guárdala: ignora las repetidas
//   res.sendStatus(204); // cuanto antes; procesa después
// });

Python

import hashlib, hmac, time

# `cuerpo_crudo` son los bytes EXACTOS que llegaron (no los vuelvas a serializar).
def firma_valida(secreto: str, cabecera: str, cuerpo_crudo: bytes, tolerancia: int = 300) -> bool:
    partes = dict(p.strip().split("=", 1) for p in cabecera.split(","))
    try:
        t = int(partes["t"])
    except (KeyError, ValueError):
        return False
    if abs(time.time() - t) > tolerancia:
        return False
    esperada = hmac.new(secreto.encode(), f"{t}.".encode() + cuerpo_crudo, hashlib.sha256).hexdigest()
    return hmac.compare_digest(esperada, partes.get("v1", ""))

# Flask:
# @app.post("/jurilia")
# def jurilia():
#     if not firma_valida(SECRETO, request.headers.get("Jurilia-Firma", ""), request.get_data()):
#         return "", 400
#     clave = request.headers["Jurilia-Idempotency-Key"]  # guárdala: ignora las repetidas
#     return "", 204  # cuanto antes; procesa después
GET/v1/dev/avisos/filtros

Los grupos de acto que se pueden pedir en un aviso

Catálogo de los grupos (`nombramientos`, `ceses`, `concurso`…) y los tipos de acto del BORME que cubre cada uno. Es de consulta gratuita, como los demás catálogos.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Errores y cómo resolverlos

  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/avisos/filtros" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/avisos/filtros",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/filtros");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "grupos": [
    {
      "grupo": "grupo",
      "tipos": [
        "tipo"
      ]
    }
  ],
  "agrupaciones": [
    "inmediato"
  ]
}
POST/v1/dev/avisos/suscripciones

Crear una suscripción de avisos

Registra una URL HTTPS que recibirá un POST firmado cuando el BORME publique un acto de una sociedad vigilada. Respuesta: la suscripción y su `secreto` EN CLARO, que no se vuelve a mostrar (se puede rotar). La URL tiene que ser https, con un dominio público (no una IP), puerto 443, sin usuario ni contraseña, y resolver a direcciones públicas. Hasta 5 suscripciones por cuenta. Cuesta 15 céntimos (alta). Después, pon sociedades en la lista con `PUT …/empresas/{empresaId}`.

Precio

15 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Después, cada aviso que tu servidor confirme con un 2xx cuesta 5 céntimos; un fallo o un reintento no se cobra. No hay cuota mensual.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idempotency-keytextonoCadena de 8 a 100 caracteres, distinta para cada creación. Repetir la misma petición con la misma clave devuelve la misma suscripción (200, sin secreto y sin cobrar) en vez de crear otra.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
urltextosíDirección HTTPS que recibirá los avisos (dominio público, puerto 443).. hasta 500 caracteres
descripciontextonoTexto libre: una etiqueta para tu referencia (suscripción de avisos) o la descripción de un caso (hasta 2.000 caracteres).. hasta 120 caracteres
gruposlista de textonoFiltro por tipo de acto. Grupos: nombramientos, ceses, poderes, domicilio, capital, denominacion, objeto_social, concurso, disolucion, extincion, reestructuracion, constitucion, cuentas, unipersonalidad, hoja_registral, otros. Sin él, todos los actos.
agrupaciontextonoinmediato (por defecto): un aviso por acto. diaria: un solo aviso al día con todos los actos.. uno de: inmediato, diaria. por defecto: inmediato

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 url_de_aviso_no_valida — La dirección del aviso no cumple las reglas. La URL debe ser https, con un nombre de dominio público (no una IP), puerto 443 y sin usuario ni contraseña, y debe resolver a direcciones públicas.
  • 400 destino_de_aviso_no_seguro — El destino no es público o no se puede resolver. El destino no es público o no se puede resolver. Usa un dominio público con certificado válido.
  • 400 filtro_de_actos_no_valido — Algún grupo de acto del filtro no existe. Pide los grupos de acto válidos con `GET /v1/dev/avisos/filtros`.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/avisos/suscripciones" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://hooks.miempresa.es/jurilia","descripcion":"Integración con el CRM","grupos":["nombramientos","ceses","concurso"],"agrupacion":"inmediato"}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"url":"https://hooks.miempresa.es/jurilia","descripcion":"Integración con el CRM","grupos":["nombramientos","ceses","concurso"],"agrupacion":"inmediato"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones");
const r = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"url":"https://hooks.miempresa.es/jurilia","descripcion":"Integración con el CRM","grupos":["nombramientos","ceses","concurso"],"agrupacion":"inmediato"}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "suscripcion": {
    "id": "12345",
    "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
    "descripcion": "Integración con el CRM",
    "gruposDeActo": [
      "gruposDeActo"
    ],
    "agrupacion": "inmediato",
    "estado": "activa",
    "motivoDesactivacion": "motivoDesactivacion",
    "fallosSeguidos": 0,
    "ultimaEntregaEn": "2026-10-22T08:00:03.000Z",
    "creadaEn": "2026-10-22T08:00:00.000Z",
    "secretoPista": "xxxx",
    "empresasVigiladas": 0
  },
  "secreto": "whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "repetida": true
}
GET/v1/dev/avisos/suscripciones

Listar tus suscripciones de avisos

Administración: no consulta datos y no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/avisos/suscripciones" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "suscripciones": [
    {
      "id": "12345",
      "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "descripcion": "Integración con el CRM",
      "gruposDeActo": [
        "gruposDeActo"
      ],
      "agrupacion": "inmediato",
      "estado": "activa",
      "motivoDesactivacion": "motivoDesactivacion",
      "fallosSeguidos": 0,
      "ultimaEntregaEn": "2026-10-22T08:00:03.000Z",
      "creadaEn": "2026-10-22T08:00:00.000Z",
      "secretoPista": "xxxx",
      "empresasVigiladas": 0
    }
  ]
}
GET/v1/dev/avisos/suscripciones/{id}

Ver una suscripción

Administración: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "12345",
  "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
  "descripcion": "Integración con el CRM",
  "gruposDeActo": [
    "gruposDeActo"
  ],
  "agrupacion": "inmediato",
  "estado": "activa",
  "motivoDesactivacion": "motivoDesactivacion",
  "fallosSeguidos": 0,
  "ultimaEntregaEn": "2026-10-22T08:00:03.000Z",
  "creadaEn": "2026-10-22T08:00:00.000Z",
  "secretoPista": "xxxx",
  "empresasVigiladas": 0
}
DELETE/v1/dev/avisos/suscripciones/{id}

Borrar una suscripción (con sus sociedades vigiladas, eventos y entregas)

Administración: no se cobra. Deja de recibirse todo aviso de ella al instante.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "borrada": true
}
POST/v1/dev/avisos/suscripciones/{id}/reactivar

Reactivar una suscripción pausada o desactivada

Una suscripción se pausa si no hay saldo para cobrar un aviso y se desactiva tras 5 entregas fallidas seguidas, o al instante si el destino responde 410. Reactivarla pone los fallos a cero. Administración: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/reactivar" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/reactivar",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/reactivar");
const r = await fetch(url, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "12345",
  "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
  "descripcion": "Integración con el CRM",
  "gruposDeActo": [
    "gruposDeActo"
  ],
  "agrupacion": "inmediato",
  "estado": "activa",
  "motivoDesactivacion": "motivoDesactivacion",
  "fallosSeguidos": 0,
  "ultimaEntregaEn": "2026-10-22T08:00:03.000Z",
  "creadaEn": "2026-10-22T08:00:00.000Z",
  "secretoPista": "xxxx",
  "empresasVigiladas": 0
}
POST/v1/dev/avisos/suscripciones/{id}/secreto

Rotar el secreto de firma

Crea un secreto nuevo (que se muestra una sola vez); el anterior deja de valer al instante. Administración: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/secreto" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/secreto",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/secreto");
const r = await fetch(url, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "secreto": "whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
POST/v1/dev/avisos/suscripciones/{id}/probar

Mandar un aviso de prueba ahora mismo

Manda a tu URL un aviso `prueba` con la misma firma y cabeceras que uno de verdad y dice qué contestó (`codigo`). Queda en el registro de entregas. Cuesta 1 céntimo y no se cobra además como aviso entregado (5 céntimos).

Precio

1 céntimo por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/probar" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/probar",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/probar");
const r = await fetch(url, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "entregaId": "entregaId",
  "entregada": true,
  "codigo": 0,
  "error": "error"
}
PUT/v1/dev/avisos/suscripciones/{id}/empresas/{empresaId}

Poner una sociedad en la lista vigilada

Desde hoy: lo publicado antes no se avisa. Sólo sociedades (un empresario individual es una persona física y no se vigila). Hasta 500 por suscripción. Cuesta 15 céntimos cada llamada servida, aunque la sociedad ya estuviera en la lista (`nueva: false`).

Precio

15 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X PUT "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.put(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345");
const r = await fetch(url, {
  method: "PUT",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "nueva": true,
  "total": 1
}
DELETE/v1/dev/avisos/suscripciones/{id}/empresas/{empresaId}

Quitar una sociedad de la lista vigilada

Administración: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.
empresaIdtextosíIdentificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "quitada": true
}
GET/v1/dev/avisos/suscripciones/{id}/empresas

Las sociedades vigiladas de una suscripción

Administración: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "empresas": [
    {
      "empresaId": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "vigiladaDesde": "vigiladaDesde"
    }
  ]
}
PUT/v1/dev/avisos/suscripciones/{id}/domicilios/{slug}

Vigilar un domicilio: avisos de las sociedades nuevas en esa dirección

Cuando el BORME publique que una SOCIEDAD se constituye o se traslada a esa dirección, llegará un aviso `empresa.alta_en_domicilio` (con la sociedad, el acto y el boletín). Desde hoy: lo publicado antes no se avisa; y sólo si la sociedad no tenía ya esa dirección justo antes. Es un hecho publicado, no una señal de nada: en un centro de negocios es lo normal. El filtro por `grupos` de la suscripción no se aplica a los domicilios. Sólo domicilios con sociedades en lo cargado. Hasta 100 por suscripción. Cuesta 15 céntimos cada llamada servida, aunque el domicilio ya estuviera (`nuevo: false`).

Precio

15 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.
slugtextosíSlug del domicilio, tal como lo devuelve la API (por ejemplo en GET /v1/dev/empresas/domicilios/{slug} o en un nodo del mapa).. al menos 1 caracteres; hasta 320 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 domicilio_no_vigilable — El domicilio no tiene sociedades en lo cargado, o el identificador no es un slug de domicilio válido. Usa el slug que devuelve la API (por ejemplo en `GET /v1/dev/empresas/domicilios/{slug}`) de un domicilio con sociedades.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X PUT "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/domicilios/calle-mayor-1-madrid" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.put(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/domicilios/calle-mayor-1-madrid",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/domicilios/calle-mayor-1-madrid");
const r = await fetch(url, {
  method: "PUT",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "nuevo": true,
  "total": 1
}
DELETE/v1/dev/avisos/suscripciones/{id}/domicilios/{slug}

Dejar de vigilar un domicilio

Administración: no se cobra. `quitado: false` si no estaba vigilado.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.
slugtextosíSlug del domicilio, tal como lo devuelve la API (por ejemplo en GET /v1/dev/empresas/domicilios/{slug} o en un nodo del mapa).. al menos 1 caracteres; hasta 320 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 domicilio_no_vigilable — El domicilio no tiene sociedades en lo cargado, o el identificador no es un slug de domicilio válido. Usa el slug que devuelve la API (por ejemplo en `GET /v1/dev/empresas/domicilios/{slug}`) de un domicilio con sociedades.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/domicilios/calle-mayor-1-madrid" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/domicilios/calle-mayor-1-madrid",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/domicilios/calle-mayor-1-madrid");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "quitado": true
}
GET/v1/dev/avisos/suscripciones/{id}/domicilios

Los domicilios vigilados de una suscripción

Administración: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/domicilios" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/domicilios",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/domicilios");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "domicilios": [
    {
      "slug": "ana-garcia-lopez",
      "domicilio": "domicilio",
      "vigiladoDesde": "vigiladoDesde"
    }
  ]
}
GET/v1/dev/avisos/normas

Las normas que se pueden vigilar con un aviso

Las normas de la biblioteca que la ley viva de Jurilia vigila (BOE y actos de la UE). Sólo de ellas se detectan cambios por artículo, con el texto de antes y el de después tal como los tiene la biblioteca. Es de consulta gratuita, como los demás catálogos.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Errores y cómo resolverlos

  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/avisos/normas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/avisos/normas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/normas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "normas": [
    {
      "id": "12345",
      "titulo": "titulo",
      "origen": "boe",
      "urlOficial": "https://consultas2.oepm.es/ceo/jsp/busqueda/consultaAvanzada.xhtml"
    }
  ]
}
PUT/v1/dev/avisos/suscripciones/{id}/normas/{norma}

Vigilar una norma: aviso cuando cambia un artículo

Cuando la ley viva de Jurilia detecte que cambia un artículo de esa norma, llegará un aviso `norma.cambio_detectado` con el antes y el después del artículo (los dos textos de la biblioteca, sin resumir ni interpretar), la clase del cambio (`modificado`, `nuevo`, `retirado`), la fecha desde la que rige y el enlace oficial. Misma firma `Jurilia-Firma`, misma clave de idempotencia y mismos reintentos que los demás avisos. Sólo lo detectado desde ahora: el historial de reformas no se envía. El filtro por `grupos` no se aplica a las normas. Hasta 50 por suscripción. Cuesta 15 céntimos cada llamada servida, aunque la norma ya estuviera (`nueva: false`); cada aviso entregado se cobra como los demás.

Precio

15 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.
normatextosíIdentificador de la norma, tal como lo devuelve GET /v1/dev/avisos/normas (por ejemplo BOE-A-2015-11430).. al menos 3 caracteres; hasta 64 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X PUT "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/normas/x" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.put(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/normas/x",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/normas/x");
const r = await fetch(url, {
  method: "PUT",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "nueva": true,
  "total": 1
}
DELETE/v1/dev/avisos/suscripciones/{id}/normas/{norma}

Dejar de vigilar una norma

Administración: no se cobra. `quitada: false` si no estaba vigilada.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.
normatextosíIdentificador de la norma, tal como lo devuelve GET /v1/dev/avisos/normas (por ejemplo BOE-A-2015-11430).. al menos 3 caracteres; hasta 64 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/normas/x" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/normas/x",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/normas/x");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "quitada": true
}
GET/v1/dev/avisos/suscripciones/{id}/normas

Las normas vigiladas de una suscripción

Administración: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/normas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/normas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/normas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "normas": [
    {
      "id": "12345",
      "titulo": "titulo",
      "origen": "boe",
      "urlOficial": "https://consultas2.oepm.es/ceo/jsp/busqueda/consultaAvanzada.xhtml",
      "vigiladaDesde": "vigiladaDesde"
    }
  ]
}
GET/v1/dev/avisos/suscripciones/{id}/entregas

El registro de entregas: qué se mandó, con qué resultado y cuándo se reintenta

Las entregas de los últimos 30 días, de la más reciente a la más antigua: estado, intentos, código del destino, error, coste y la clave de idempotencia. `antes` (una fecha-hora ISO) pagina. Es lo mismo que ves en el panel. Administración: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.
limiteenteronoMáximo de resultados.. mínimo 1; máximo 200. por defecto: 50 (avisos: entregas) · 100 (eventos) · 20 (búsquedas)
antestextonoFecha-hora ISO: sólo lo anterior (paginación).. hasta 40 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/entregas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/entregas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/entregas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "entregas": [
    {
      "id": "12345",
      "tipo": "evento",
      "estado": "pendiente",
      "intentos": 0,
      "proximoIntentoEn": "proximoIntentoEn",
      "ultimoCodigo": 0,
      "ultimoError": "ultimoError",
      "costeCentimos": 0,
      "creadaEn": "2026-10-22T08:00:00.000Z",
      "entregadaEn": "2026-10-22T08:00:03.000Z",
      "idDelAviso": "idDelAviso"
    }
  ],
  "siguienteAntes": "siguienteAntes"
}
GET/v1/dev/avisos/suscripciones/{id}/eventos

Los eventos de una suscripción desde una fecha (para recuperar los que se perdieron)

Las inscripciones del BORME de tus sociedades vigiladas, tal como se avisaron o se habrían avisado, del más antiguo al más nuevo y con cursor (`cursor`). Útil si tu destino estuvo caído más de lo que cubren los reintentos. Cada evento lleva el mismo `id` que su aviso. Cuesta 3 céntimos por página. Para que te los vuelva a mandar, usa `POST …/reenviar`.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.
desdefecha (AAAA-MM-DD)síFecha de inicio, AAAA-MM-DD.
cursortextonoCursor opaco de la página siguiente (de siguienteCursor o de la cabecera X-Jurilia-Siguiente-Cursor). Sustituye a pagina.. hasta 100 caracteres
limiteenteronoMáximo de resultados.. mínimo 1; máximo 500. por defecto: 50 (avisos: entregas) · 100 (eventos) · 20 (búsquedas)

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/eventos?desde=2026-10-01" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/eventos",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    params={"desde":"2026-10-01"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/eventos");
url.search = new URLSearchParams({"desde":"2026-10-01"});
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "eventos": [
    {
      "id": "12345",
      "empresaId": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "fecha": "2026-10-22",
      "numero": 7,
      "boletin": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "tipos": [
        "tipo"
      ],
      "cargos": [
        "Adm. Unico"
      ],
      "domicilio": "domicilio"
    }
  ],
  "siguienteCursor": "siguienteCursor"
}
POST/v1/dev/avisos/suscripciones/{id}/reenviar

Volver a pedir que se manden los avisos desde una fecha

Pone en cola de nuevo los avisos de los eventos desde `desde` (como mucho 30 días atrás y 500 eventos). Cada uno sale con el MISMO `id` que la primera vez, para que descartes los que ya tenías. Llamar no cuesta; se cobra cada aviso al entregarse, como siempre.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la suscripción.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
desdefecha (AAAA-MM-DD)síFecha de inicio, AAAA-MM-DD.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 reenvio_no_valido — La fecha del reenvío es futura o anterior a 30 días. Pide una fecha de los últimos 30 días y no futura, en formato AAAA-MM-DD.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 suscripcion_de_avisos_no_encontrada — No hay esa suscripción de avisos en tu cuenta. Lista tus suscripciones con `GET /v1/dev/avisos/suscripciones` y usa el `id` que devuelve.
  • 409 limite_de_avisos — Has alcanzado un tope: cinco suscripciones por cuenta o 500 sociedades vigiladas por suscripción. Borra una suscripción o una sociedad vigilada que ya no uses. Los topes están en la documentación de avisos.
  • 422 empresa_no_vigilable — La sociedad no está en lo cargado, o es un empresario individual (una persona física, que no se vigila). Sólo se vigilan sociedades que estén en lo cargado del BORME. Busca su identificador con `GET /v1/dev/empresas/resolver?q=`.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/reenviar" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"desde":"2026-10-20"}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/reenviar",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"desde":"2026-10-20"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/avisos/suscripciones/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/reenviar");
const r = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"desde":"2026-10-20"}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "encolados": 0
}

Casos de investigación

Una carpeta privada donde juntas sociedades, personas y domicilios, anotas lo tuyo y sacas la cronología cruzada, el mapa de conexiones y un informe con huella verificable. Lo mismo que «Casos» de la web y la aplicación de Jurilia Empresas, guardado por tu cuenta de desarrollador.

GET/v1/dev/casos

Listar tus casos de investigación

Tus casos, del que tocaste más recientemente al más antiguo, con cuántos elementos tiene cada uno. `estado` filtra por `abierto` o `cerrado`. Hasta 250 casos por cuenta. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
estadotextonoSólo los casos abierto o cerrado. Sin él, todos.. uno de: abierto, cerrado

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/casos" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/casos",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "casos": [
    {
      "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
      "nombre": "Investigación proveedores 2026",
      "descripcion": "Integración con el CRM",
      "estado": "abierto",
      "cerradoEn": "cerradoEn",
      "creadoEn": "2026-10-22T08:00:00.000Z",
      "actualizadoEn": "2026-10-22T00:00:00.000Z",
      "totalElementos": 0
    }
  ]
}
POST/v1/dev/casos

Abrir un caso de investigación

Crea un caso vacío. Después, añade sociedades, personas y domicilios con `POST /v1/dev/casos/{id}/elementos`. Con `Idempotency-Key`, repetir la misma petición devuelve el mismo caso (200) en vez de crear otro. Hasta 250 casos por cuenta (409 al pasarlos). Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idempotency-keytextonoCadena de 8 a 100 caracteres, distinta para cada creación. Repetir la misma petición con la misma clave devuelve lo que ya se creó (200, Idempotent-Replayed: true) en vez de crear otra cosa.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
nombretextosíNombre del caso (hasta 120 caracteres).. al menos 1 caracteres; hasta 120 caracteres
descripciontextonoDescripción libre (hasta 2.000 caracteres).. hasta 2000 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 idempotency_key_no_valida — La cabecera Idempotency-Key no es válida. Manda una cadena de 8 a 100 caracteres (letras, cifras, guiones o puntos), distinta para cada creación; un UUID sirve.
  • 400 nombre_de_caso_no_valido — El caso necesita un nombre de hasta 120 caracteres. Manda `nombre` con entre 1 y 120 caracteres.
  • 400 texto_de_caso_largo — La descripción (2.000 caracteres) o la nota (5.000) es demasiado larga. Acorta el texto: la descripción admite 2.000 caracteres y cada nota, 5.000.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 409 limite_de_casos — Has llegado al máximo de 250 casos por cuenta. Borra algún caso que ya no uses (`DELETE /v1/dev/casos/{id}`) o saca antes su informe.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/casos" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Investigación proveedores 2026","descripcion":"Diligencia debida de los tres proveedores nuevos."}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/casos",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"nombre":"Investigación proveedores 2026","descripcion":"Diligencia debida de los tres proveedores nuevos."},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos");
const r = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"nombre":"Investigación proveedores 2026","descripcion":"Diligencia debida de los tres proveedores nuevos."}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
  "nombre": "Investigación proveedores 2026",
  "descripcion": "Integración con el CRM",
  "estado": "abierto",
  "cerradoEn": "cerradoEn",
  "creadoEn": "2026-10-22T08:00:00.000Z",
  "actualizadoEn": "2026-10-22T00:00:00.000Z",
  "totalElementos": 0,
  "nota": "nota",
  "elementos": [
    {
      "tipo": "empresa",
      "referencia": "12345",
      "nota": "nota",
      "anadidoEn": "anadidoEn",
      "disponible": true
    }
  ]
}
GET/v1/dev/casos/{id}

Ver un caso con sus elementos

El caso con sus sociedades, personas y domicilios y la nota que escribiste sobre cada uno. `referencia` es el id de la sociedad o el slug de la persona o del domicilio. Una persona que ejerció su oposición o su supresión sale con `disponible: false`. Para los nombres y los hechos de cada elemento, usa `…/cronologia`. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
  "nombre": "Investigación proveedores 2026",
  "descripcion": "Integración con el CRM",
  "estado": "abierto",
  "cerradoEn": "cerradoEn",
  "creadoEn": "2026-10-22T08:00:00.000Z",
  "actualizadoEn": "2026-10-22T00:00:00.000Z",
  "totalElementos": 0,
  "nota": "nota",
  "elementos": [
    {
      "tipo": "empresa",
      "referencia": "12345",
      "nota": "nota",
      "anadidoEn": "anadidoEn",
      "disponible": true
    }
  ]
}
PATCH/v1/dev/casos/{id}

Editar el nombre, la descripción o la nota de un caso

Cambia sólo lo que mandas. Un caso cerrado no se edita (409 `caso_cerrado`): ábrelo antes con `…/reabrir`. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
nombretextonoNombre nuevo (hasta 120 caracteres).. al menos 1 caracteres; hasta 120 caracteres
descripciontextonoDescripción nueva (hasta 2.000 caracteres).. hasta 2000 caracteres
notatextonoTu nota sobre el caso (hasta 5.000 caracteres). Vacía, la borra.. hasta 5000 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 nombre_de_caso_no_valido — El caso necesita un nombre de hasta 120 caracteres. Manda `nombre` con entre 1 y 120 caracteres.
  • 400 texto_de_caso_largo — La descripción (2.000 caracteres) o la nota (5.000) es demasiado larga. Acorta el texto: la descripción admite 2.000 caracteres y cada nota, 5.000.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 409 caso_cerrado — El caso está cerrado y es de sólo lectura. Reábrelo con `POST /v1/dev/casos/{id}/reabrir` para añadir, quitar, anotar o editar. Leerlo, sacar su cronología y su informe sí se puede.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X PATCH "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nota":"Pendiente de pedir las cuentas anuales."}'

Python

import os
import requests

r = requests.patch(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"nota":"Pendiente de pedir las cuentas anuales."},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34");
const r = await fetch(url, {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"nota":"Pendiente de pedir las cuentas anuales."}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
  "nombre": "Investigación proveedores 2026",
  "descripcion": "Integración con el CRM",
  "estado": "abierto",
  "cerradoEn": "cerradoEn",
  "creadoEn": "2026-10-22T08:00:00.000Z",
  "actualizadoEn": "2026-10-22T00:00:00.000Z",
  "totalElementos": 0,
  "nota": "nota",
  "elementos": [
    {
      "tipo": "empresa",
      "referencia": "12345",
      "nota": "nota",
      "anadidoEn": "anadidoEn",
      "disponible": true
    }
  ]
}
DELETE/v1/dev/casos/{id}

Borrar un caso

Borra el caso con sus elementos y notas, también si está cerrado. No se puede deshacer. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "borrado": true
}
POST/v1/dev/casos/{id}/cerrar

Cerrar un caso

Pasa el caso a sólo lectura: se sigue pudiendo leer, sacar la cronología y el informe y borrar, pero no añadir, quitar ni anotar. Cerrar uno ya cerrado no cambia nada. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/cerrar" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/cerrar",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/cerrar");
const r = await fetch(url, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
  "nombre": "Investigación proveedores 2026",
  "descripcion": "Integración con el CRM",
  "estado": "abierto",
  "cerradoEn": "cerradoEn",
  "creadoEn": "2026-10-22T08:00:00.000Z",
  "actualizadoEn": "2026-10-22T00:00:00.000Z",
  "totalElementos": 0,
  "nota": "nota",
  "elementos": [
    {
      "tipo": "empresa",
      "referencia": "12345",
      "nota": "nota",
      "anadidoEn": "anadidoEn",
      "disponible": true
    }
  ]
}
POST/v1/dev/casos/{id}/reabrir

Reabrir un caso cerrado

Vuelve a dejar el caso editable. Reabrir uno abierto no cambia nada. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/reabrir" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/reabrir",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/reabrir");
const r = await fetch(url, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
  "nombre": "Investigación proveedores 2026",
  "descripcion": "Integración con el CRM",
  "estado": "abierto",
  "cerradoEn": "cerradoEn",
  "creadoEn": "2026-10-22T08:00:00.000Z",
  "actualizadoEn": "2026-10-22T00:00:00.000Z",
  "totalElementos": 0,
  "nota": "nota",
  "elementos": [
    {
      "tipo": "empresa",
      "referencia": "12345",
      "nota": "nota",
      "anadidoEn": "anadidoEn",
      "disponible": true
    }
  ]
}
POST/v1/dev/casos/{id}/elementos

Añadir una sociedad, una persona o un domicilio al caso

Se comprueba contra el BORME que existe y se puede mostrar: una sociedad cargada (un empresario individual es una persona física y no entra), una persona que aparece y no ejerció su oposición o su supresión, un domicilio con sociedades. Añadir algo que ya está responde 200 `ya_estaba`. Hasta 1.000 elementos por caso. Cuesta 3 céntimos (se cobra sólo si se añade o ya estaba; si no se puede añadir, 422 sin cobro). Para añadir varios del mapa de una vez: `…/nodos`.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
tipotextosíQué es el elemento: empresa, persona o domicilio.. uno de: empresa, persona, domicilio
referenciatextosíEl id de la sociedad, o el slug de la persona o del domicilio (el mismo de /v1/dev/personas/{slug} y de los nodos del mapa).. al menos 1 caracteres; hasta 300 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 409 caso_cerrado — El caso está cerrado y es de sólo lectura. Reábrelo con `POST /v1/dev/casos/{id}/reabrir` para añadir, quitar, anotar o editar. Leerlo, sacar su cronología y su informe sí se puede.
  • 409 limite_de_elementos_del_caso — Un caso admite hasta 1.000 elementos. Quita elementos que ya no hagan falta o abre otro caso para el resto.
  • 422 elemento_no_anadible — Lo que se quiere añadir no está en lo cargado del BORME, es un empresario individual o es una persona que ejerció su oposición o su supresión. Comprueba la referencia (id de la sociedad, o slug de la persona o del domicilio). Un empresario individual es una persona física y no se añade; una persona que ejerció su derecho de oposición o de supresión ya no existe para el directorio. No se cobra.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/elementos" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tipo":"empresa","referencia":"12345"}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/elementos",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"tipo":"empresa","referencia":"12345"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/elementos");
const r = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"tipo":"empresa","referencia":"12345"}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "resultado": "ya_estaba",
  "total": 1
}
POST/v1/dev/casos/{id}/nodos

Añadir al caso lo que se ve en el mapa de conexiones

Hasta 50 nodos del mapa (`e:<id>`, `p:<slug>`, `d:<clave>`, como los devuelve `GET /v1/dev/red`), cada uno con las mismas comprobaciones que añadir uno. Uno que no se puede añadir (un empresario individual, una persona excluida, un valor mal formado) se cuenta en `omitidos` y no impide los demás. `lleno` indica que el caso llegó a su tope. Cuesta 30 céntimos por lote servido.

Precio

30 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
nodoslista de textosíLos nodos a añadir (de 1 a 50).

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 409 caso_cerrado — El caso está cerrado y es de sólo lectura. Reábrelo con `POST /v1/dev/casos/{id}/reabrir` para añadir, quitar, anotar o editar. Leerlo, sacar su cronología y su informe sí se puede.
  • 409 limite_de_elementos_del_caso — Un caso admite hasta 1.000 elementos. Quita elementos que ya no hagan falta o abre otro caso para el resto.
  • 422 elemento_no_anadible — Lo que se quiere añadir no está en lo cargado del BORME, es un empresario individual o es una persona que ejerció su oposición o su supresión. Comprueba la referencia (id de la sociedad, o slug de la persona o del domicilio). Un empresario individual es una persona física y no se añade; una persona que ejerció su derecho de oposición o de supresión ya no existe para el directorio. No se cobra.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/nodos" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nodos":["e:12345","e:67890","p:ana-garcia-lopez"]}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/nodos",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"nodos":["e:12345","e:67890","p:ana-garcia-lopez"]},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/nodos");
const r = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"nodos":["e:12345","e:67890","p:ana-garcia-lopez"]}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "anadidos": 0,
  "yaEstaban": 0,
  "omitidos": 0,
  "lleno": true
}
DELETE/v1/dev/casos/{id}/elementos/{tipo}/{referencia}

Quitar un elemento del caso

Quita el elemento y su nota. En un caso cerrado, 409. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.
tipotextosíQué es el elemento: empresa, persona o domicilio.. uno de: empresa, persona, domicilio
referenciatextosíEl id de la sociedad, o el slug de la persona o del domicilio (el mismo de /v1/dev/personas/{slug} y de los nodos del mapa).. al menos 1 caracteres; hasta 300 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 404 elemento_del_caso_no_encontrado — Ese elemento no está en el caso. Mira los elementos del caso con `GET /v1/dev/casos/{id}`: la `referencia` es el id de la sociedad o el slug de la persona o del domicilio.
  • 409 caso_cerrado — El caso está cerrado y es de sólo lectura. Reábrelo con `POST /v1/dev/casos/{id}/reabrir` para añadir, quitar, anotar o editar. Leerlo, sacar su cronología y su informe sí se puede.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/elementos/persona/ana-garcia-lopez" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/elementos/persona/ana-garcia-lopez",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/elementos/persona/ana-garcia-lopez");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "quitado": true
}
PUT/v1/dev/casos/{id}/elementos/{tipo}/{referencia}/nota

Anotar un elemento del caso

Guarda tu nota sobre ese elemento (hasta 5.000 caracteres); una nota vacía la borra. La nota es tuya: no es un dato del BORME, no entra en la cronología y en el informe se marca como nota del usuario. En un caso cerrado, 409. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.
tipotextosíQué es el elemento: empresa, persona o domicilio.. uno de: empresa, persona, domicilio
referenciatextosíEl id de la sociedad, o el slug de la persona o del domicilio (el mismo de /v1/dev/personas/{slug} y de los nodos del mapa).. al menos 1 caracteres; hasta 300 caracteres

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
notatextosíTu nota (hasta 5.000 caracteres). Vacía, la borra.. hasta 5000 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 texto_de_caso_largo — La descripción (2.000 caracteres) o la nota (5.000) es demasiado larga. Acorta el texto: la descripción admite 2.000 caracteres y cada nota, 5.000.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 404 elemento_del_caso_no_encontrado — Ese elemento no está en el caso. Mira los elementos del caso con `GET /v1/dev/casos/{id}`: la `referencia` es el id de la sociedad o el slug de la persona o del domicilio.
  • 409 caso_cerrado — El caso está cerrado y es de sólo lectura. Reábrelo con `POST /v1/dev/casos/{id}/reabrir` para añadir, quitar, anotar o editar. Leerlo, sacar su cronología y su informe sí se puede.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X PUT "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/elementos/empresa/12345/nota" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nota":"Pedir la escritura de constitución."}'

Python

import os
import requests

r = requests.put(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/elementos/empresa/12345/nota",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"nota":"Pedir la escritura de constitución."},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/elementos/empresa/12345/nota");
const r = await fetch(url, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"nota":"Pedir la escritura de constitución."}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "nota": "nota"
}
GET/v1/dev/casos/{id}/cronologia

La cronología cruzada del caso

Los hechos publicados de todos los elementos del caso en una sola línea de tiempo, cada uno con su fuente oficial: actos del BORME (constitución, cargos, capital, domicilio, denominación, disolución, concurso), contratos públicos y subvenciones. Los hechos que salen en la ficha de varios elementos se fusionan. Filtros: `categoria` (separadas por comas: constitucion, cargos, capital, domicilio, denominacion, situacion, contratos, subvenciones), `desde` y `hasta`, `elemento` (`tipo:referencia`) y `orden` (`reciente` por defecto o `antiguo`). Se pagina con `cursor`. Sólo se leen los hechos de los primeros 200 elementos (`sinLeer` dice cuántos quedan) y los 150 más recientes de cada uno (`recortados`). Sólo hechos publicados: nunca una valoración. Cuesta 15 céntimos por llamada.

Precio

15 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.
categoriatextonoSólo hechos de estas categorías, separadas por comas: constitucion, cargos, capital, domicilio, denominacion, situacion, contratos, subvenciones.. hasta 200 caracteres
desdefecha (AAAA-MM-DD)noSólo hechos desde esta fecha, AAAA-MM-DD.
hastafecha (AAAA-MM-DD)noSólo hechos hasta esta fecha, AAAA-MM-DD.
elementotextonoSólo los hechos de un elemento del caso, como tipo:referencia (por ejemplo empresa:12345).. al menos 3 caracteres; hasta 320 caracteres
ordentextonoreciente (por defecto) o antiguo.. uno de: reciente, antiguo. por defecto: reciente
cursortextonoCursor de la página siguiente (lo da siguienteCursor).. hasta 100 caracteres
limiteenteronoHechos por página, de 1 a 500 (100 por defecto).. mínimo 1; máximo 500. por defecto: 50 (avisos: entregas) · 100 (eventos) · 20 (búsquedas)

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 503 semaforo_saturado — Hay demasiadas búsquedas o informes calculándose a la vez en este momento. Reintenta en unos segundos con espera creciente. No se ha cobrado nada.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/cronologia" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/cronologia",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/cronologia");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "hechos": [
    {
      "fecha": "2026-10-22",
      "clase": "constitucion",
      "categoria": "constitucion",
      "origen": "borme",
      "descripcion": "Integración con el CRM",
      "elementos": [
        "empresa:12345"
      ],
      "datos": {
        "empresaId": "12345",
        "denominacion": "ACME SERVICIOS SL",
        "cargo": "Adm. Unico",
        "nombre": "ANA GARCIA LOPEZ",
        "domicilio": "domicilio",
        "importeCentimos": 1250000,
        "organo": "organo",
        "objeto": "objeto",
        "nuevaDenominacion": "nuevaDenominacion"
      },
      "fuente": {
        "identificador": "BORME-A-2026-200-28",
        "url": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf"
      }
    }
  ],
  "total": 1,
  "coinciden": 0,
  "elementos": [
    {
      "tipo": "empresa",
      "referencia": "referencia",
      "nombre": "ANA GARCIA LOPEZ",
      "disponible": true
    }
  ],
  "recortados": [
    "recortado"
  ],
  "sinLeer": 0,
  "sinFecha": 0,
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/casos/{id}/red

El mapa de conexiones del caso

Arranca el mapa con los doce primeros elementos del caso y devuelve la expansión de cada uno (sus vecinos, con lo que los une y el acto del BORME que lo prueba), como `GET /v1/dev/red`. `red` es el mismo mapa ya aplanado (hasta 250 nodos y 1.500 aristas), listo para `POST /v1/dev/exportaciones/red` (CSV o GraphML para i2, Maltego o Gephi). Las personas son NOMBRES, no identidades: una conexión no implica relación personal ni irregularidad. Cuesta 30 céntimos por llamada.

Precio

30 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 503 semaforo_saturado — Hay demasiadas búsquedas o informes calculándose a la vez en este momento. Reintenta en unos segundos con espera creciente. No se ha cobrado nada.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/red" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/red",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/red");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "nombre": "ANA GARCIA LOPEZ",
  "centros": [
    {
      "nodo": {
        "valor": "valor",
        "tipo": "empresa",
        "nombre": "ANA GARCIA LOPEZ",
        "nombreLegible": "Ana García López",
        "provincia": "MADRID",
        "provinciaLegible": "Madrid",
        "extinguida": true,
        "sociedades": 0,
        "sociedadesAcotadas": true,
        "grado": 0,
        "comun": true,
        "rutaWeb": "rutaWeb"
      },
      "vecinos": [
        {
          "valor": "valor",
          "tipo": "empresa",
          "nombre": "ANA GARCIA LOPEZ",
          "provincia": "MADRID",
          "provinciaLegible": "Madrid",
          "extinguida": true,
          "sociedades": 0,
          "sociedadesAcotadas": true,
          "grado": 0,
          "comun": true,
          "rutaWeb": "rutaWeb",
          "union": {
            "tipo": "cargo",
            "cargo": "Adm. Unico"
          }
        }
      ],
      "total": 1
    }
  ],
  "omitidos": 0,
  "red": {
    "nodos": [
      "nodo"
    ],
    "aristas": [
      [
        null
      ]
    ],
    "recortada": true
  }
}
GET/v1/dev/casos/{id}/informe

El informe del caso en PDF, con huella verificable

El mismo informe que genera la aplicación: portada, cronología cruzada con la fuente de cada hecho, resumen de cada sociedad (hasta 30), tus notas (marcadas como tuyas, nunca mezcladas con los hechos), anexo de fuentes y la huella SHA-256 impresa al pie (cabecera `X-Huella-Sha256`). Se aporta a terceros: la marca de agua no lleva tu nombre ni tu correo. La huella se comprueba en `GET /v1/dev/empresas/verificar-informe/{huella}`. Un caso cerrado también se exporta. No afirma valor probatorio: sólo permite comprobar que no se ha alterado desde que se generó. Cuesta 400 céntimos por informe.

Precio

400 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador del caso.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 503 semaforo_saturado — Hay demasiadas búsquedas o informes calculándose a la vez en este momento. Reintenta en unos segundos con espera creciente. No se ha cobrado nada.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -o informe.pdf "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/informe" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/informe",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
open("informe.pdf", "wb").write(r.content)

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/casos/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/informe");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
await (await import("node:fs/promises")).writeFile("informe.pdf", Buffer.from(await r.arrayBuffer()));

Respuesta de ejemplo

Esta ruta devuelve un fichero (PDF, Excel o CSV), no JSON.

Listas, etiquetas, notas, cartera y radar

Tu espacio de trabajo: agrupa sociedades en listas, etiquétalas, escribe notas, síguelas en una cartera con semáforo y lee el radar de lo que el BORME ha publicado de lo que vigilas. Sólo sociedades: nunca una etiqueta ni una nota sobre una persona física.

GET/v1/dev/listas

Listar tus listas de sociedades

Tus listas, de la más reciente a la más antigua, con cuántas sociedades tiene cada una. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/listas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/listas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/listas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "listas": [
    {
      "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
      "nombre": "Clientes en riesgo",
      "creadaEn": "2026-10-22T08:00:00.000Z",
      "totalEmpresas": 0
    }
  ]
}
POST/v1/dev/listas

Crear una lista de sociedades

Una lista agrupa sociedades para seguirlas juntas en la cartera, exportarlas a CSV o vigilarlas. Hasta 100 listas por cuenta. Con `Idempotency-Key`, repetir la misma petición devuelve la misma lista (200). Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idempotency-keytextonoCadena de 8 a 100 caracteres, distinta para cada creación. Repetir la misma petición con la misma clave devuelve lo que ya se creó (200, Idempotent-Replayed: true) en vez de crear otra cosa.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
nombretextosíNombre de la lista (hasta 120 caracteres).. al menos 1 caracteres; hasta 120 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 idempotency_key_no_valida — La cabecera Idempotency-Key no es válida. Manda una cadena de 8 a 100 caracteres (letras, cifras, guiones o puntos), distinta para cada creación; un UUID sirve.
  • 400 nombre_del_espacio_no_valido — El nombre es obligatorio y admite hasta 120 caracteres (60 en una etiqueta). Manda `nombre` con entre 1 y 120 caracteres (entre 1 y 60 en una etiqueta).
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.
  • 409 limite_del_espacio — Has llegado a un tope de tu cuenta: 100 listas, 5.000 sociedades por lista, 50 etiquetas, 5.000 sociedades por etiqueta o 5.000 notas. Borra lo que ya no uses. Los topes están en la documentación de cada recurso.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/listas" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Clientes en riesgo"}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/listas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"nombre":"Clientes en riesgo"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/listas");
const r = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"nombre":"Clientes en riesgo"}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
  "nombre": "Clientes en riesgo",
  "creadaEn": "2026-10-22T08:00:00.000Z",
  "totalEmpresas": 0
}
GET/v1/dev/listas/{id}

Ver una lista con sus sociedades

La lista y los identificadores de sus sociedades (de la última añadida a la primera), con la fecha en que se añadió cada una. Para sus datos y su semáforo usa `GET /v1/dev/cartera?lista=…`; para el nombre de una, su ficha. Se pagina con `cursor`. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la lista.
cursortextonoCursor de la página siguiente (lo da siguienteCursor).. hasta 100 caracteres
limiteenteronoElementos por página, de 1 a 1000 (500 por defecto).. mínimo 1; máximo 1000. por defecto: 50 (avisos: entregas) · 100 (eventos) · 20 (búsquedas)

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
  "nombre": "Clientes en riesgo",
  "creadaEn": "2026-10-22T08:00:00.000Z",
  "totalEmpresas": 0,
  "empresas": [
    {
      "empresaId": "12345",
      "anadidaEn": "anadidaEn"
    }
  ],
  "siguienteCursor": "siguienteCursor"
}
DELETE/v1/dev/listas/{id}

Borrar una lista

Borra la lista (no las sociedades, que siguen en lo cargado). No se puede deshacer. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la lista.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "borrada": true
}
PUT/v1/dev/listas/{id}/empresas/{empresaId}

Poner una sociedad en una lista

Comprueba contra el BORME que es una sociedad cargada (un empresario individual es una persona física y no entra). Ponerla otra vez no hace nada (`nueva: false`). Hasta 5.000 sociedades por lista. Cuesta 3 céntimos por llamada servida; si la sociedad no se puede usar, 422 sin cobro.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la lista.
empresaIdtextosíIdentificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.
  • 409 limite_del_espacio — Has llegado a un tope de tu cuenta: 100 listas, 5.000 sociedades por lista, 50 etiquetas, 5.000 sociedades por etiqueta o 5.000 notas. Borra lo que ya no uses. Los topes están en la documentación de cada recurso.
  • 422 sociedad_no_valida — La sociedad no está en lo cargado del BORME, o es un empresario individual (una persona física). Busca su identificador con `GET /v1/dev/empresas/resolver?q=`. Listas, etiquetas y notas son sólo de sociedades: un empresario individual es una persona física y no se perfila. No se cobra.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X PUT "https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.put(
    "https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345");
const r = await fetch(url, {
  method: "PUT",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "nueva": true,
  "total": 1
}
DELETE/v1/dev/listas/{id}/empresas/{empresaId}

Quitar una sociedad de una lista

Gestión de tu cuenta: no se cobra. `quitada: false` si no estaba en la lista.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la lista.
empresaIdtextosíIdentificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "quitada": true
}
POST/v1/dev/listas/{id}/empresas

Poner varias sociedades en una lista de una vez

Hasta 50 sociedades por llamada, cada una con la misma comprobación que poner una. Una que no se puede poner (no está cargada, es un empresario individual o el identificador no vale) se cuenta en `omitidas` y no impide las demás. Cuesta 30 céntimos por lote servido.

Precio

30 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la lista.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
empresaslista de textosíIdentificadores de las sociedades (de 1 a 50).

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.
  • 409 limite_del_espacio — Has llegado a un tope de tu cuenta: 100 listas, 5.000 sociedades por lista, 50 etiquetas, 5.000 sociedades por etiqueta o 5.000 notas. Borra lo que ya no uses. Los topes están en la documentación de cada recurso.
  • 422 sociedad_no_valida — La sociedad no está en lo cargado del BORME, o es un empresario individual (una persona física). Busca su identificador con `GET /v1/dev/empresas/resolver?q=`. Listas, etiquetas y notas son sólo de sociedades: un empresario individual es una persona física y no se perfila. No se cobra.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"empresas":["12345","67890"]}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"empresas":["12345","67890"]},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/listas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas");
const r = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"empresas":["12345","67890"]}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "anadidas": 0,
  "yaEstaban": 0,
  "omitidas": 0,
  "llena": true
}
GET/v1/dev/etiquetas

Listar tus etiquetas de color

Tus etiquetas con cuántas sociedades lleva cada una. Con `empresaId`, sólo las que tiene puestas esa sociedad. Las etiquetas son tuyas y sólo se ponen a SOCIEDADES: nunca a una persona. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextonoIdentificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/etiquetas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/etiquetas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/etiquetas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "etiquetas": [
    {
      "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
      "nombre": "Revisar",
      "color": "rojo",
      "totalEmpresas": 0
    }
  ]
}
POST/v1/dev/etiquetas

Crear una etiqueta de color

El nombre no se puede repetir (409). Colores: rojo, naranja, amarillo, verde, azul, morado y gris. Hasta 50 etiquetas por cuenta. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
nombretextosíNombre de la etiqueta (hasta 60 caracteres).. al menos 1 caracteres; hasta 60 caracteres
colortextosíColor: rojo, naranja, amarillo, verde, azul, morado o gris.. uno de: rojo, naranja, amarillo, verde, azul, morado, gris

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 nombre_del_espacio_no_valido — El nombre es obligatorio y admite hasta 120 caracteres (60 en una etiqueta). Manda `nombre` con entre 1 y 120 caracteres (entre 1 y 60 en una etiqueta).
  • 400 color_de_etiqueta_no_valido — Ese color no está en la paleta. Los colores son rojo, naranja, amarillo, verde, azul, morado y gris.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 409 etiqueta_duplicada — Ya existe una etiqueta con ese nombre. Usa la que ya tienes (`GET /v1/dev/etiquetas`) o elige otro nombre.
  • 409 limite_del_espacio — Has llegado a un tope de tu cuenta: 100 listas, 5.000 sociedades por lista, 50 etiquetas, 5.000 sociedades por etiqueta o 5.000 notas. Borra lo que ya no uses. Los topes están en la documentación de cada recurso.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/etiquetas" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Revisar","color":"naranja"}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/etiquetas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"nombre":"Revisar","color":"naranja"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/etiquetas");
const r = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"nombre":"Revisar","color":"naranja"}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
  "nombre": "Revisar",
  "color": "rojo",
  "totalEmpresas": 0
}
DELETE/v1/dev/etiquetas/{id}

Borrar una etiqueta

Se quita también de todas las sociedades que la llevan. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la etiqueta.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 etiqueta_no_encontrada — No hay esa etiqueta en tu cuenta. Lista tus etiquetas con `GET /v1/dev/etiquetas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "borrada": true
}
GET/v1/dev/etiquetas/{id}/empresas

Las sociedades que llevan una etiqueta

Sus identificadores, de la última puesta a la primera. Se pagina con `cursor`. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la etiqueta.
cursortextonoCursor de la página siguiente (lo da siguienteCursor).. hasta 100 caracteres
limiteenteronoElementos por página, de 1 a 1000 (500 por defecto).. mínimo 1; máximo 1000. por defecto: 50 (avisos: entregas) · 100 (eventos) · 20 (búsquedas)

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 etiqueta_no_encontrada — No hay esa etiqueta en tu cuenta. Lista tus etiquetas con `GET /v1/dev/etiquetas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "empresas": [
    {
      "empresaId": "12345",
      "puestaEn": "puestaEn"
    }
  ],
  "siguienteCursor": "siguienteCursor"
}
PUT/v1/dev/etiquetas/{id}/empresas/{empresaId}

Poner una etiqueta a una sociedad

Sólo sociedades cargadas (un empresario individual es una persona física: nada de etiquetas sobre personas). Ponerla otra vez no hace nada (`nueva: false`). Cuesta 3 céntimos por llamada servida; si la sociedad no se puede usar, 422 sin cobro.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la etiqueta.
empresaIdtextosíIdentificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 etiqueta_no_encontrada — No hay esa etiqueta en tu cuenta. Lista tus etiquetas con `GET /v1/dev/etiquetas` y usa el `id` que devuelve.
  • 409 etiqueta_duplicada — Ya existe una etiqueta con ese nombre. Usa la que ya tienes (`GET /v1/dev/etiquetas`) o elige otro nombre.
  • 409 limite_del_espacio — Has llegado a un tope de tu cuenta: 100 listas, 5.000 sociedades por lista, 50 etiquetas, 5.000 sociedades por etiqueta o 5.000 notas. Borra lo que ya no uses. Los topes están en la documentación de cada recurso.
  • 422 sociedad_no_valida — La sociedad no está en lo cargado del BORME, o es un empresario individual (una persona física). Busca su identificador con `GET /v1/dev/empresas/resolver?q=`. Listas, etiquetas y notas son sólo de sociedades: un empresario individual es una persona física y no se perfila. No se cobra.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X PUT "https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.put(
    "https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345");
const r = await fetch(url, {
  method: "PUT",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "nueva": true
}
DELETE/v1/dev/etiquetas/{id}/empresas/{empresaId}

Quitar una etiqueta de una sociedad

Gestión de tu cuenta: no se cobra. `quitada: false` si no la llevaba.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la etiqueta.
empresaIdtextosíIdentificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 etiqueta_no_encontrada — No hay esa etiqueta en tu cuenta. Lista tus etiquetas con `GET /v1/dev/etiquetas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/etiquetas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/empresas/12345");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "quitada": true
}
GET/v1/dev/notas

Listar tus notas sobre sociedades

Todas tus notas, de la última tocada a la más antigua. Las notas son tuyas: no son datos del BORME y ni siquiera nuestro panel de operador las lee. Se pagina con `cursor`. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
cursortextonoCursor de la página siguiente (lo da siguienteCursor).. hasta 100 caracteres
limiteenteronoElementos por página, de 1 a 500 (100 por defecto).. mínimo 1; máximo 500. por defecto: 50 (avisos: entregas) · 100 (eventos) · 20 (búsquedas)

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/notas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/notas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/notas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "notas": [
    {
      "empresaId": "12345",
      "nota": "nota",
      "actualizadaEn": "actualizadaEn"
    }
  ],
  "siguienteCursor": "siguienteCursor"
}
GET/v1/dev/notas/{empresaId}

Ver tu nota sobre una sociedad

Tu nota, o `nota: ""` si no hay ninguna. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/notas/12345" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/notas/12345",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/notas/12345");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "empresaId": "12345",
  "nota": "nota",
  "actualizadaEn": "actualizadaEn"
}
PUT/v1/dev/notas/{empresaId}

Guardar tu nota sobre una sociedad

Texto libre de hasta 5.000 caracteres sobre una SOCIEDAD (nunca sobre una persona física). Una nota vacía borra la que hubiera y no consulta el BORME. Hasta 5.000 notas por cuenta. Cuesta 3 céntimos por nota guardada; si la sociedad no se puede usar, 422 sin cobro.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
notatextosíTu nota (hasta 5.000 caracteres). Vacía, la borra.. hasta 5000 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 nota_demasiado_larga — La nota pasa de 5.000 caracteres. Acorta la nota a 5.000 caracteres como mucho.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 409 limite_del_espacio — Has llegado a un tope de tu cuenta: 100 listas, 5.000 sociedades por lista, 50 etiquetas, 5.000 sociedades por etiqueta o 5.000 notas. Borra lo que ya no uses. Los topes están en la documentación de cada recurso.
  • 422 sociedad_no_valida — La sociedad no está en lo cargado del BORME, o es un empresario individual (una persona física). Busca su identificador con `GET /v1/dev/empresas/resolver?q=`. Listas, etiquetas y notas son sólo de sociedades: un empresario individual es una persona física y no se perfila. No se cobra.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X PUT "https://api.jurilia.com/v1/dev/notas/12345" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nota":"Pedir las cuentas del último ejercicio."}'

Python

import os
import requests

r = requests.put(
    "https://api.jurilia.com/v1/dev/notas/12345",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"nota":"Pedir las cuentas del último ejercicio."},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/notas/12345");
const r = await fetch(url, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"nota":"Pedir las cuentas del último ejercicio."}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "empresaId": "12345",
  "nota": "nota",
  "actualizadaEn": "actualizadaEn"
}
DELETE/v1/dev/notas/{empresaId}

Borrar tu nota sobre una sociedad

Gestión de tu cuenta: no se cobra. `borrada: false` si no había nota.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
empresaIdtextosíIdentificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/notas/12345" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/notas/12345",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/notas/12345");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "borrada": true
}
GET/v1/dev/cartera

La cartera con semáforo: tus sociedades en listas o vigiladas

Cada sociedad que está en alguna de tus listas o que vigila alguna suscripción de avisos, con su semáforo: `rojo` (consta publicado un concurso, una disolución o una extinción), `ambar` (consta algo a vigilar en los últimos 90 días) o `verde` (ausencia de actos tipificados, no una comprobación aparte). Cada fila lleva los hechos que lo explican con su boletín, las listas en que está, si la vigilas y tus etiquetas. `lista` o `suscripcion` la acotan; `estado` filtra por color. Hasta 500 sociedades por llamada (`recortada` lo dice). Es lo que consta publicado, nunca un juicio. Cuesta 8 céntimos por llamada.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
listatextonoSólo las sociedades de esta lista.
suscripciontextonoSólo las que vigila esta suscripción de avisos.
estadotextonoSólo las que están en este color.. uno de: rojo, ambar, verde

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/cartera" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/cartera",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/cartera");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "semaforo": [
    {
      "empresaId": "12345",
      "estado": "rojo",
      "empresa": {
        "id": "12345",
        "denominacion": "ACME SERVICIOS SL",
        "denominacionLegible": "Acme Servicios, S.L.",
        "provincia": "MADRID",
        "provinciaLegible": "Madrid",
        "provinciaSlug": "madrid",
        "hoja": "M-123456",
        "titular": "sociedad",
        "primeraPublicacion": "2026-10-22",
        "ultimaPublicacion": "2026-10-22",
        "concursalPublicadoEn": "2026-10-22",
        "disolucionPublicadaEn": "2026-10-22",
        "extincionPublicadaEn": "2026-10-22",
        "rutaWeb": "rutaWeb"
      },
      "motivos": [
        {
          "tipo": "tipo",
          "fecha": "2026-10-22",
          "fuente": {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        }
      ],
      "listas": [
        "lista"
      ],
      "vigilada": true,
      "etiquetas": [
        {
          "id": "12345",
          "nombre": "ANA GARCIA LOPEZ",
          "color": "rojo"
        }
      ]
    }
  ],
  "total": 1,
  "recortada": true
}
GET/v1/dev/radar

El radar: qué ha publicado el BORME de lo que vigilas

Las novedades de las sociedades y los domicilios de todas tus suscripciones de avisos, de la más reciente a la más antigua, una vez por anuncio aunque lo vigilen varias suscripciones. Sólo lo publicado desde que empezaste a vigilar; se conservan 90 días. Es lo mismo que te mandamos por aviso, para consultarlo cuando quieras. `desde` acota por fecha y se pagina con `cursor`. Cuesta 3 céntimos por llamada.

Precio

3 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
desdefecha (AAAA-MM-DD)noSólo novedades publicadas desde esta fecha, AAAA-MM-DD.
cursortextonoCursor de la página siguiente (lo da siguienteCursor).. hasta 100 caracteres
limiteenteronoElementos por página, de 1 a 100 (30 por defecto).. mínimo 1; máximo 100. por defecto: 50 (avisos: entregas) · 100 (eventos) · 20 (búsquedas)

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 cursor_no_valido — El cursor no es válido o ha caducado. Usa el valor de `siguienteCursor` o de la cabecera `X-Jurilia-Siguiente-Cursor` tal cual lo recibiste.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/radar" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/radar",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/radar");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "novedades": [
    {
      "empresaId": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "fecha": "2026-10-22",
      "numero": 7,
      "boletin": "BORME-A-2026-200-28",
      "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
      "tipos": [
        "tipo"
      ],
      "suscripciones": [
        "suscripcione"
      ],
      "domicilio": "domicilio",
      "rutaWeb": "rutaWeb"
    }
  ],
  "siguienteCursor": "siguienteCursor"
}

Búsquedas guardadas

Vigila una provincia, un sector o cualquier criterio de la búsqueda avanzada: quién entra y quién sale desde la última comprobación. La comprobación la pides tú cuando quieres y pagas sólo por ella.

GET/v1/dev/busquedas-guardadas

Listar tus búsquedas guardadas

Tus búsquedas avanzadas guardadas, con cuándo se comprobaron por última vez. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/busquedas-guardadas" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/busquedas-guardadas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/busquedas-guardadas");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "busquedas": [
    {
      "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
      "nombre": "Constituidas en Málaga",
      "parametros": "provincia=MALAGA&const_anio=2026",
      "creadaEn": "2026-10-22T08:00:00.000Z",
      "comprobadaEn": "comprobadaEn",
      "estado": "ok",
      "sociedadesEnLaFoto": 0
    }
  ]
}
POST/v1/dev/busquedas-guardadas

Guardar una búsqueda avanzada para vigilar sus cambios

Guarda los parámetros de una búsqueda de `GET /v1/dev/empresas/avanzada` (por ejemplo `provincia=MALAGA&const_anio=2026`): se validan con el mismo lector que la búsqueda y se guardan en forma canónica; lo que no se entiende, no se guarda. Después, `POST …/comprobar` dice qué sociedades entran y cuáles salen desde la vez anterior. Hacen falta filtros (si no, 400) y no valen las listas de prospección (`acto=`). Hasta 100 por cuenta. Con `Idempotency-Key`, repetir la misma petición devuelve la misma búsqueda (200). Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idempotency-keytextonoCadena de 8 a 100 caracteres, distinta para cada creación. Repetir la misma petición con la misma clave devuelve lo que ya se creó (200, Idempotent-Replayed: true) en vez de crear otra cosa.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
nombretextosíNombre de la búsqueda (hasta 120 caracteres).. al menos 1 caracteres; hasta 120 caracteres
parametrostextosíLos parámetros de GET /v1/dev/empresas/avanzada, como en una dirección.. al menos 1 caracteres; hasta 1000 caracteres

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 idempotency_key_no_valida — La cabecera Idempotency-Key no es válida. Manda una cadena de 8 a 100 caracteres (letras, cifras, guiones o puntos), distinta para cada creación; un UUID sirve.
  • 400 nombre_del_espacio_no_valido — El nombre es obligatorio y admite hasta 120 caracteres (60 en una etiqueta). Manda `nombre` con entre 1 y 120 caracteres (entre 1 y 60 en una etiqueta).
  • 400 sin_criterio — La búsqueda no tiene ningún filtro que se entienda. Manda en `parametros` al menos un filtro de `GET /v1/dev/empresas/avanzada` (por ejemplo `provincia=MALAGA&const_anio=2026`).
  • 400 busqueda_no_guardable — Esa búsqueda no se puede guardar para vigilar sus cambios (por ejemplo, una lista de prospección). Las listas de prospección (con `acto`) se piden cuando se necesitan con `GET /v1/dev/empresas/prospeccion`. Guarda una búsqueda avanzada normal.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 409 limite_de_busquedas_guardadas — Has llegado al máximo de 100 búsquedas guardadas. Borra alguna que ya no uses (`DELETE /v1/dev/busquedas-guardadas/{id}`).
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/busquedas-guardadas" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Constituidas en Málaga","parametros":"provincia=MALAGA&const_anio=2026"}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/busquedas-guardadas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"nombre":"Constituidas en Málaga","parametros":"provincia=MALAGA&const_anio=2026"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/busquedas-guardadas");
const r = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"nombre":"Constituidas en Málaga","parametros":"provincia=MALAGA&const_anio=2026"}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
  "nombre": "Constituidas en Málaga",
  "parametros": "provincia=MALAGA&const_anio=2026",
  "creadaEn": "2026-10-22T08:00:00.000Z",
  "comprobadaEn": "comprobadaEn",
  "estado": "ok",
  "sociedadesEnLaFoto": 0
}
GET/v1/dev/busquedas-guardadas/{id}

Ver una búsqueda guardada

Sus parámetros, su estado y cuándo se comprobó por última vez. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la búsqueda guardada.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 busqueda_guardada_no_encontrada — No hay esa búsqueda guardada en tu cuenta. Lista tus búsquedas con `GET /v1/dev/busquedas-guardadas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
  "nombre": "Constituidas en Málaga",
  "parametros": "provincia=MALAGA&const_anio=2026",
  "creadaEn": "2026-10-22T08:00:00.000Z",
  "comprobadaEn": "comprobadaEn",
  "estado": "ok",
  "sociedadesEnLaFoto": 0
}
DELETE/v1/dev/busquedas-guardadas/{id}

Borrar una búsqueda guardada

Borra la búsqueda y su foto. Gestión de tu cuenta: no se cobra.

Precio

Gratis (gestión de la cuenta) · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la búsqueda guardada.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 busqueda_guardada_no_encontrada — No hay esa búsqueda guardada en tu cuenta. Lista tus búsquedas con `GET /v1/dev/busquedas-guardadas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X DELETE "https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.delete(
    "https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34");
const r = await fetch(url, {
  method: "DELETE",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "borrada": true
}
POST/v1/dev/busquedas-guardadas/{id}/comprobar

Volver a ejecutar una búsqueda guardada y ver qué ha cambiado

Ejecuta la búsqueda ahora, la compara con la foto de la comprobación anterior y guarda la nueva. La primera vez toma la foto SIN decir «entran todas» (`conFoto: false` antes, `true` después). Después dice quién entra a cumplirla, con el dato publicado que la hace cumplir y su boletín, y quién sale, con un motivo sólo si consta publicado (si no, `desconocido`). Más de 2.000 sociedades, o una consulta que pasa de 10 s, es `amplia`: no se vigilan los cambios. Llámala desde tu planificador cuando quieras (una vez al día basta); si hay demasiadas a la vez, 503 sin cobro. Cuesta 15 céntimos por comprobación servida. Hechos publicados, nunca una valoración.

Precio

15 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la búsqueda guardada.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 busqueda_guardada_no_encontrada — No hay esa búsqueda guardada en tu cuenta. Lista tus búsquedas con `GET /v1/dev/busquedas-guardadas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 503 semaforo_saturado — Hay demasiadas búsquedas o informes calculándose a la vez en este momento. Reintenta en unos segundos con espera creciente. No se ha cobrado nada.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/comprobar" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/comprobar",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/comprobar");
const r = await fetch(url, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "estado": "ok",
  "conFoto": true,
  "desde": "desde",
  "hasta": "hasta",
  "totalEntran": 0,
  "totalSalen": 0,
  "entran": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "rutaWeb": "rutaWeb",
      "pruebas": [
        {
          "criterio": "constitucion",
          "fuente": "borme",
          "fecha": "2026-10-22",
          "cantidad": 0,
          "importeCentimos": 1250000,
          "texto": "texto",
          "periodo": {
            "desde": 0,
            "hasta": 0
          },
          "cita": {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        }
      ]
    }
  ],
  "salen": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "rutaWeb": "rutaWeb",
      "motivo": {
        "tipo": "extinguida",
        "fecha": "2026-10-22",
        "provincia": "MADRID"
      }
    }
  ]
}
GET/v1/dev/busquedas-guardadas/{id}/cambios

Lo que cambió en la última comprobación de una búsqueda guardada

Quién entró y quién salió en la última comprobación (`POST …/comprobar`), sin volver a ejecutar la búsqueda. Si aún no se ha comprobado, `conFoto: false` y listas vacías. Las pruebas y los motivos se calculan con los datos de hoy. Cuesta 8 céntimos por llamada.

Precio

8 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Sólo se cobra si se sirve: si el caso, la lista, la etiqueta o la suscripción no existen o no son tuyos (404), si lo que añades no se puede usar (422), si el caso está cerrado (409) o si hay demasiado trabajo a la vez (503), no cuesta nada.

Parámetros

CampoTipoObligatorioValores, límites y por defecto
idtextosíIdentificador de la búsqueda guardada.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 busqueda_guardada_no_encontrada — No hay esa búsqueda guardada en tu cuenta. Lista tus búsquedas con `GET /v1/dev/busquedas-guardadas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl "https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/cambios" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/cambios",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/busquedas-guardadas/3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34/cambios");
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "estado": "ok",
  "conFoto": true,
  "desde": "desde",
  "hasta": "hasta",
  "totalEntran": 0,
  "totalSalen": 0,
  "entran": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "rutaWeb": "rutaWeb",
      "pruebas": [
        {
          "criterio": "constitucion",
          "fuente": "borme",
          "fecha": "2026-10-22",
          "cantidad": 0,
          "importeCentimos": 1250000,
          "texto": "texto",
          "periodo": {
            "desde": 0,
            "hasta": 0
          },
          "cita": {
            "identificador": "BORME-A-2026-200-28",
            "urlPdf": "https://www.boe.es/borme/dias/2026/10/22/pdfs/BORME-A-2026-200-28.pdf",
            "numero": 7,
            "fecha": "2026-10-22"
          }
        }
      ]
    }
  ],
  "salen": [
    {
      "id": "12345",
      "denominacion": "ACME SERVICIOS SL",
      "denominacionLegible": "Acme Servicios, S.L.",
      "provincia": "MADRID",
      "provinciaLegible": "Madrid",
      "rutaWeb": "rutaWeb",
      "motivo": {
        "tipo": "extinguida",
        "fecha": "2026-10-22",
        "provincia": "MADRID"
      }
    }
  ]
}

Exportaciones

Sociedades a CSV para Excel y el mapa de conexiones a CSV o GraphML para i2, Maltego o Gephi.

GET/v1/dev/exportaciones/empresas

Exportar sociedades a CSV (para Excel)

El CSV (UTF-8 con BOM y `;` como separador, para Excel) de las sociedades de `origen`: `lista` (con el `id` de la lista), `caso` (las sociedades de un caso, con su `id`), `vigiladas` (todo lo que vigilan tus suscripciones, o sólo una si das su `id`) o `busqueda` (el resultado actual de una búsqueda guardada, con su `id`). Hasta 25.000 filas. Cada fila lleva la ficha, la situación publicada y el último acto con su boletín. Cuesta 200 céntimos por descarga.

Precio

200 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

CampoTipoObligatorioValores, límites y por defecto
origentextosíDe dónde salen las sociedades: lista, caso, vigiladas o busqueda.. uno de: lista, vigiladas, caso, busqueda
idtextonoEl identificador de la lista, del caso o de la búsqueda (obligatorio salvo con vigiladas, donde acota a una suscripción).

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 400 busqueda_avanzada_no_exportable — Esa búsqueda no se puede exportar: no tiene filtros, es demasiado amplia o los datos aún no están preparados. Añade filtros para acotarla y reintenta en unos minutos si los datos aún no están preparados.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 404 lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.
  • 404 caso_no_encontrado — No hay ese caso en tu cuenta (o no es tuyo: no se distingue). Lista tus casos con `GET /v1/dev/casos` y usa el `id` que devuelve.
  • 404 busqueda_guardada_no_encontrada — No hay esa búsqueda guardada en tu cuenta. Lista tus búsquedas con `GET /v1/dev/busquedas-guardadas` y usa el `id` que devuelve.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -o sociedades.csv "https://api.jurilia.com/v1/dev/exportaciones/empresas?id=3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34&origen=lista" \
  -H "Authorization: Bearer $JURILIA_API_KEY"

Python

import os
import requests

r = requests.get(
    "https://api.jurilia.com/v1/dev/exportaciones/empresas",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    params={"id":"3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34","origen":"lista"},
    timeout=30,
)
r.raise_for_status()
open("sociedades.csv", "wb").write(r.content)

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/exportaciones/empresas");
url.search = new URLSearchParams({"id":"3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a34","origen":"lista"});
const r = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.JURILIA_API_KEY}` },
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
await (await import("node:fs/promises")).writeFile("sociedades.csv", Buffer.from(await r.arrayBuffer()));

Respuesta de ejemplo

Esta ruta devuelve un fichero (PDF, Excel o CSV), no JSON.

POST/v1/dev/exportaciones/red

Exportar el mapa de conexiones a CSV o GraphML

Lo que muestra el mapa de conexiones, para i2 Analyst’s Notebook, Maltego o Gephi. Manda el campo `red` de `GET /v1/dev/casos/{id}/red` (nodos y aristas) y el formato; devuelve los ficheros en texto (con CSV son dos: nodos y aristas), sin ZIP. Cuesta 200 céntimos por descarga.

Precio

200 céntimos por llamada servida · 120 llamadas por minuto y por clave (todas las rutas).

Parámetros

Sin parámetros.

Cuerpo JSON

CampoTipoObligatorioValores, límites y por defecto
formatotextosíFormato del fichero: xlsx (por defecto) o csv en la descarga de prospección; csv o graphml en la exportación de la red.. uno de: csv, graphml
nodoslista de textosíNodos del mapa (e:<id>, p:<slug>, d:<clave>) como los devuelve GET /v1/dev/red: de 1 a 50 para añadir a un caso, hasta 250 para exportar.
aristaslista de lista de valorsíAristas: pares de posiciones en nodos (origen, destino), hasta 1.500.

Errores y cómo resolverlos

  • 400 validacion — Un dato de la petición no es válido; `campos` dice cuál. Corrige los campos que indica `campos` y repite la llamada. Una petición inválida no se cobra.
  • 401 no_autenticado — Falta la cabecera Authorization con la clave de API. Manda la clave en la cabecera `Authorization: Bearer <clave>`. La creas en el panel de desarrolladores.
  • 401 clave_invalida — La clave no existe o ha sido revocada. Comprueba que copiaste la clave entera y que no la has revocado. Crea otra en el panel si hace falta.
  • 401 clave_no_es_de_desarrollador — La clave es de un despacho, no de una cuenta de desarrollador. Esta API sólo admite claves de una cuenta de desarrollador, no las de un despacho.
  • 402 saldo_insuficiente — No hay saldo disponible para esta consulta. No se ha servido ni cobrado. Recarga tu saldo en el panel (Facturación). La consulta no se ha servido ni cobrado.
  • 403 clave_ip_no_permitida — La clave tiene una lista de direcciones permitidas y esta no está en ella. La clave tiene una lista de direcciones permitidas. Añade la de tu servidor en el panel, o quita la restricción.
  • 403 identidad_sin_verificar — La cuenta aún no tiene la identidad verificada y sin ella no se gasta saldo. Verifica la identidad de la cuenta en Configuración del panel; sin ella no se gasta saldo.
  • 429 demasiadas_peticiones — Demasiadas llamadas seguidas con esta clave (120 por minuto). Espera los segundos que dice la cabecera `Retry-After` y reintenta con espera creciente. El límite es por clave.
  • 503 semaforo_saturado — Hay demasiadas búsquedas o informes calculándose a la vez en este momento. Reintenta en unos segundos con espera creciente. No se ha cobrado nada.
  • 500 error_interno — Un fallo nuestro. No se cobra nada. Es un fallo nuestro y no se ha cobrado nada. Reintenta en unos segundos; si persiste, escríbenos con la hora.

Ejemplo de petición

curl

curl -X POST "https://api.jurilia.com/v1/dev/exportaciones/red" \
  -H "Authorization: Bearer $JURILIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"formato":"graphml","nodos":["e:12345","p:ana-garcia-lopez"],"aristas":[[1,0]]}'

Python

import os
import requests

r = requests.post(
    "https://api.jurilia.com/v1/dev/exportaciones/red",
    headers={"Authorization": f"Bearer {os.environ['JURILIA_API_KEY']}"},
    json={"formato":"graphml","nodos":["e:12345","p:ana-garcia-lopez"],"aristas":[[1,0]]},
    timeout=30,
)
r.raise_for_status()
print(r.json())

JavaScript

const url = new URL("https://api.jurilia.com/v1/dev/exportaciones/red");
const r = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.JURILIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"formato":"graphml","nodos":["e:12345","p:ana-garcia-lopez"],"aristas":[[1,0]]}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Respuesta de ejemplo

Ver la respuesta completa de ejemplo
{
  "ficheros": [
    {
      "nombre": "ANA GARCIA LOPEZ",
      "tipo": "tipo",
      "contenido": "contenido"
    }
  ]
}