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/v1Restricció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.jsonLas 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.
/v1/dev/pingComprobar 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')/v1/dev/empresasBuscar 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' })/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": ,
"totalInscripciones": ,
"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')/v1/dev/personasBuscar 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": ,
"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' })/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')/v1/dev/provinciasProvincias 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')/v1/dev/boletinesLos 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": , "documentos": , "inscripciones": }
]
}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' })/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": ,
"documentos": ,
"inscripciones": ,
"provincias": [
{
"identificador": "BORME-A-2026-184-28",
"provincia": "Madrid",
"urlPdf": "https://www.boe.es/borme/dias/2026/09/30/pdfs/…pdf",
"anuncios":
}
]
}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')/v1/dev/estadisticasCuá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-DDobligatoriohastaAAAA-MM-DDobligatorioprovinciastringopcional— Acota el recuento a una provincia.
Respuesta
{
"desde": "2026-09-01",
"hasta": "2026-09-30",
"recortado": false,
"provincia": null,
"dias": ,
"inscripciones": ,
"actos": ,
"porTipo": [{ "tipo": "cambio_de_administradores", "actos": }],
"porProvincia": [{ "provincia": "Madrid", "inscripciones": }]
}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' })/v1/dev/estadoHasta 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": ,
"inscripciones":
}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.
/v1/dev/biblioteca/abreviaturasLas 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": }
]
}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')/v1/dev/biblioteca/articuloUn 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' })/v1/dev/biblioteca/buscarBuscar 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' })/v1/dev/biblioteca/versionesTodas 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": , "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' })/v1/dev/biblioteca/ley-en-fechaLa 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.
/v1/dev/calculadorasLas 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')/v1/dev/calculadoras/despidoIndemnizació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": , "diasPorAnio": , "dias": }
],
"diasDevengados": ,
"diasIndemnizables": ,
"importeCentimos": ,
"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": , "clase": "improcedente",
})JavaScript
await devApiPost('/calculadoras/despido', {
antiguedad: '2015-01-01', extincion: '2026-09-15',
salarioDiarioCentimos: , clase: 'improcedente',
})/v1/dev/plazos/reglasLas 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": ,
"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' })/v1/dev/plazos/vencimientoCalcular 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.
/v1/dev/calculadoras/abono-preventivaAbono 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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
pena | objeto | obligatorio | |
fechaHechos | fecha (AAAA-MM-DD) | opcional | Día de los hechos; lo exige el art. 58.3 para el abono de lo sufrido en otra causa. |
periodos | lista de objeto | obligatorio | |
privacionesEnOtraCausa | lista de objeto | opcional | |
inicioCumplimiento | fecha (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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
porPeriodo | lista de objeto | siempre | |
diasAbonados | entero | siempre | Días que se abonan por el art. 58 CP: el número que se lleva a la liquidación de condena. |
diasNoAbonados | entero | siempre | |
compensacion | objeto o nulo | siempre | El margen del art. 59 CP (no es una cifra: decide el tribunal). |
duracionPena | objeto o nulo | siempre | |
penaExtinguidaPorElAbono | verdadero/falso | siempre | |
condena | objeto o nulo | siempre | Las fechas clave de la condena ya desplazadas por el abono. |
avisos | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
fundamento | lista de texto | siempre | |
noCalculado | lista de texto | siempre | |
traza | lista de texto | siempre |
Respuestas posibles
200— Cálculo con su traza400— Datos no válidos401— Falta la clave de API, o no existe, o ha sido revocada402— 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 verificada429— 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": [] }'/v1/dev/calculadoras/limites-cumplimientoLí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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
condenas | lista de objeto | obligatorio | |
inicio | fecha (AAAA-MM-DD) | opcional | Dí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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
regimen | texto | siempre | uno de: numerico, permanente_revisable |
limite | objeto o nulo | siempre | |
razonDelLimite | texto o nulo | siempre | uno de: suma, triple, tope |
suma | objeto | siempre | |
masGrave | objeto o nulo | siempre | |
triple | objeto o nulo | siempre | |
tope | objeto o nulo | siempre | |
topesConcurrentes | lista de objeto | siempre | |
recorta | verdadero/falso | siempre | |
puertaDelArt78 | verdadero/falso | siempre | |
basesDelComputo | lista de objeto | siempre | |
ordenDeCumplimiento | lista de objeto | siempre | |
hitos | lista de objeto | siempre | |
minimosPermanenteRevisable | lista de objeto | siempre | |
finDelLimite | texto o nulo | siempre | |
traza | lista de texto | siempre | |
avisos | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
fundamento | lista de texto | siempre | |
noCalculado | lista de texto | siempre |
Respuestas posibles
200— Cálculo con su traza400— Datos no válidos401— Falta la clave de API, o no existe, o ha sido revocada402— 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 verificada429— 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": [] }'/v1/dev/calculadoras/cancelacion-antecedentesCancelació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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
penas | lista de objeto | obligatorio |
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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
porPena | lista de objeto | siempre | |
cancelableDesde | texto o nulo | siempre | |
avisos | lista de texto | siempre | |
fundamento | lista de texto | siempre |
Respuestas posibles
200— Cálculo con su traza y sus avisos400— Datos no válidos401— Sin autenticar402— 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": [] }'/v1/dev/calculadoras/condenaFechas 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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
inicio | fecha (AAAA-MM-DD) | obligatorio | |
duracion | objeto | obligatorio | |
diasAbonados | entero | opcional | mínimo 0; máximo 36500 |
periodoSeguridad | texto | opcional | uno de: no, acordado, obligatorio |
primeraCondena | verdadero/falso | opcional | |
delitoContraLibertadSexual | verdadero/falso | opcional |
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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
hitos | lista de objeto | siempre | |
diasTotales | entero | siempre | |
avisos | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
fundamento | lista de texto | siempre | |
noCalculado | lista de texto | siempre |
Respuestas posibles
200— Fechas con sus avisos y supuestos400— Datos no válidos401— Sin autenticar402— 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": {} }'/v1/dev/calculadoras/prescripcion-penaPrescripció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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
naturaleza | texto | obligatorio | uno 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 |
duracion | objeto | opcional | |
sentenciaFirme | fecha (AAAA-MM-DD) | obligatorio | |
quebrantamiento | fecha (AAAA-MM-DD) | opcional | |
suspensiones | lista de objeto | opcional | |
claseDeclarada | texto | opcional | uno de: grave, menos_grave, leve |
delitoImprescriptible | verdadero/falso | opcional |
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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
prescribeEl | texto o nulo | siempre | |
anios | entero o nulo | siempre | |
regla | texto o nulo | siempre | uno 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 |
clase | texto o nulo | siempre | uno de: grave, menos_grave, leve |
diesAQuo | texto | siempre | |
diesAQuoMotivo | texto | siempre | |
diasSuspendidos | entero | siempre | |
fundamento | texto | siempre | |
avisos | lista de texto | siempre | |
noResuelto | lista de texto | siempre |
Respuestas posibles
200— Fecha con su regla, sus avisos y lo que el artículo no resuelve400— Datos no válidos401— Sin autenticar402— 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" }'/v1/dev/calculadoras/interes-mora-salarioInteré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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
adeudadoCentimos | entero | obligatorio | mínimo 0; máximo 100000000000 |
moraDesde | fecha (AAAA-MM-DD) | opcional | |
moraHasta | fecha (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":
}Campos de la respuesta (200)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
porcentaje | número | siempre | |
interesCentimos | entero | siempre | |
adeudadoCentimos | entero | siempre | |
totalCentimos | entero | siempre | |
lecturaAnual | objeto o nulo | siempre | |
fundamento | lista de texto | siempre | |
traza | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
noResuelve | lista de texto | siempre |
Respuestas posibles
200— El diez por ciento literal, y aparte la lectura anual si procede400— Datos no válidos401— Sin autenticar402— 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 }'/v1/dev/calculadoras/recargo-cuotasRecargo 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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
deudaCentimos | entero | obligatorio | mínimo 0; máximo 100000000000 |
clase | texto | obligatorio | uno de: cuotas, recursos_distintos_de_cuotas |
documentos | texto | opcional | uno de: presentados_en_plazo, no_presentados_en_plazo |
vencimientoPlazoReglamentario | fecha (AAAA-MM-DD) | obligatorio | |
fechaPago | fecha (AAAA-MM-DD) | obligatorio | |
finPlazoReclamacionDeuda | fecha (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": ,
"clase": "cuotas",
"vencimientoPlazoReglamentario": "2026-01-01",
"fechaPago": "2026-01-01"
}Campos de la respuesta (200)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
puntos | número | siempre | |
recargoCentimos | entero | siempre | |
deudaCentimos | entero | siempre | |
totalCentimos | entero | siempre | |
cita | texto o nulo | siempre | |
fundamento | lista de texto | siempre | |
traza | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
noResuelve | lista de texto | siempre | |
huecoDelArticulo | texto o nulo | siempre |
Respuestas posibles
200— Recargo con el subapartado exacto del que sale400— Datos no válidos401— Sin autenticar402— 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" }'/v1/dev/calculadoras/recargo-prestacionesRecargo 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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
prestacionesCentimos | entero | obligatorio | mínimo 0; máximo 100000000000 |
puntosFijadosEnResolucion | número | opcional | mí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":
}Campos de la respuesta (200)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
puntosMinimo | número | siempre | |
puntosMaximo | número | siempre | |
minimoCentimos | entero | siempre | |
maximoCentimos | entero | siempre | |
fijadoEnResolucion | objeto o nulo | siempre | |
deQueDepende | texto | siempre | |
fundamento | lista de texto | siempre | |
traza | lista de texto | siempre | |
advertencias | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
noResuelve | lista de texto | siempre |
Respuestas posibles
200— El rango, sus advertencias y lo que el artículo no resuelve400— Datos no válidos, o porcentaje fuera de la horquilla del artículo401— Sin autenticar402— 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 }'/v1/dev/calculadoras/mora-procesalInteré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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
principalCentimos | entero | obligatorio | mínimo 0; máximo 100000000000 |
desde | fecha (AAAA-MM-DD) | obligatorio | |
hasta | fecha (AAAA-MM-DD) | obligatorio | |
hayPactoODisposicionEspecial | verdadero/falso | opcional |
Esqueleto del cuerpo (sólo los campos obligatorios, con valores de relleno sacados del esquema: sustitúyelos por tus datos)
{
"principalCentimos": ,
"desde": "2026-01-01",
"hasta": "2026-01-01"
}Campos de la respuesta (200)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
desenlace | texto | siempre | uno de: calculado, faltan_tipos, antes_de_la_ley, hay_otro_tipo |
principalCentimos | entero | siempre | |
desde | texto | siempre | |
hasta | texto | siempre | |
interesCentimos | entero o nulo | siempre | |
totalCentimos | entero o nulo | siempre | |
diasSinTipo | entero | siempre | |
tramos | lista de objeto | siempre | |
cobertura | objeto | siempre | |
fundamento | lista de texto | siempre | |
traza | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
noResuelve | lista de texto | siempre |
Respuestas posibles
200— El interés con su desglose, o el motivo por el que no se da un total400— Datos no válidos401— Sin autenticar402— 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" }'/v1/dev/calculadoras/alimentos-ipcActualizació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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
fechaResolucion | fecha (AAAA-MM-DD) | obligatorio | |
pensionInicialCentimos | entero | obligatorio | mínimo 0; máximo 100000000000 |
criterio | texto | obligatorio | uno de: anio_natural, aniversario |
siBajaElIndice | texto | obligatorio | uno de: aplicar_la_bajada, mantener_la_pension |
hasta | fecha (AAAA-MM-DD) | obligatorio | |
pagadoMensualCentimos | entero | opcional | mínimo 0; máximo 100000000000 |
desfaseMeses | texto | opcional |
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": ,
"criterio": "anio_natural",
"siBajaElIndice": "aplicar_la_bajada",
"hasta": "2026-01-01"
}Campos de la respuesta (200)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
lecturas | lista de objeto | siempre | |
descartadas | lista de objeto | siempre | |
pensionActualCentimos | entero o nulo | siempre | |
serie | objeto | siempre | |
fundamento | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
avisos | lista de texto | siempre | |
decisionesDelAbogado | lista de texto | siempre |
Respuestas posibles
200— Una o dos lecturas, con sus atrasos y la serie utilizada400— Datos no válidos401— Sin autenticar402— 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" }'/v1/dev/calculadoras/conformidadRebaja 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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
via | texto | obligatorio | uno de: juicio_rapido, abreviado, ordinario |
penasPrivativasSolicitadas | lista de objeto | obligatorio | |
penaDelTipo | objeto | opcional | |
acusacionParticularConstituida | verdadero/falso | obligatorio | |
fiscalPidioAperturaYAcusoEnElActo | verdadero/falso | obligatorio | |
primerDelito | verdadero/falso | opcional | |
responsabilidadCivilAtendida | verdadero/falso | opcional |
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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
via | texto | siempre | uno de: juicio_rapido, abreviado, ordinario |
rebaja | objeto o nulo | siempre | |
requisitos | lista de objeto | siempre | |
penaSolicitada | objeto | siempre | |
penaResultante | objeto | siempre | |
suspension | objeto | siempre | |
fundamento | lista de texto | siempre | |
traza | lista de texto | siempre | |
avisos | lista de texto | siempre | |
supuestos | lista de texto | siempre |
Respuestas posibles
200— Cálculo con su traza400— Datos no válidos401— Sin autenticar402— 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 }'/v1/dev/calculadoras/determinacion-penaDeterminació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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
marco | objeto | obligatorio | |
gradoPrevio | texto | opcional | uno de: ninguno, tentativa, complicidad, eximente_incompleta, art_65_3 |
atenuantes | entero | opcional | mínimo 0; máximo 20 |
agravantes | entero | opcional | mínimo 0; máximo 20 |
atenuanteMuyCualificada | verdadero/falso | opcional | |
reincidenciaCualificada | verdadero/falso | opcional | |
fundamentoTrasCompensacion | texto | opcional | uno de: ninguno, atenuacion, agravacion |
delitoLeve | verdadero/falso | opcional | |
delitoImprudente | verdadero/falso | opcional | |
personaJuridica | verdadero/falso | opcional | |
antecedentesDeDelitosLeves | verdadero/falso | opcional |
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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
partida | objeto | siempre | |
previos | lista de objeto | siempre | |
base | objeto o nulo | siempre | |
regla | texto o nulo | siempre | uno 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 |
fundamento | texto | siempre | |
resultados | lista de objeto | siempre | |
alternativas | lista de objeto | siempre | |
avisos | lista de texto | siempre | |
noResuelto | lista de texto | siempre | |
convenios | lista de texto | siempre | |
sustitucion | objeto o nulo | siempre |
Respuestas posibles
200— Cálculo con su traza400— Datos no válidos401— Sin autenticar402— 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" } }'/v1/dev/calculadoras/prisionLí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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
inicio | fecha (AAAA-MM-DD) | obligatorio | |
motivo | texto | obligatorio | uno de: ocultacion_de_pruebas, fuga_o_reiteracion |
penaSenaladaAnios | número | opcional | mayor que 0; máximo 100 |
diasYaCumplidos | entero | opcional | mínimo 0; máximo 36500 |
conProrroga | verdadero/falso | opcional |
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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
limite | texto | siempre | |
mesesBase | número | siempre | |
mesesProrroga | número | siempre | |
avisoDosTercios | texto | siempre | |
prorrogaDisponibleMeses | número | siempre | |
fundamento | lista de texto | siempre | |
traza | lista de texto | siempre | |
avisos | lista de texto | siempre |
Respuestas posibles
200— Cálculo con su traza400— Datos no válidos401— Sin autenticar402— 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" }'/v1/dev/calculadoras/suspensionSuspensió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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
penas | lista de objeto | obligatorio | |
computoDesde | fecha (AAAA-MM-DD) | opcional | |
acordadaEnSentencia | verdadero/falso | opcional | |
primeraVez | texto | opcional | uno de: si, no, no_consta |
responsabilidadCivil | texto | opcional | uno de: satisfecha, compromiso_asumido, no_satisfecha, no_procede, no_consta |
decomiso | texto | opcional | uno de: satisfecha, compromiso_asumido, no_satisfecha, no_procede, no_consta |
reoHabitual | texto | opcional | uno de: si, no, no_consta |
enfermedadMuyGrave | texto | opcional | uno de: si, no, no_consta |
otraPenaSuspendidaPorEnfermedad | texto | opcional | uno de: si, no, no_consta |
dependenciaDeSustancias | texto | opcional | uno de: si, no, no_consta |
deshabituacionAcreditada | texto | opcional | uno de: si, no, no_consta |
enTratamiento | verdadero/falso | opcional | |
delitoSobreLaMujerPorLaPareja | verdadero/falso | opcional | |
delitoContraLaLibertadSexualOTrata | verdadero/falso | opcional | |
soloPerseguibleADenunciaOQuerella | verdadero/falso | opcional |
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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
penas | lista de objeto | siempre | |
sumaComputable | número | siempre | |
mayorPenaDePrision | número o nulo | siempre | |
vias | lista de objeto | siempre | |
viasNoExaminadas | lista de objeto | siempre | |
loQueDecideElJuez | lista de texto | siempre | |
huecos | lista de objeto | siempre | |
supuestos | lista de texto | siempre | |
avisos | lista de texto | siempre | |
fundamento | lista de texto | siempre | |
traza | lista de texto | siempre |
Respuestas posibles
200— Análisis con su traza400— Datos no válidos401— Sin autenticar402— 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": [] }'/v1/dev/calculadoras/salario-reguladorSalario regulador desde nóminas y convenio
ET y convenio aplicable. Devuelve las dos lecturas del salario diario siempre.
Cuerpo JSON de la petición
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
conceptos | lista de objeto | obligatorio | |
pagasProrrateadasEnLaMensualidad | verdadero/falso | opcional | |
periodo | texto | opcional | hasta 200 caracteres |
criterio | texto | opcional | uno de: anio-natural, mes-de-treinta-dias |
diasDelAnio | texto | opcional |
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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
lineas | lista de objeto | siempre | |
baseAnual | entero | siempre | mínimo 0; máximo 100000000000 |
baseMensual | entero | siempre | mínimo 0; máximo 100000000000 |
excluidoAnual | entero | siempre | mínimo 0; máximo 100000000000 |
sinClasificarAnual | entero | siempre | mínimo 0; máximo 100000000000 |
pendientesDeClasificar | lista de texto | siempre | |
lecturas | lista de objeto | siempre | |
salarioDiario | entero o nulo | siempre | mínimo 0; máximo 100000000000 |
criterioElegido | texto o nulo | siempre | uno de: anio-natural, mes-de-treinta-dias |
especie | objeto o nulo | siempre | |
avisos | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
fundamento | lista de texto | siempre | |
traza | lista de texto | siempre |
Respuestas posibles
200— Cálculo con su traza400— Datos no válidos401— Sin autenticar402— 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": [] }'/v1/dev/calculadoras/salarios-tramitacionSalarios 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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
despido | fecha (AAAA-MM-DD) | obligatorio | |
notificacionSentencia | fecha (AAAA-MM-DD) | obligatorio | |
salarioDiario | entero | obligatorio | mínimo 0; máximo 100000000000 |
fallo | texto | obligatorio | uno de: improcedente, nulo |
opcion | texto | opcional | uno de: readmision, indemnizacion |
representanteLegalOSindical | verdadero/falso | opcional | |
cierre | objeto | opcional | |
otroEmpleo | objeto | opcional | |
desempleoPercibido | entero | opcional | mínimo 0; máximo 100000000000 |
reclamacionAlEstado | objeto | opcional | |
extincionObjetiva | verdadero/falso | opcional |
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": ,
"fallo": "improcedente"
}Campos de la respuesta (200)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
procede | verdadero/falso | siempre | |
motivoNoProcede | texto o nulo | siempre | |
computo | objeto o nulo | siempre | |
lecturas | lista de objeto | siempre | |
fundamento | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
avisos | lista de texto | siempre |
Respuestas posibles
200— Cálculo con su traza400— Datos no válidos401— Sin autenticar402— 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" }'/v1/dev/calculadoras/silencioSilencio administrativo
arts. 21 a 25 LPAC: plazo máximo para resolver, sentido del silencio y recurso.
Cuerpo JSON de la petición
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
inicio | texto | obligatorio | uno de: solicitud_del_interesado, de_oficio |
fechaInicio | fecha (AAAA-MM-DD) | obligatorio | |
plazoMaximo | objeto | opcional | |
objeto | texto | opcional | uno de: ordinario, derecho_de_peticion, dominio_publico_o_servicio_publico, dano_al_medio_ambiente, responsabilidad_patrimonial, impugnacion_o_revision_de_oficio |
alzadaContraSilencioDesestimatorio | verdadero/falso | opcional | |
naturalezaDeOficio | texto | opcional | uno de: favorable, gravamen_o_sancionador |
sentidoSegunLaNorma | texto | opcional | uno de: estimatorio, desestimatorio |
fuenteDelSentido | texto | opcional | |
viaSiguiente | texto | opcional | uno de: recurso_contencioso, recurso_de_alzada, recurso_de_reposicion, sin_determinar |
suspensiones | lista de objeto | opcional | |
festivos | lista de fecha (AAAA-MM-DD) | opcional | |
derechosFundamentales | verdadero/falso | opcional |
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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
plazoParaResolver | objeto | siempre | |
caducidad | objeto o nulo | siempre | |
sentido | texto o nulo | siempre | uno de: estimatorio, desestimatorio |
sentidoFundamento | texto | siempre | |
reglaGeneral | texto | siempre | |
lecturas | lista de objeto | siempre | |
recurso | objeto o nulo | siempre | |
avisos | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
fundamento | lista de texto | siempre |
Respuestas posibles
200— Cálculo con su traza400— Datos no válidos401— Sin autenticar402— 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" }'/v1/dev/calculadoras/finiquitoFiniquito (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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
antiguedad | fecha (AAAA-MM-DD) | obligatorio | |
extincion | fecha (AAAA-MM-DD) | obligatorio | |
causa | texto | obligatorio | uno de: despido_improcedente, despido_objetivo, fin_contrato_temporal, muerte_jubilacion_incapacidad_empresario, dimision, otra |
base | objeto | obligatorio | |
diasTrabajadosDelMes | entero | opcional | mínimo 0; máximo 31 |
pagas | lista de objeto | obligatorio | |
vacaciones | objeto | opcional | |
salarioReguladorDiario | entero | opcional | mínimo 0; máximo 100000000000 |
fechaContrato | fecha (AAAA-MM-DD) | opcional | |
tipoContratoTemporal | texto | opcional | uno 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":
},
"pagas": []
}Campos de la respuesta (200)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
conceptos | lista de objeto | siempre | |
total | objeto o nulo | siempre | |
sumaDeLoCuantificado | objeto | siempre | |
sinCuantificar | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
avisos | lista de texto | siempre | |
fundamento | lista de texto | siempre | |
traza | lista de texto | siempre |
Respuestas posibles
200— Liquidación con su traza400— Datos no válidos401— Sin autenticar402— 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": [] }'/v1/dev/calculadoras/baremoBaremo 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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
seccion | texto | obligatorio | uno de: muerte |
fechaAccidente | fecha (AAAA-MM-DD) | obligatorio | |
anioDeterminacion | entero | obligatorio | mínimo 2016; máximo 2100 |
edadVictima | entero | opcional | mínimo 0; máximo 130. sólo en algunas variantes del cuerpo |
perjudicados | lista de objeto | opcional | sólo en algunas variantes del cuerpo |
dias | objeto | opcional | sólo en algunas variantes del cuerpo |
puntos | entero | opcional | mínimo 0; máximo 100. sólo en algunas variantes del cuerpo |
puntosConcurrentes | lista de entero | opcional | sólo en algunas variantes del cuerpo |
puntosEsteticos | entero | opcional | mínimo 0; máximo 50. sólo en algunas variantes del cuerpo |
edad | entero | opcional | mí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": ,
"edadVictima": ,
"perjudicados": []
}Campos de la respuesta (200)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
seccion | texto | siempre | uno de: muerte, temporales, secuelas |
partidas | lista de objeto | a veces | |
total | entero | a veces | mínimo 0; máximo 100000000000 |
tramos | lista de objeto | a veces | |
diasTotales | número | a veces | |
importeDias | entero | a veces | mínimo 0; máximo 100000000000 |
intervenciones | objeto o nulo | a veces | |
totalMinimo | entero | a veces | mínimo 0; máximo 100000000000 |
totalMaximo | entero | a veces | mínimo 0; máximo 100000000000 |
puntos | número | a veces | |
edad | número | a veces | |
columnaEdadDesde | número | a veces | |
psicofisico | objeto o nulo | a veces | |
estetico | objeto o nulo | a veces | |
concurrencia | objeto o nulo | a veces | |
fundamento | lista de texto | siempre | |
traza | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
procedencia | objeto | siempre | |
tabla | objeto | siempre |
Respuestas posibles
200— Cálculo con su traza400— Datos no válidos401— Sin autenticar402— 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": [] }'/v1/dev/calculadoras/prescripcion-delitoPrescripció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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
penas | lista de objeto | obligatorio | |
delitoLeve | verdadero/falso | opcional | |
injuriasOCalumnias | verdadero/falso | opcional | |
imprescriptible | verdadero/falso | opcional | |
modalidad | texto | obligatorio | uno de: instantaneo, continuado, permanente, habitualidad |
fechaDeReferencia | fecha (AAAA-MM-DD) | obligatorio | |
victimaMenor | objeto | opcional | |
interrupciones | lista de objeto | opcional | |
hoy | fecha (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)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
estado | texto | siempre | uno de: prescribe, imprescriptible, sin_plazo, interrumpida, en_suspenso |
prescribeEl | texto o nulo | siempre | |
anios | entero o nulo | siempre | |
tramo | texto o nulo | siempre | uno 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 |
fundamento | texto | siempre | |
diesAQuo | texto | siempre | |
diesAQuoMotivo | texto | siempre | |
yaPrescrito | verdadero/falso o nulo | siempre | |
traza | lista de texto | siempre | |
avisos | lista de texto | siempre | |
noResuelto | lista de texto | siempre |
Respuestas posibles
200— Fecha con su regla, sus avisos y lo que el artículo no resuelve400— Datos no válidos401— Sin autenticar402— 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" }'/v1/dev/calculadoras/intereses-demoraIntereses 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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
principalCentimos | entero | obligatorio | mínimo 0 |
desde | fecha (AAAA-MM-DD) | obligatorio | |
hasta | fecha (AAAA-MM-DD) | obligatorio | |
regimen | texto | obligatorio | uno de: civil_1108 |
tipoPactado | objeto | opcional | sólo en algunas variantes del cuerpo |
fechaSiniestro | fecha (AAAA-MM-DD) | opcional | sólo en algunas variantes del cuerpo |
tiposSemestrales | lista de objeto | opcional | sólo en algunas variantes del cuerpo |
costesDeCobro | verdadero/falso | opcional | 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)
{
"principalCentimos": ,
"desde": "2026-01-01",
"hasta": "2026-01-01",
"regimen": "civil_1108"
}Campos de la respuesta (200)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
desenlace | texto | siempre | uno de: calculado, faltan_tipos, antes_de_la_ley |
regimen | texto | siempre | uno de: civil_1108, seguro_lcs, comercial_3_2004 |
principalCentimos | entero | siempre | |
desde | texto | siempre | |
hasta | texto | siempre | |
tramos | lista de objeto | siempre | |
interesCentimos | entero o nulo | siempre | |
totalCentimos | entero o nulo | siempre | |
costesDeCobroCentimos | entero o nulo | siempre | |
diasSinTipo | entero | siempre | |
fundamento | lista de texto | siempre | |
traza | lista de texto | siempre | |
supuestos | lista de texto | siempre | |
noResuelve | lista de texto | siempre |
Respuestas posibles
200— El interés con su desglose, o el motivo por el que no se da un total400— Datos no válidos401— Sin autenticar402— 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" }'/v1/dev/plazos/calendarios-oficialesFestivos 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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
desde | entero | obligatorio | mínimo 2000; máximo 2100 |
hasta | entero | obligatorio | mínimo 2000; máximo 2100 |
municipios | texto | opcional | patrón ^\d{5}(,\d{5}){0,19}$ |
Campos de la respuesta (200)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
calendarios | lista de objeto | siempre | |
municipios | lista de objeto | siempre |
Respuestas posibles
200— Calendarios400— Rango no válido401— Sin autenticar
curl
curl "https://api.jurilia.com/v1/dev/plazos/calendarios-oficiales" \
-H "Authorization: Bearer TU_CLAVE"/v1/dev/plazos/municipiosBuscar 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
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
q | texto | obligatorio | al menos 2 caracteres; hasta 80 caracteres |
Campos de la respuesta (200)
| Campo | Tipo | ¿Obligatorio? | Valores y notas |
|---|---|---|---|
municipios | lista de objeto | siempre |
Respuestas posibles
200— Municipios400— Búsqueda no válida401— 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.
/v1/dev/saldoConsultar 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": ,
"reservadoCentimos": ,
"disponibleCentimos":
}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.
/v1/dev/asistentePreguntar 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": , "ambares": , "rojas": ,
"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": ,
"saldoCentimos": ,
"facturacion": { "cobradoCentimos": , "saldoRestanteCentimos": , "ocrCentimos": },
"documentos": null // con archivos: { "ficheros": , "paginas": , "paginasLeidasConOcr": , "caracteresEnviados": , "recortado": false }
} // cabeceras: X-Jurilia-Coste-Centimos, X-Jurilia-Saldo-CentimosPuede 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',
})/v1/dev/preguntarPregú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": , "ambares": , "rojas": , "citas": [ … ] },
"estado": "propuesto",
"aviso": "Respuesta generada por inteligencia artificial …",
"facturacion": { "cobradoCentimos": , "saldoRestanteCentimos": , "tokens": { … } }
} // cabeceras: X-Jurilia-Coste-Centimos, X-Jurilia-Saldo-CentimosPuede 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. 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_xxxxxxxxxxxxxxxx2. 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. 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. 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. 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ámetro | Qué hace |
|---|---|
X-Request-Id | En 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+json | Todo error (RFC 9457): type, title, status, detail, instance, además de codigo, mensaje, sugerencia, documentacion e id_peticion. |
RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset | Tu 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-Match | Toda 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-Centimos | Lo que ha costado la llamada y lo que te queda (también como X-Jurilia-*). |
?estimar=1 | Cuánto costaría la llamada, sin ejecutarla ni cobrarla. |
?campos=a,b.c | Só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-Key | Al 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, Sunset | Si 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: prueba | La 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.
| Clase | Qué incluye | Precio |
|---|---|---|
simple | Una lectura por índice: la ficha, un dato de una fuente, una marca. | 3 céntimos |
cruce | Un cruce de varias fuentes o una expansión de la red: vínculos, dinero público, cronología. | 8 céntimos |
grafo | Un recorrido del grafo de relaciones entre varias sociedades o personas. | 15 céntimos |
avance | El avance del dossier: los totales de las veinte secciones de la ficha. | 15 céntimos |
dossier | El dossier profesional en PDF: todas las secciones, el mapa, el render, el cifrado y el código de verificación. | 250 céntimos |
alta_vigilada | Poner una sociedad en una lista vigilada (una sola vez por sociedad y suscripción). | 15 céntimos |
descarga | La descarga de una lista de prospección en Excel o CSV (hasta las filas que fija el servidor). | 200 céntimos |
biblioteca_articulo | Un 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_busqueda | Una búsqueda de artículos en la biblioteca jurídica. | 3 céntimos |
calculadora | Un cálculo de cualquiera de las calculadoras jurídicas, con su fundamento. | 5 céntimos |
plazo | El cómputo de un plazo (días hábiles y festivos de los cuatro órdenes). | 10 céntimos |
prueba_aviso | El aviso de prueba de una suscripción. | 1 céntimo |
lote | Un 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_cronologia | La cronología cruzada de un caso: los hechos publicados de todos sus elementos (hasta 200), cada uno con su fuente. | 15 céntimos |
caso_red | El mapa de conexiones de un caso: la red de sus doce primeros elementos, lista para exportar. | 30 céntimos |
caso_informe | El 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_comprobar | Volver a ejecutar una búsqueda guardada y compararla con la vez anterior: quién entra y quién sale. | 15 céntimos |
aviso | Cada 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.
/v1/dev/empresas/resolverEncontrar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
q | texto | sí | Lo que se busca.. al menos 1 caracteres; hasta 300 caracteres |
provincia | texto | no | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 60 caracteres |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"motivo": "motivo",
"motivoCodigo": "url_exacta"
},
"alternativas": [
{
"empresa": {
"id": "12345",
"denominacion": "ACME SERVICIOS SL",
"provincia": "MADRID",
"hoja": "M-123456",
"titular": "sociedad",
"ultimaPublicacion": "ultimaPublicacion"
},
"confianza": ,
"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.
/v1/dev/empresas/{empresaId}/nifEl 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
idioma | texto | no | Idioma 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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"
}
]
}/v1/dev/empresas/{empresaId}/senalesSeñ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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"paginas": ,
"total": ,
"porPagina":
},
"senales": [
{
"tipo": "tipo",
"fecha": "2026-10-22",
"desde": "2026-10-22",
"cuantos": ,
"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": ,
"fecha": "2026-10-22"
}
}
]
}
],
"siguienteCursor": "siguienteCursor"
}/v1/dev/empresas/{empresaId}/datos-objetivosDatos 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
idioma | texto | no | Idioma 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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"
}/v1/dev/empresas/{empresaId}/hechosHechos 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"paginas": ,
"total": ,
"porPagina":
},
"hechos": [
{
"tipo": "tipo",
"fecha": "2026-10-22",
"desde": "2026-10-22",
"cuantos": ,
"administracion": {
"nombramientos": ,
"ceses":
},
"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": ,
"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": ,
"fecha": "2026-10-22"
}
},
"cobertura": {
"desde": "2026-10-22",
"hasta": "2026-10-22",
"anios": ,
"ventanaDeAdministradores": {
"desde": "2026-10-22",
"hasta": "2026-10-22"
}
},
"siguienteCursor": "siguienteCursor"
}/v1/dev/empresas/{empresaId}/linea-de-tiempoLí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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"paginas": ,
"total": ,
"porPagina":
},
"recortada": true,
"hitos": [
{
"fecha": "2026-10-22",
"numero": ,
"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": ,
"domicilio": "domicilio",
"denominacion": "ACME SERVICIOS SL"
}
],
"siguienteCursor": "siguienteCursor"
}/v1/dev/empresas/{empresaId}/anunciosSecciones 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"tipo": "tipo",
"epigrafe": "epigrafe",
"denominacion": "ACME SERVICIOS SL",
"denominacionLegible": "Acme Servicios, S.L.",
"ejercicio": ,
"fechaIndicada": "fechaIndicada",
"detalle": "detalle"
}
],
"total": ,
"pagina":
},
"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": ,
"conTexto": true
}
],
"total": ,
"pagina":
},
"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"
}/v1/dev/empresas/{empresaId}/marcasMarcas 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": [
],
"estado": "solicitada",
"estadoPublicado": "estadoPublicado",
"fechaEstado": "2026-10-22",
"fechaSolicitud": "2026-10-22",
"fechaRegistro": "2026-10-22"
}
],
"total": ,
"pagina": ,
"paginas": ,
"porPagina": ,
"porEstado": {
"solicitada": ,
"concedida": ,
"caducada": ,
"otro":
},
"actualizadoEn": "2026-10-22T00:00:00.000Z",
"siguienteCursor": "siguienteCursor"
}/v1/dev/empresas/{empresaId}/boeLos 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"paginas": ,
"total": ,
"porPagina":
},
"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"
}/v1/dev/empresas/{empresaId}/emisionesInstalaciones 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"paginas": ,
"total": ,
"porPagina":
},
"bloques": [
{
"codigoPrtr": ,
"nombre": "ANA GARCIA LOPEZ",
"municipio": "municipio",
"provincia": "MADRID",
"anyo": ,
"emisiones": [
{
"contaminante": "contaminante",
"medio": "aire",
"receptor": "receptor",
"cantidadKg": "cantidadKg",
"metodo": "M"
}
]
}
],
"complejos": [
{
"codigoPrtr": ,
"nombre": "ANA GARCIA LOPEZ",
"municipio": "municipio",
"provincia": "MADRID",
"actividad": "actividad",
"anyos": {
"desde": ,
"hasta":
}
}
],
"totalComplejos": ,
"cobertura": {
"desde": ,
"hasta": ,
"actualizadoEl": "2026-10-22"
},
"siguienteCursor": "siguienteCursor"
}/v1/dev/empresas/{empresaId}/tedContratos 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"paginas": ,
"total": ,
"porPagina":
},
"filas": [
{
"publicacion": "publicacion",
"fecha": "2026-10-22",
"comprador": "comprador",
"compradorPais": "compradorPais",
"compradores": ,
"objeto": "objeto",
"cpv": "cpv",
"importeCentimos": ,
"moneda": "moneda",
"adjudicatarios": ,
"tamano": "pyme",
"urlOficial": "https://consultas2.oepm.es/ceo/jsp/busqueda/consultaAvanzada.xhtml"
}
],
"cobertura": {
"desde": "2026-10-22",
"hasta": "2026-10-22"
},
"siguienteCursor": "siguienteCursor"
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
fecha | fecha (AAAA-MM-DD) | sí | Fecha de calendario, AAAA-MM-DD. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"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": ,
"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": ,
"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": ,
"fecha": "2026-10-22"
}
},
"finPor": "extincion",
"enLiquidacion": true
}
],
"anteriorALoCargado": true,
"incompleto": true,
"cobertura": {
"desde": "2026-10-22",
"hasta": "2026-10-22",
"diasConBoletin": ,
"continua": true
}
}/v1/dev/empresas/{empresaId}/leiCó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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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"
}
}/v1/dev/empresas/{empresaId}/fondos-ueFondos 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"programa": "programa",
"centimos": ,
"compromisos":
}
],
"totalFilas": ,
"totalCentimos": ,
"anioDesde": ,
"anioHasta": ,
"ultimoAnioCargado": ,
"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"
}
}/v1/dev/empresas/{empresaId}/registros-catalunaInscripciones 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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"
}
}/v1/dev/empresas/{empresaId}/registro-transparencia-ueInscripciones 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"maxCentimos":
},
"acreditados": ,
"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"
}
}/v1/dev/empresas/{empresaId}/vinculosSociedades 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"hayMas": true,
"homonimos": "posibles",
"filas": [
{
"id": "12345",
"denominacion": "ACME SERVICIOS SL",
"denominacionLegible": "Acme Servicios, S.L.",
"provincia": "MADRID",
"provinciaLegible": "Madrid",
"personasEnComun": ,
"personas": [
{
"clave": "clave",
"slug": "ana-garcia-lopez"
}
],
"rutaWeb": "rutaWeb"
}
],
"siguienteCursor": "siguienteCursor"
}/v1/dev/empresas/{empresaId}/genealogiaGenealogí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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"paginas": ,
"total": ,
"porPagina":
},
"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": ,
"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": ,
"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": ,
"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": ,
"fecha": "2026-10-22",
"tipo": "tipo",
"detalle": "detalle"
}
],
"siguienteCursor": "siguienteCursor"
}/v1/dev/empresas/{empresaId}/dinero-publicoDinero 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"urlAnuncio": "https://empresas.jurilia.com/"
}
],
"menores": {
"filas": [
{
"id": "12345",
"fichero": "perfiles",
"fecha": "2026-10-22",
"organo": "organo",
"objeto": "objeto",
"importeCentimos": ,
"urlAnuncio": "https://empresas.jurilia.com/"
}
],
"total": ,
"sinImporte": ,
"sumaCentimosConocidos":
},
"total": ,
"sinImporte": ,
"sumaCentimosConocidos": ,
"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": ,
"ayudaEquivalenteCentimos": ,
"urlBasesReguladoras": "https://empresas.jurilia.com/"
}
],
"total": ,
"totalesPorInstrumento": [
{
"instrumento": "instrumento",
"concesiones": ,
"importeCentimos": ,
"ayudaEquivalenteCentimos":
}
],
"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"
}
]
}/v1/dev/empresas/{empresaId}/comparativaCó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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"lectura": {
"metrica": "antiguedad",
"modo": "mas",
"porcentaje":
},
"sociedades":
}
]
}/v1/dev/empresas/{empresaId}/parecidasEmpresas 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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"
}
]
}
]
}/v1/dev/empresas/{empresaId}/cronologiaCronologí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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
tipo | texto | no | Tipo: filtro separado por comas en cronologías y listados; empresa, persona o domicilio en los elementos de un caso.. hasta 400 caracteres |
anio | texto | no | Año (AAAA).. hasta 4 caracteres |
orden | texto | no | reciente (por defecto) o antiguo.. hasta 10 caracteres. por defecto: reciente |
pagina | texto | no | Número de página, desde 1. Alternativa: cursor.. hasta 6 caracteres. por defecto: 1 |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor). Sustituye a pagina.. hasta 100 caracteres |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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"
}/v1/dev/empresas/{empresaId}/fichaFicha 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
idioma | texto | no | Idioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
paginaCargosVigentes | entero | no | Página de la lista de cargos vigentes (20 por página).. mínimo 1; máximo 10000. por defecto: 1 |
paginaCargosCesados | entero | no | Página de la lista de cargos cesados (20 por página).. mínimo 1; máximo 10000. por defecto: 1 |
paginaCapital | entero | no | Página del historial de capital (10 por página).. mínimo 1; máximo 10000. por defecto: 1 |
paginaDomicilios | entero | no | Página del historial de domicilios (10 por página).. mínimo 1; máximo 10000. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"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": ,
"fecha": "2026-10-22"
}
},
"concursal": {
"tipo": "tipo",
"fecha": "2026-10-22",
"numero": ,
"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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"fecha": "2026-10-22",
"centimos":
},
"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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"fecha": "2026-10-22",
"tipo": "tipo",
"importeCentimos": ,
"resultanteCentimos":
}
],
"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": ,
"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": ,
"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": ,
"fecha": "2026-10-22",
"provincia": "MADRID",
"datosRegistrales": "datosRegistrales",
"fechaInscripcion": "2026-10-22",
"actos": [
{
"tipo": "tipo",
"etiqueta": "etiqueta",
"capitalCentimos": ,
"capitalResultanteCentimos": ,
"domicilio": "domicilio",
"objeto": "objeto",
"comienzoOperaciones": "comienzoOperaciones",
"detalle": "detalle",
"cargos": [
{
"cargo": "Adm. Unico",
"nombre": "ANA GARCIA LOPEZ"
}
]
}
]
}
],
"paginacion": {
"pagina": ,
"paginas": ,
"total":
},
"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": ,
"fecha": "2026-10-22",
"actos": [
{
"tipo": "tipo",
"etiqueta": "etiqueta"
}
]
},
"listas": {
"cargosVigentes": {
"pagina": ,
"paginas": ,
"total": ,
"porPagina":
},
"cargosCesados": {
"pagina": ,
"paginas": ,
"total": ,
"porPagina":
},
"capital": {
"pagina": ,
"paginas": ,
"total": ,
"porPagina":
},
"domicilios": {
"pagina": ,
"paginas": ,
"total": ,
"porPagina":
}
},
"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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"fecha": "2026-10-22"
}
]
}
],
"dineroPublico": {
"nif": "A58818501",
"subvenciones": "subvenciones",
"contratos": "contratos"
}
}
}/v1/dev/empresas/{empresaId}/resumenResumen 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
idioma | texto | no | Idioma 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"fecha": "2026-10-22",
"actos": [
{
"tipo": "tipo",
"etiqueta": "etiqueta"
}
]
},
"soloHechosPublicados": true
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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/"
}/v1/dev/empresas/{empresaId}/noticiasNoticias 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
idioma | texto | no | Idioma 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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.
/v1/dev/personas/{slug}/cronologiaCronologí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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
slug | texto | sí | 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 |
tipo | texto | no | Tipo: filtro separado por comas en cronologías y listados; empresa, persona o domicilio en los elementos de un caso.. hasta 400 caracteres |
anio | texto | no | Año (AAAA).. hasta 4 caracteres |
orden | texto | no | reciente (por defecto) o antiguo.. hasta 10 caracteres. por defecto: reciente |
pagina | texto | no | Número de página, desde 1. Alternativa: cursor.. hasta 6 caracteres. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"homonimos": "posibles",
"recortada": true,
"filtro": {
"tipos": [
"constitucion"
],
"anio": ,
"orden": "reciente"
},
"total": ,
"pagina": ,
"paginas": ,
"porPagina": ,
"porTipo": [
{
"tipo": "constitucion",
"n":
}
],
"porAnio": [
{
"anio": ,
"n":
}
],
"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": ,
"fecha": "2026-10-22",
"provincia": "MADRID",
"provinciaLegible": "Madrid"
}
}
],
"soloHechos": true
}/v1/dev/personas/{slug}/coincidenciasCon 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
slug | texto | sí | 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 |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
con | texto | no | Slug 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 |
paginaSociedades | entero | no | Pá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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"sociedadesConSolape": ,
"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": ,
"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": ,
"fecha": "2026-10-22"
}
}
]
}
]
}
],
"totalDePersonas": ,
"paginacion": {
"pagina": ,
"paginas": ,
"total": ,
"porPagina":
},
"abierta": "abierta",
"paginacionSociedades": {
"pagina": ,
"paginas": ,
"total": ,
"porPagina":
},
"sociedadesMiradas": ,
"recortadaPorSociedades": true,
"lecturaParcial": true,
"agotada": true,
"homonimos": "posibles"
}/v1/dev/personas/{slug}/vinculosNombres 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
slug | texto | sí | 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 |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"hayMas": true,
"homonimos": "posibles",
"filas": [
{
"slug": "ana-garcia-lopez",
"nombre": "ANA GARCIA LOPEZ",
"nombreLegible": "Ana García López",
"empresasEnComun": ,
"empresas": [
{
"id": "12345",
"denominacion": "ACME SERVICIOS SL",
"rutaWeb": "rutaWeb"
}
],
"rutaWeb": "rutaWeb"
}
]
}/v1/dev/personas/{slug}/datos-objetivosDatos 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
slug | texto | sí | 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 |
idioma | texto | no | Idioma 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"fecha": "2026-10-22",
"datos": {
"desde": "2026-10-22",
"hasta": "2026-10-22",
"primera": "2026-10-22",
"nombramientos": ,
"ceses": ,
"sociedades": ,
"anios": ,
"alMenos": ,
"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": ,
"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"
}/v1/dev/personas/{slug}/fichaFicha 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
slug | texto | sí | 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 |
paginaSociedades | entero | no | Pá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 |
paginaCronologia | entero | no | Página de la cronología de apariciones (50 por página).. mínimo 1; máximo 10000 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"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": ,
"sociedadesVigentes": ,
"apariciones":
},
"listas": {
"sociedades": {
"pagina": ,
"paginas": ,
"total": ,
"porPagina":
},
"cronologia": {
"pagina": ,
"paginas": ,
"total": ,
"porPagina":
}
}
}Red de relaciones
Conexiones sociedad–persona–sociedad con el acto del BORME que prueba cada salto.
/v1/dev/redLos 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
nodo | texto | sí | 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"sociedadesAcotadas": true,
"grado": ,
"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": ,
"sociedadesAcotadas": true,
"grado": ,
"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":
}
}
],
"sentido": "entrante"
}
],
"total":
}/v1/dev/rastroEl 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
a | texto | sí | Un extremo: e:<id> o p:<slug>.. al menos 3 caracteres; hasta 320 caracteres |
b | texto | sí | El otro extremo: e:<id> o p:<slug>.. al menos 3 caracteres; hasta 320 caracteres |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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"
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
a | texto | sí | Un extremo: e:<id> o p:<slug>.. al menos 3 caracteres; hasta 320 caracteres |
b | texto | sí | El otro extremo: e:<id> o p:<slug>.. al menos 3 caracteres; hasta 320 caracteres |
nodosGrandes | texto | no | 1 para poder atravesar nodos muy comunes (se marcan en la respuesta).. uno de: 0, 1. por defecto: 0 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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"
}/v1/dev/compararComparar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
ids | texto | sí | 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"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": ,
"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": ,
"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": ,
"fecha": "2026-10-22"
}
},
"administradoresVigentes": ,
"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": ,
"fecha": "2026-10-22"
}
},
"senales": [
{
"tipo": "tipo",
"fecha": "2026-10-22",
"desde": "2026-10-22",
"cuantos": ,
"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": ,
"fecha": "2026-10-22"
}
}
]
}
],
"rutaWeb": "rutaWeb"
}
],
"minimo": ,
"maximo":
}/v1/dev/comparar/cronologiaCronologí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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
e | texto | no | Sociedades como e:<id> separadas por comas.. hasta 1000 caracteres |
ids | texto | no | Identificadores de sociedad separados por comas (de 2 a 8).. hasta 1000 caracteres |
tipo | texto | no | Tipo: filtro separado por comas en cronologías y listados; empresa, persona o domicilio en los elementos de un caso.. hasta 400 caracteres |
anio | texto | no | Año (AAAA).. hasta 4 caracteres |
orden | texto | no | reciente (por defecto) o antiguo.. hasta 10 caracteres. por defecto: reciente |
pagina | texto | no | Número de página, desde 1. Alternativa: cursor.. hasta 6 caracteres. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"conNif": true,
"sinFecha": {
"placsp": ,
"sanciones_ue":
},
"recortadas": [
"borme"
]
}
],
"filtro": {
"tipos": [
"constitucion"
],
"anio": ,
"orden": "reciente"
},
"total": ,
"pagina": ,
"paginas": ,
"aniosPorPagina": ,
"porTipo": [
{
"tipo": "constitucion",
"n":
}
],
"porAnio": [
{
"anio": ,
"n":
}
],
"anios": [
{
"anio": ,
"celdas": [
{
"sociedadId": "sociedadId",
"total": ,
"restantes": ,
"hechos": [
{
"clave": "clave",
"fecha": "2026-10-22",
"tipo": "constitucion",
"origen": "borme",
"acto": "acto",
"etiquetaPublicada": "etiquetaPublicada",
"capitalCentimos": ,
"capitalResultanteCentimos": ,
"domicilio": "domicilio",
"objeto": "objeto",
"comienzoOperaciones": "comienzoOperaciones",
"detalle": "detalle",
"cargos": [],
"cargosOmitidos": ,
"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": ,
"fecha": "2026-10-22",
"provincia": "MADRID",
"provinciaLegible": "Madrid"
}
}
]
}
]
}
],
"coincidencias": {
"boletin": {
"total": ,
"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":
}
]
}
]
},
"domicilio": {
"total": ,
"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": ,
"fecha": "2026-10-22",
"provincia": "MADRID",
"provinciaLegible": "Madrid"
}
}
]
}
]
},
"nombres": {
"total": ,
"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": ,
"fecha": "2026-10-22",
"provincia": "MADRID",
"provinciaLegible": "Madrid"
}
}
],
"sociedadesEnElBorme": ,
"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.
/v1/dev/marcasBuscar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
q | texto | no | Lo que se busca.. hasta 300 caracteres |
modo | texto | no | Modo de coincidencia o de búsqueda.. hasta 300 caracteres. por defecto: contiene / empresa (según la ruta) |
clase | texto | no | Clase de Niza (1 a 45).. hasta 300 caracteres |
estado | texto | no | Filtro por estado: abierto o cerrado en los casos; rojo, ambar o verde en la cartera.. hasta 300 caracteres |
tipo | texto | no | Tipo: filtro separado por comas en cronologías y listados; empresa, persona o domicilio en los elementos de un caso.. hasta 300 caracteres |
pagina | texto | no | Número de página, desde 1. Alternativa: cursor.. hasta 300 caracteres. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"ignorados": [
"ignorado"
],
"total": ,
"acotado": true,
"pagina": ,
"paginas": ,
"porPagina": ,
"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": [
],
"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"
}
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
numero | texto | sí | 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": [
],
"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": [
],
"estado": "solicitada",
"estadoPublicado": "estadoPublicado",
"fechaEstado": "2026-10-22"
}
],
"total":
},
"parecidas": [
{
"signo": "signo",
"numero": "numero",
"rutaWeb": "rutaWeb",
"modalidad": "M",
"clases": [
],
"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.
/v1/dev/empresas/{empresaId}/dossier/avanceAvance 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
idioma | texto | no | Idioma 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"total": ,
"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"
]
}
]
}/v1/dev/empresas/{empresaId}/dossierDossier 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
idioma | texto | no | Idioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es |
secciones | texto | no | Las 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 |
red | texto | no | Hasta 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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.
/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
codigo | texto | sí | Código de verificación impreso en el PDF.. al menos 1 caracteres; hasta 40 caracteres |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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":
}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.
/v1/dev/empresas/portadaPortada: 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
401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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": ,
"cargos": ,
"inscripciones": ,
"dias": ,
"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": ,
"fecha": "2026-10-22",
"empresaId": "12345",
"denominacion": "ACME SERVICIOS SL",
"denominacionLegible": "Acme Servicios, S.L.",
"provincia": "MADRID",
"provinciaLegible": "Madrid",
"tipo": "tipo",
"capitalCentimos": ,
"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": ,
"fecha": "2026-10-22",
"empresaId": "12345",
"denominacion": "ACME SERVICIOS SL",
"denominacionLegible": "Acme Servicios, S.L.",
"provincia": "MADRID",
"provinciaLegible": "Madrid",
"tipo": "tipo",
"capitalCentimos": ,
"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": ,
"fecha": "2026-10-22",
"empresaId": "12345",
"denominacion": "ACME SERVICIOS SL",
"denominacionLegible": "Acme Servicios, S.L.",
"provincia": "MADRID",
"provinciaLegible": "Madrid",
"tipo": "tipo",
"capitalCentimos": ,
"rutaWeb": "rutaWeb"
}
]
},
"provincias": [
{
"provincia": "MADRID",
"provinciaLegible": "Madrid",
"provinciaSlug": "madrid",
"empresas":
}
],
"tiposDestacados": [
"tiposDestacado"
]
}/v1/dev/empresas/buscarBuscar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
q | texto | sí | Lo que se busca.. al menos 1 caracteres; hasta 120 caracteres |
modo | texto | no | Modo de coincidencia o de búsqueda.. uno de: empresa, persona. por defecto: contiene / empresa (según la ruta) |
provincia | texto | no | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 60 caracteres |
titular | texto | no | Tipo de titular: sociedad o empresario_individual.. uno de: sociedad, empresario_individual |
estado | texto | no | Filtro por estado: abierto o cerrado en los casos; rojo, ambar o verde en la cartera.. uno de: concurso, disolucion, extincion |
limite | entero | no | Máximo de resultados.. mínimo 1; máximo 50. por defecto: 50 (avisos: entregas) · 100 (eventos) · 20 (búsquedas) |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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": ,
"fecha": "2026-10-22"
}
},
"rutaWeb": "rutaWeb"
}
],
"personas": [
{
"slug": "ana-garcia-lopez",
"nombre": "ANA GARCIA LOPEZ",
"nombreLegible": "Ana García López",
"empresas": ,
"ultimaAparicion": "2026-10-22",
"homonimos": "posibles",
"casa": "exacto",
"rutaWeb": "rutaWeb"
}
],
"tambienPuedeBuscar": [
{
"clase": "municipio",
"id": "12345",
"nombre": "ANA GARCIA LOPEZ",
"provincia": "MADRID",
"sociedades": ,
"rutaWeb": "rutaWeb",
"extinguida": true,
"denominacion": "ACME SERVICIOS SL",
"denominacionLegible": "Acme Servicios, S.L."
}
]
}/v1/dev/empresas/sugerenciasSugerencias 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
q | texto | sí | Lo que se busca.. al menos 1 caracteres; hasta 120 caracteres |
personas | texto | no | true para sugerir sólo personas (hasta cinco); sin él, empresas, municipios, sectores y domicilios.. uno de: true, false |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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": ,
"rutaWeb": "rutaWeb",
"extinguida": true,
"valor": "valor",
"fuenteNif": "borme"
}
]
}/v1/dev/empresas/provinciasLas 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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":
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
provincia | texto | sí | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres |
estado | texto | no | Filtro por estado: abierto o cerrado en los casos; rojo, ambar o verde en la cartera.. uno de: concurso, disolucion, extincion |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"hayMas": true,
"total": ,
"municipios": [
{
"slug": "ana-garcia-lopez",
"nombre": "ANA GARCIA LOPEZ",
"empresas": ,
"ultimaPublicacion": "2026-10-22",
"rutaWeb": "rutaWeb",
"codigo": "ABCD-1234"
}
],
"sectores": [
{
"slug": "ana-garcia-lopez",
"nombre": "ANA GARCIA LOPEZ",
"empresas": ,
"ultimaPublicacion": "2026-10-22",
"rutaWeb": "rutaWeb",
"division": {
"codigo": "ABCD-1234",
"titulo": "titulo"
}
}
],
"iniciales": [
{
"letra": "letra",
"slug": "ana-garcia-lopez",
"fichas":
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
provincia | texto | sí | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres |
municipio | texto | sí | Nombre o slug del municipio.. al menos 1 caracteres; hasta 120 caracteres |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"pagina": ,
"paginas": ,
"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"
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
provincia | texto | sí | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres |
sector | texto | sí | Sector: división CNAE de dos cifras, o su slug.. al menos 1 caracteres; hasta 120 caracteres |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"pagina": ,
"paginas": ,
"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"
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
provincia | texto | sí | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres |
letra | texto | sí | Letra inicial.. al menos 1 caracteres; hasta 10 caracteres |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"pagina": ,
"paginas": ,
"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"
}
]
}/v1/dev/empresas/provincias/{provincia}/observatorioObservatorio 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
provincia | texto | sí | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"diasDelMes":
},
"cifras": [
{
"acto": "constitucion",
"actos": ,
"frenteAlAnterior": {
"diferencia": ,
"porcentaje":
},
"frenteAlAnioAnterior": {
"diferencia": ,
"porcentaje":
}
}
]
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
provincia | texto | sí | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres |
acto | texto | sí | Tipo de acto del BORME (por ejemplo constitucion, nombramientos, disolucion).. al menos 1 caracteres; hasta 40 caracteres |
mes | texto | sí | Mes, AAAA-MM.. patrón ^\d{4}-(0[1-9]|1[0-2])$ |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"cobertura": {
"estado": "completo",
"diasCargados": ,
"diasDelMes":
},
"pagina": ,
"hayMas": true,
"actos": [
{
"empresaId": "12345",
"denominacion": "ACME SERVICIOS SL",
"denominacionLegible": "Acme Servicios, S.L.",
"fecha": "2026-10-22",
"numero": ,
"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"
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
tipo | texto | sí | 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 |
provincia | texto | no | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 60 caracteres |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"hayMas": true,
"actos": [
{
"fecha": "2026-10-22",
"numero": ,
"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": ,
"capitalResultanteCentimos": ,
"domicilio": "domicilio",
"detalle": "detalle",
"rutaWeb": "rutaWeb"
}
]
}/v1/dev/empresas/rankingsRankings: 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
criterio | texto | no | Qué se ordena: capital, antiguedad o recientes (las últimas constituidas sólo existen de toda España). Por defecto capital.. uno de: capital, antiguedad, recientes |
ambito | texto | no | Dónde: nacional (por defecto), comunidad, provincia o sector.. uno de: nacional, comunidad, provincia, sector |
valor | texto | no | El á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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"id": "12345",
"denominacion": "ACME SERVICIOS SL",
"denominacionLegible": "Acme Servicios, S.L.",
"provincia": "MADRID",
"provinciaLegible": "Madrid",
"valor": ,
"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": ,
"fecha": "2026-10-22"
},
"rutaWeb": "rutaWeb"
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
letra | texto | sí | Letra inicial.. al menos 1 caracteres; hasta 10 caracteres |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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":
}
]
}/v1/dev/empresas/barometroBaró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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
granularidad | texto | no | dia, semana (por defecto) o mes.. uno de: dia, semana, mes |
clave | texto | no | El 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"comparacion": {
"diferencia": ,
"porcentaje":
}
},
"disolucion": {
"actos": ,
"comparacion": {
"diferencia": ,
"porcentaje":
}
},
"extincion": {
"actos": ,
"comparacion": {
"diferencia": ,
"porcentaje":
}
},
"ampliacion_de_capital": {
"actos": ,
"comparacion": {
"diferencia": ,
"porcentaje":
}
},
"reduccion_de_capital": {
"actos": ,
"comparacion": {
"diferencia": ,
"porcentaje":
}
},
"cambio_de_domicilio": {
"actos": ,
"comparacion": {
"diferencia": ,
"porcentaje":
}
}
}
}
],
"desglose": {
"clave": "clave",
"etiqueta": "etiqueta",
"completo": true,
"porProvincia": [
{
"provincia": "MADRID",
"provinciaLegible": "Madrid",
"comunidad": "comunidad",
"comunidadNombre": "comunidadNombre",
"porActo": {
"constitucion": ,
"disolucion": ,
"extincion": ,
"ampliacion_de_capital": ,
"reduccion_de_capital": ,
"cambio_de_domicilio":
},
"total":
}
],
"porComunidad": [
{
"comunidad": "comunidad",
"comunidadNombre": "comunidadNombre",
"porActo": {
"constitucion": ,
"disolucion": ,
"extincion": ,
"ampliacion_de_capital": ,
"reduccion_de_capital": ,
"cambio_de_domicilio":
},
"total":
}
]
},
"constitucionesPorSector": {
"clave": "clave",
"etiqueta": "etiqueta",
"completo": true,
"constituciones": ,
"conSector": ,
"sectores": [
{
"codigo": "ABCD-1234",
"titulo": "titulo",
"constituciones":
}
]
}
}/v1/dev/empresas/mapaConstituciones 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
q | texto | no | Lo que se busca.. hasta 120 caracteres |
municipio | texto | no | Nombre o slug del municipio.. al menos 1 caracteres; hasta 120 caracteres |
provincia | texto | no | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 60 caracteres |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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": ,
"fecha": "2026-10-22",
"empresaId": "12345",
"denominacion": "ACME SERVICIOS SL",
"denominacionLegible": "Acme Servicios, S.L.",
"provincia": "MADRID",
"domicilio": "domicilio",
"geocodificado": true,
"rutaWeb": "rutaWeb"
}
]
}
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
slug | texto | sí | 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 |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"vigentes": ,
"recortado": true,
"pagina": ,
"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":
},
"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":
}
}
]
}
],
"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":
},
"altaPor": "constitucion"
}
],
"eventosTotales":
}/v1/dev/empresas/avanzadaBú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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
provincia | texto | no | Nombre o slug de la provincia.. hasta 300 caracteres |
municipio | texto | no | Nombre o slug del municipio.. hasta 300 caracteres |
forma | texto | no | Siglas de la forma social: SL, SA, SLU, SAU, SLP, SLL, SCOOP…. hasta 300 caracteres |
sector | texto | no | Sector: división CNAE de dos cifras, o su slug.. hasta 300 caracteres |
situacion | texto o lista de texto | no | Situación: activa, concurso, disuelta o extinguida. Puede repetirse (cualquiera de ellas). |
const_desde | texto | no | Constituida desde esta fecha (AAAA-MM-DD).. hasta 300 caracteres |
const_hasta | texto | no | Constituida hasta esta fecha (AAAA-MM-DD).. hasta 300 caracteres |
fin_desde | texto | no | Disolución o extinción publicada desde esta fecha (la primera de las dos).. hasta 300 caracteres |
fin_hasta | texto | no | Disolución o extinción publicada hasta esta fecha.. hasta 300 caracteres |
vida_max | texto | no | Vida 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_min | texto | no | Capital mínimo, en euros.. hasta 300 caracteres |
cap_max | texto | no | Capital máximo, en euros.. hasta 300 caracteres |
cambios_min | texto | no | Al menos tantos cambios de administración publicados (en el periodo, si lo pones).. hasta 300 caracteres |
traslados_min | texto | no | Al menos tantos traslados de domicilio publicados (en el periodo, si lo pones).. hasta 300 caracteres |
organo | texto | no | Órgano de administración: administrador único, mancomunado, solidario, consejo…. hasta 300 caracteres |
nif | texto | no | 1 para sólo sociedades con NIF conocido sin ambigüedad.. hasta 300 caracteres |
contratos | texto | no | 1 para sólo sociedades con contratos públicos adjudicados.. hasta 300 caracteres |
subvenciones | texto | no | 1 para sólo sociedades con subvenciones concedidas.. hasta 300 caracteres |
persona | texto | no | Nombre de una persona con cargo, con nombre y apellidos como los publica el BORME. Un nombre no es una identidad.. hasta 300 caracteres |
vigente | texto | no | 1 para sólo sociedades donde esa persona tiene el cargo sin cese publicado.. hasta 300 caracteres |
domicilio | texto | no | La dirección entera como la publica el BORME («C/ MAYOR 12 (MADRID)»).. hasta 300 caracteres |
calle | texto | no | Calle 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 |
portal | texto | no | Número de portal, con calle. Sin él salen todas las sociedades de la calle.. hasta 300 caracteres |
edificio | texto | no | Tipo 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_anio | texto | no | Año de constitución.. hasta 300 caracteres |
comparte_min | texto | no | Comparte el último domicilio publicado con al menos tantas sociedades, ella incluida (de 2 a 5.000).. hasta 300 caracteres |
periodo_desde | texto | no | Año desde el que cuentan los cambios y traslados mínimos (sólo con cambios_min o traslados_min).. hasta 300 caracteres |
periodo_hasta | texto | no | Año hasta el que cuentan, ambos incluidos.. hasta 300 caracteres |
orden | texto | no | reciente (por defecto) o antiguo.. hasta 300 caracteres. por defecto: reciente |
pagina | texto | no | Número de página, desde 1. Alternativa: cursor.. hasta 300 caracteres. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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": ,
"acotado": true,
"pagina": ,
"paginas": ,
"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": ,
"cambiosAdministracion": ,
"traslados": ,
"pruebas": [
{
"criterio": "constitucion",
"fuente": "borme",
"fecha": "2026-10-22",
"cantidad": ,
"importeCentimos": ,
"texto": "texto",
"periodo": {
"desde": ,
"hasta":
},
"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": ,
"fecha": "2026-10-22"
}
}
],
"rutaWeb": "rutaWeb"
}
]
}/v1/dev/empresas/prospeccionLista 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
acto | texto | no | Tipo de acto del BORME (por ejemplo constitucion, nombramientos, disolucion).. hasta 300 caracteres |
periodo | texto | no | Periodo 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 |
desde | texto | no | Fecha de inicio, AAAA-MM-DD.. hasta 300 caracteres |
hasta | texto | no | Fecha final del rango (AAAA-MM-DD), con periodo=rango.. hasta 300 caracteres |
provincia | texto | no | Nombre o slug de la provincia.. hasta 300 caracteres |
municipio | texto | no | Nombre o slug del municipio.. hasta 300 caracteres |
forma | texto | no | Siglas de la forma social: SL, SA, SLU, SAU, SLP, SLL, SCOOP…. hasta 300 caracteres |
sector | texto | no | Sector: división CNAE de dos cifras, o su slug.. hasta 300 caracteres |
cap_min | texto | no | Capital mínimo, en euros.. hasta 300 caracteres |
pagina | texto | no | Número de página, desde 1. Alternativa: cursor.. hasta 300 caracteres. por defecto: 1 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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": ,
"acotado": true,
"pagina": ,
"paginas": ,
"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": ,
"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": ,
"rutaWeb": "rutaWeb"
}
]
}/v1/dev/empresas/prospeccion/descargaDescargar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
acto | texto | no | Tipo de acto del BORME (por ejemplo constitucion, nombramientos, disolucion).. hasta 300 caracteres |
periodo | texto | no | Periodo 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 |
desde | texto | no | Fecha de inicio, AAAA-MM-DD.. hasta 300 caracteres |
hasta | texto | no | Fecha final del rango (AAAA-MM-DD), con periodo=rango.. hasta 300 caracteres |
provincia | texto | no | Nombre o slug de la provincia.. hasta 300 caracteres |
municipio | texto | no | Nombre o slug del municipio.. hasta 300 caracteres |
forma | texto | no | Siglas de la forma social: SL, SA, SLU, SAU, SLP, SLL, SCOOP…. hasta 300 caracteres |
sector | texto | no | Sector: división CNAE de dos cifras, o su slug.. hasta 300 caracteres |
cap_min | texto | no | Capital mínimo, en euros.. hasta 300 caracteres |
formato | texto | no | 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: xlsx, csv. por defecto: xlsx |
idioma | texto | no | Idioma 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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.
/v1/dev/empresas/noticiasNoticias 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
idioma | texto | no | Idioma de los textos que redacta el servidor. Por defecto, español.. uno de: es, en, fr, de, pt, it. por defecto: es |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 10000. por defecto: 1 |
tema | texto | no | Trozo de URL del tema: semana-en-la-provincia, ampliaciones-de-capital, sectores o actualidad.. al menos 1 caracteres; hasta 120 caracteres |
provincia | texto | no | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"pagina": ,
"porPagina": ,
"temas": [
{
"slug": "ana-garcia-lopez",
"plantilla": "semana-provincia",
"n":
}
],
"provincias": [
{
"provincia": "MADRID",
"provinciaLegible": "Madrid",
"provinciaSlug": "madrid",
"n":
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
slug | texto | sí | 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 |
idioma | texto | no | Idioma 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"texto": "texto",
"origen": "origen"
}
],
"autorBio": "autorBio",
"autorCredenciales": "autorCredenciales",
"empresas": [
{
"empresaId": "12345",
"denominacion": "ACME SERVICIOS SL",
"denominacionLegible": "Acme Servicios, S.L.",
"rutaWeb": "rutaWeb"
}
]
}/v1/dev/empresas/informesLos 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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": ,
"extraidoEn": "extraidoEn",
"publicadoEn": "publicadoEn",
"huella": "huella"
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
mes | texto | sí | Mes, AAAA-MM.. patrón ^\d{4}-(0[1-9]|1[0-2])$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"extraidoEn": "extraidoEn",
"publicadoEn": "publicadoEn",
"huella": "huella",
"huellaCoincide": true,
"mesAnterior": "mesAnterior",
"mesAnioAnterior": "mesAnioAnterior",
"ultimoDiaCargado": "2026-10-22",
"coberturas": {
"actual": {
"estado": "completo",
"diasCargados": ,
"diasDelMes":
},
"anterior": {
"estado": "completo",
"diasCargados": ,
"diasDelMes":
},
"anioAnterior": {
"estado": "completo",
"diasCargados": ,
"diasDelMes":
}
},
"nacional": {
"actual": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
},
"anterior": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
},
"anioAnterior": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
}
},
"comunidades": [
{
"comunidad": "comunidad",
"provincias": ,
"valores": {
"actual": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
},
"anterior": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
},
"anioAnterior": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
}
}
}
],
"provincias": [
{
"provincia": "MADRID",
"provinciaLegible": "Madrid",
"provinciaSlug": "madrid",
"codigo": "ABCD-1234",
"comunidad": "comunidad",
"valores": {
"actual": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
},
"anterior": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
},
"anioAnterior": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
}
}
}
],
"provinciasSinComunidad": ,
"descargas": {
"pdf": "pdf",
"csv": "csv",
"imagen": "imagen",
"graficos": [
{
"metrica": "constituciones",
"ruta": "ruta"
}
]
}
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
mes | texto | sí | Mes, AAAA-MM.. patrón ^\d{4}-(0[1-9]|1[0-2])$ |
provincia | texto | sí | Nombre o slug de la provincia.. al menos 1 caracteres; hasta 120 caracteres |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"extraidoEn": "extraidoEn",
"publicadoEn": "publicadoEn",
"huella": "huella",
"huellaCoincide": true,
"mesAnterior": "mesAnterior",
"mesAnioAnterior": "mesAnioAnterior",
"ultimoDiaCargado": "2026-10-22",
"coberturas": {
"actual": {
"estado": "completo",
"diasCargados": ,
"diasDelMes":
},
"anterior": {
"estado": "completo",
"diasCargados": ,
"diasDelMes":
},
"anioAnterior": {
"estado": "completo",
"diasCargados": ,
"diasDelMes":
}
},
"provincia": {
"provincia": "MADRID",
"provinciaLegible": "Madrid",
"provinciaSlug": "madrid",
"codigo": "ABCD-1234",
"comunidad": "comunidad",
"valores": {
"actual": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
},
"anterior": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
},
"anioAnterior": {
"constituciones": ,
"disoluciones": ,
"extinciones": ,
"concursos": ,
"ampliaciones_de_capital": ,
"reducciones_de_capital": ,
"nombramientos_de_administracion": ,
"ceses_de_administracion":
}
}
},
"descargas": {
"csv": "csv"
}
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
huella | texto | sí | Huella SHA-256 del informe.. patrón ^[0-9a-fA-F]{64}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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":
}/v1/dev/citas/verificarVerificar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
texto | texto | sí | 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 |
fecha | fecha (AAAA-MM-DD) | no | Fecha 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. |
ordenJurisdiccional | texto | no | Orden jurisdiccional, para desambiguar siglas que se repiten entre órdenes.. uno de: civil, penal, social, contencioso |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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": ,
"verificadas": ,
"noEncontradas": ,
"verdes": ,
"ambares": ,
"rojas":
},
"citas": [
{
"tipo": "articulo",
"texto": "texto",
"posicion": {
"inicio": ,
"fin":
},
"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"
}
]
}/v1/dev/documentos/extraer-textoExtraer 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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": ,
"paginasConOcr": ,
"fuente": "texto_del_documento",
"texto": "texto",
"caracteres":
}
],
"resumen": {
"ficheros": ,
"paginas": ,
"paginasConOcr": ,
"caracteres":
},
"facturacion": {
"cobradoCentimos": ,
"saldoRestanteCentimos":
}
}/v1/dev/jurisprudencia/materiasLos á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
401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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"
}
]
}
]
}/v1/dev/jurisprudenciaListar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
ambito | texto | no | Dónde: nacional (por defecto), comunidad, provincia o sector.. uno de: penal, civil, familia, contencioso, laboral, constitucional, ue, militar |
materia | texto | no | Código o nombre de la materia (ver /v1/dev/jurisprudencia/materias).. al menos 3 caracteres; hasta 80 caracteres |
organo | texto | no | Ó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 |
desde | fecha (AAAA-MM-DD) | no | Fecha de inicio, AAAA-MM-DD. |
hasta | fecha (AAAA-MM-DD) | no | Fecha final del rango (AAAA-MM-DD), con periodo=rango. |
texto | texto | no | Texto que se busca (o un ECLI).. al menos 2 caracteres; hasta 200 caracteres |
pagina | entero | no | Número de página, desde 1. Alternativa: cursor.. mínimo 1; máximo 500. por defecto: 1 |
tamano | entero | no | Resultados por página (1 a 50).. mínimo 1; máximo 50 |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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": ,
"pagina": ,
"tamano": ,
"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": ,
"citadaPorIgualOSuperior": ,
"siguePrevias":
},
"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"
}
]
}
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del recurso (suscripción de avisos, caso, lista, etiqueta o búsqueda guardada), el que devuelve la API al crearlo. |
fecha | fecha (AAAA-MM-DD) | no | Fecha de calendario, AAAA-MM-DD. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404no_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.429demasiadas_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.500error_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=,
)
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": ,
"citadaPorIgualOSuperior": ,
"siguePrevias":
},
"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
| Cabecera | Qué lleva |
|---|---|
Jurilia-Firma | t=<segundos Unix>,v1=<hex>. Con dos v1 si acabas de rotar el secreto: vale cualquiera. |
Jurilia-Idempotency-Key | El id del aviso (evt_… o res_…). Igual en reintentos y reenvíos. |
Jurilia-Evento | El tipo: empresa.acto_publicado, empresa.alta_en_domicilio, empresa.resumen_diario, norma.cambio_detectado o prueba. |
Jurilia-Entrega | El identificador de esta entrega, el que ves en el registro de entregas. |
Jurilia-Intento | El 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 = ) {
const partes = Object.fromEntries(cabecera.split(',').map((p) => p.trim().split('=')));
const t = Number(partes.t);
if (!Number.isInteger(t) || Math.abs(Date.now() / - 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 = ) -> bool:
partes = dict(p.strip().split("=", ) 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/v1/dev/avisos/filtrosLos 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
401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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"
]
}/v1/dev/avisos/suscripcionesCrear 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
idempotency-key | texto | no | Cadena 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
url | texto | sí | Dirección HTTPS que recibirá los avisos (dominio público, puerto 443).. hasta 500 caracteres |
descripcion | texto | no | Texto libre: una etiqueta para tu referencia (suscripción de avisos) o la descripción de un caso (hasta 2.000 caracteres).. hasta 120 caracteres |
grupos | lista de texto | no | Filtro 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. |
agrupacion | texto | no | inmediato (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
400validacion — 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.400url_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.400destino_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.400filtro_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`.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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": ,
"ultimaEntregaEn": "2026-10-22T08:00:03.000Z",
"creadaEn": "2026-10-22T08:00:00.000Z",
"secretoPista": "xxxx",
"empresasVigiladas":
},
"secreto": "whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"repetida": true
}/v1/dev/avisos/suscripcionesListar 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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": ,
"ultimaEntregaEn": "2026-10-22T08:00:03.000Z",
"creadaEn": "2026-10-22T08:00:00.000Z",
"secretoPista": "xxxx",
"empresasVigiladas":
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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": ,
"ultimaEntregaEn": "2026-10-22T08:00:03.000Z",
"creadaEn": "2026-10-22T08:00:00.000Z",
"secretoPista": "xxxx",
"empresasVigiladas":
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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
}/v1/dev/avisos/suscripciones/{id}/reactivarReactivar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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": ,
"ultimaEntregaEn": "2026-10-22T08:00:03.000Z",
"creadaEn": "2026-10-22T08:00:00.000Z",
"secretoPista": "xxxx",
"empresasVigiladas":
}/v1/dev/avisos/suscripciones/{id}/secretoRotar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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"
}/v1/dev/avisos/suscripciones/{id}/probarMandar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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": ,
"error": "error"
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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":
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
empresaId | texto | sí | Identificador de la empresa, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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
}/v1/dev/avisos/suscripciones/{id}/empresasLas 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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"
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
slug | texto | sí | 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422domicilio_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.429demasiadas_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.500error_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=,
)
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":
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
slug | texto | sí | 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422domicilio_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.429demasiadas_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.500error_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=,
)
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
}/v1/dev/avisos/suscripciones/{id}/domiciliosLos 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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"
}
]
}/v1/dev/avisos/normasLas 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
401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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"
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
norma | texto | sí | 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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":
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
norma | texto | sí | 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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
}/v1/dev/avisos/suscripciones/{id}/normasLas 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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"
}
]
}/v1/dev/avisos/suscripciones/{id}/entregasEl 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
limite | entero | no | Máximo de resultados.. mínimo 1; máximo 200. por defecto: 50 (avisos: entregas) · 100 (eventos) · 20 (búsquedas) |
antes | texto | no | Fecha-hora ISO: sólo lo anterior (paginación).. hasta 40 caracteres |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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": ,
"proximoIntentoEn": "proximoIntentoEn",
"ultimoCodigo": ,
"ultimoError": "ultimoError",
"costeCentimos": ,
"creadaEn": "2026-10-22T08:00:00.000Z",
"entregadaEn": "2026-10-22T08:00:03.000Z",
"idDelAviso": "idDelAviso"
}
],
"siguienteAntes": "siguienteAntes"
}/v1/dev/avisos/suscripciones/{id}/eventosLos 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
desde | fecha (AAAA-MM-DD) | sí | Fecha de inicio, AAAA-MM-DD. |
cursor | texto | no | Cursor opaco de la página siguiente (de siguienteCursor o de la cabecera X-Jurilia-Siguiente-Cursor). Sustituye a pagina.. hasta 100 caracteres |
limite | entero | no | Máximo de resultados.. mínimo 1; máximo 500. por defecto: 50 (avisos: entregas) · 100 (eventos) · 20 (búsquedas) |
Errores y cómo resolverlos
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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": ,
"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"
}/v1/dev/avisos/suscripciones/{id}/reenviarVolver 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la suscripción. |
Cuerpo JSON
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
desde | fecha (AAAA-MM-DD) | sí | Fecha de inicio, AAAA-MM-DD. |
Errores y cómo resolverlos
400validacion — 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.400reenvio_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404suscripcion_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.409limite_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.422empresa_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=`.429demasiadas_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.500error_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=,
)
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":
}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.
/v1/dev/casosListar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
estado | texto | no | Sólo los casos abierto o cerrado. Sin él, todos.. uno de: abierto, cerrado |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404caso_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.429demasiadas_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.500error_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=,
)
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":
}
]
}/v1/dev/casosAbrir 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
idempotency-key | texto | no | Cadena 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
nombre | texto | sí | Nombre del caso (hasta 120 caracteres).. al menos 1 caracteres; hasta 120 caracteres |
descripcion | texto | no | Descripción libre (hasta 2.000 caracteres).. hasta 2000 caracteres |
Errores y cómo resolverlos
400validacion — 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.400idempotency_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.400nombre_de_caso_no_valido — El caso necesita un nombre de hasta 120 caracteres. Manda `nombre` con entre 1 y 120 caracteres.400texto_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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404caso_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.409limite_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.429demasiadas_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.500error_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=,
)
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": ,
"nota": "nota",
"elementos": [
{
"tipo": "empresa",
"referencia": "12345",
"nota": "nota",
"anadidoEn": "anadidoEn",
"disponible": true
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404caso_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.429demasiadas_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.500error_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=,
)
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": ,
"nota": "nota",
"elementos": [
{
"tipo": "empresa",
"referencia": "12345",
"nota": "nota",
"anadidoEn": "anadidoEn",
"disponible": true
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
Cuerpo JSON
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
nombre | texto | no | Nombre nuevo (hasta 120 caracteres).. al menos 1 caracteres; hasta 120 caracteres |
descripcion | texto | no | Descripción nueva (hasta 2.000 caracteres).. hasta 2000 caracteres |
nota | texto | no | Tu nota sobre el caso (hasta 5.000 caracteres). Vacía, la borra.. hasta 5000 caracteres |
Errores y cómo resolverlos
400validacion — 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.400nombre_de_caso_no_valido — El caso necesita un nombre de hasta 120 caracteres. Manda `nombre` con entre 1 y 120 caracteres.400texto_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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404caso_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.409caso_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.429demasiadas_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.500error_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=,
)
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": ,
"nota": "nota",
"elementos": [
{
"tipo": "empresa",
"referencia": "12345",
"nota": "nota",
"anadidoEn": "anadidoEn",
"disponible": true
}
]
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404caso_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.429demasiadas_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.500error_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=,
)
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
}/v1/dev/casos/{id}/cerrarCerrar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404caso_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.429demasiadas_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.500error_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=,
)
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": ,
"nota": "nota",
"elementos": [
{
"tipo": "empresa",
"referencia": "12345",
"nota": "nota",
"anadidoEn": "anadidoEn",
"disponible": true
}
]
}/v1/dev/casos/{id}/reabrirReabrir 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404caso_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.429demasiadas_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.500error_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=,
)
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": ,
"nota": "nota",
"elementos": [
{
"tipo": "empresa",
"referencia": "12345",
"nota": "nota",
"anadidoEn": "anadidoEn",
"disponible": true
}
]
}/v1/dev/casos/{id}/elementosAñ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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
Cuerpo JSON
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
tipo | texto | sí | Qué es el elemento: empresa, persona o domicilio.. uno de: empresa, persona, domicilio |
referencia | texto | sí | 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
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404caso_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.409caso_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.409limite_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.422elemento_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.429demasiadas_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.500error_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=,
)
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":
}/v1/dev/casos/{id}/nodosAñ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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
Cuerpo JSON
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
nodos | lista de texto | sí | Los nodos a añadir (de 1 a 50). |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404caso_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.409caso_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.409limite_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.422elemento_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.429demasiadas_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.500error_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=,
)
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": ,
"yaEstaban": ,
"omitidos": ,
"lleno": true
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
tipo | texto | sí | Qué es el elemento: empresa, persona o domicilio.. uno de: empresa, persona, domicilio |
referencia | texto | sí | 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
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404caso_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.404elemento_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.409caso_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.429demasiadas_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.500error_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=,
)
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
}/v1/dev/casos/{id}/elementos/{tipo}/{referencia}/notaAnotar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
tipo | texto | sí | Qué es el elemento: empresa, persona o domicilio.. uno de: empresa, persona, domicilio |
referencia | texto | sí | 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
nota | texto | sí | Tu nota (hasta 5.000 caracteres). Vacía, la borra.. hasta 5000 caracteres |
Errores y cómo resolverlos
400validacion — 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.400texto_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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404caso_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.404elemento_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.409caso_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.429demasiadas_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.500error_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=,
)
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"
}/v1/dev/casos/{id}/cronologiaLa 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
categoria | texto | no | Sólo hechos de estas categorías, separadas por comas: constitucion, cargos, capital, domicilio, denominacion, situacion, contratos, subvenciones.. hasta 200 caracteres |
desde | fecha (AAAA-MM-DD) | no | Sólo hechos desde esta fecha, AAAA-MM-DD. |
hasta | fecha (AAAA-MM-DD) | no | Sólo hechos hasta esta fecha, AAAA-MM-DD. |
elemento | texto | no | Sólo los hechos de un elemento del caso, como tipo:referencia (por ejemplo empresa:12345).. al menos 3 caracteres; hasta 320 caracteres |
orden | texto | no | reciente (por defecto) o antiguo.. uno de: reciente, antiguo. por defecto: reciente |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor).. hasta 100 caracteres |
limite | entero | no | Hechos 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
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404caso_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.429demasiadas_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.503semaforo_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.500error_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=,
)
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": ,
"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": ,
"coinciden": ,
"elementos": [
{
"tipo": "empresa",
"referencia": "referencia",
"nombre": "ANA GARCIA LOPEZ",
"disponible": true
}
],
"recortados": [
"recortado"
],
"sinLeer": ,
"sinFecha": ,
"siguienteCursor": "siguienteCursor"
}/v1/dev/casos/{id}/redEl 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404caso_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.429demasiadas_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.503semaforo_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.500error_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=,
)
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": ,
"sociedadesAcotadas": true,
"grado": ,
"comun": true,
"rutaWeb": "rutaWeb"
},
"vecinos": [
{
"valor": "valor",
"tipo": "empresa",
"nombre": "ANA GARCIA LOPEZ",
"provincia": "MADRID",
"provinciaLegible": "Madrid",
"extinguida": true,
"sociedades": ,
"sociedadesAcotadas": true,
"grado": ,
"comun": true,
"rutaWeb": "rutaWeb",
"union": {
"tipo": "cargo",
"cargo": "Adm. Unico"
}
}
],
"total":
}
],
"omitidos": ,
"red": {
"nodos": [
"nodo"
],
"aristas": [
[
null
]
],
"recortada": true
}
}/v1/dev/casos/{id}/informeEl 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador del caso. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404caso_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.429demasiadas_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.503semaforo_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.500error_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=,
)
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.
/v1/dev/listasListar 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
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.429demasiadas_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.500error_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=,
)
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":
}
]
}/v1/dev/listasCrear 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
idempotency-key | texto | no | Cadena 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
nombre | texto | sí | Nombre de la lista (hasta 120 caracteres).. al menos 1 caracteres; hasta 120 caracteres |
Errores y cómo resolverlos
400validacion — 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.400idempotency_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.400nombre_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).401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.409limite_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.429demasiadas_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.500error_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=,
)
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":
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la lista. |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor).. hasta 100 caracteres |
limite | entero | no | Elementos 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
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.429demasiadas_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.500error_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=,
)
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": ,
"empresas": [
{
"empresaId": "12345",
"anadidaEn": "anadidaEn"
}
],
"siguienteCursor": "siguienteCursor"
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la lista. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.429demasiadas_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.500error_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=,
)
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
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la lista. |
empresaId | texto | sí | Identificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.409limite_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.422sociedad_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.429demasiadas_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.500error_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=,
)
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":
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la lista. |
empresaId | texto | sí | Identificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.429demasiadas_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.500error_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=,
)
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
}/v1/dev/listas/{id}/empresasPoner 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la lista. |
Cuerpo JSON
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresas | lista de texto | sí | Identificadores de las sociedades (de 1 a 50). |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.409limite_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.422sociedad_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.429demasiadas_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.500error_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=,
)
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": ,
"yaEstaban": ,
"omitidas": ,
"llena": true
}/v1/dev/etiquetasListar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | no | Identificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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":
}
]
}/v1/dev/etiquetasCrear 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
nombre | texto | sí | Nombre de la etiqueta (hasta 60 caracteres).. al menos 1 caracteres; hasta 60 caracteres |
color | texto | sí | Color: rojo, naranja, amarillo, verde, azul, morado o gris.. uno de: rojo, naranja, amarillo, verde, azul, morado, gris |
Errores y cómo resolverlos
400validacion — 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.400nombre_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).400color_de_etiqueta_no_valido — Ese color no está en la paleta. Los colores son rojo, naranja, amarillo, verde, azul, morado y gris.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.409etiqueta_duplicada — Ya existe una etiqueta con ese nombre. Usa la que ya tienes (`GET /v1/dev/etiquetas`) o elige otro nombre.409limite_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.429demasiadas_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.500error_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=,
)
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":
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la etiqueta. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404etiqueta_no_encontrada — No hay esa etiqueta en tu cuenta. Lista tus etiquetas con `GET /v1/dev/etiquetas` y usa el `id` que devuelve.429demasiadas_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.500error_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=,
)
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
}/v1/dev/etiquetas/{id}/empresasLas 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la etiqueta. |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor).. hasta 100 caracteres |
limite | entero | no | Elementos 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
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404etiqueta_no_encontrada — No hay esa etiqueta en tu cuenta. Lista tus etiquetas con `GET /v1/dev/etiquetas` y usa el `id` que devuelve.429demasiadas_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.500error_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=,
)
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"
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la etiqueta. |
empresaId | texto | sí | Identificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404etiqueta_no_encontrada — No hay esa etiqueta en tu cuenta. Lista tus etiquetas con `GET /v1/dev/etiquetas` y usa el `id` que devuelve.409etiqueta_duplicada — Ya existe una etiqueta con ese nombre. Usa la que ya tienes (`GET /v1/dev/etiquetas`) o elige otro nombre.409limite_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.422sociedad_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.429demasiadas_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.500error_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=,
)
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
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la etiqueta. |
empresaId | texto | sí | Identificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404etiqueta_no_encontrada — No hay esa etiqueta en tu cuenta. Lista tus etiquetas con `GET /v1/dev/etiquetas` y usa el `id` que devuelve.429demasiadas_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.500error_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=,
)
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
}/v1/dev/notasListar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor).. hasta 100 caracteres |
limite | entero | no | Elementos 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
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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"
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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"
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Cuerpo JSON
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
nota | texto | sí | Tu nota (hasta 5.000 caracteres). Vacía, la borra.. hasta 5000 caracteres |
Errores y cómo resolverlos
400validacion — 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.400nota_demasiado_larga — La nota pasa de 5.000 caracteres. Acorta la nota a 5.000 caracteres como mucho.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.409limite_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.422sociedad_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.429demasiadas_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.500error_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=,
)
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"
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
empresaId | texto | sí | Identificador de la sociedad, el que devuelve la búsqueda.. patrón ^\d{1,18}$ |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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
}/v1/dev/carteraLa 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
lista | texto | no | Sólo las sociedades de esta lista. |
suscripcion | texto | no | Sólo las que vigila esta suscripción de avisos. |
estado | texto | no | Sólo las que están en este color.. uno de: rojo, ambar, verde |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.429demasiadas_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.500error_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=,
)
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": ,
"fecha": "2026-10-22"
}
}
],
"listas": [
"lista"
],
"vigilada": true,
"etiquetas": [
{
"id": "12345",
"nombre": "ANA GARCIA LOPEZ",
"color": "rojo"
}
]
}
],
"total": ,
"recortada": true
}/v1/dev/radarEl 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
desde | fecha (AAAA-MM-DD) | no | Sólo novedades publicadas desde esta fecha, AAAA-MM-DD. |
cursor | texto | no | Cursor de la página siguiente (lo da siguienteCursor).. hasta 100 caracteres |
limite | entero | no | Elementos 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
400validacion — 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.400cursor_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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": ,
"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.
/v1/dev/busquedas-guardadasListar 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
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.429demasiadas_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.500error_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=,
)
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":
}
]
}/v1/dev/busquedas-guardadasGuardar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
idempotency-key | texto | no | Cadena 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
nombre | texto | sí | Nombre de la búsqueda (hasta 120 caracteres).. al menos 1 caracteres; hasta 120 caracteres |
parametros | texto | sí | 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
400validacion — 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.400idempotency_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.400nombre_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).400sin_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`).400busqueda_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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.409limite_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}`).429demasiadas_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.500error_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=,
)
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":
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la búsqueda guardada. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404busqueda_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.429demasiadas_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.500error_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=,
)
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":
}/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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la búsqueda guardada. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.403clave_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.403identidad_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.404busqueda_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.429demasiadas_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.500error_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=,
)
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
}/v1/dev/busquedas-guardadas/{id}/comprobarVolver 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la búsqueda guardada. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404busqueda_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.429demasiadas_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.503semaforo_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.500error_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=,
)
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": ,
"totalSalen": ,
"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": ,
"importeCentimos": ,
"texto": "texto",
"periodo": {
"desde": ,
"hasta":
},
"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": ,
"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"
}
}
]
}/v1/dev/busquedas-guardadas/{id}/cambiosLo 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
id | texto | sí | Identificador de la búsqueda guardada. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404busqueda_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.429demasiadas_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.500error_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=,
)
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": ,
"totalSalen": ,
"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": ,
"importeCentimos": ,
"texto": "texto",
"periodo": {
"desde": ,
"hasta":
},
"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": ,
"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.
/v1/dev/exportaciones/empresasExportar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
origen | texto | sí | De dónde salen las sociedades: lista, caso, vigiladas o busqueda.. uno de: lista, vigiladas, caso, busqueda |
id | texto | no | El 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
400validacion — 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.400busqueda_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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.404lista_no_encontrada — No hay esa lista en tu cuenta. Lista tus listas con `GET /v1/dev/listas` y usa el `id` que devuelve.404caso_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.404busqueda_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.429demasiadas_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.500error_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=,
)
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.
/v1/dev/exportaciones/redExportar 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
| Campo | Tipo | Obligatorio | Valores, límites y por defecto |
|---|---|---|---|
formato | texto | sí | 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 |
nodos | lista de texto | sí | 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. |
aristas | lista de lista de valor | sí | Aristas: pares de posiciones en nodos (origen, destino), hasta 1.500. |
Errores y cómo resolverlos
400validacion — 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.401no_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.401clave_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.401clave_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.402saldo_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.403clave_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.403identidad_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.429demasiadas_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.503semaforo_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.500error_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":[[,]]},
timeout=,
)
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":[[,]]}),
});
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"
}
]
}