La API de ENTIA,
con el contrato que de verdad se sirve.

01Primera llamada

Una respuesta real, sin registrarse, y cómo leerla.

Una llamada que funciona sin registrarse, para comprobar la conexión y ver la forma de la respuesta:

curl -s 'https://api.entia.systems/api/v1/demo/lookup?q=A28015865'

{
  "found": true,
  "query": "A28015865",
  "entity": {
    "name": "TELEFONICA SA",
    "legal_id": "A28015865",
    "country_code": "ES",
    "sector": "tecnologia",
    "city": "MADRID"
  },
  "access_level": "trace_preview",
  "gated_fields": [
    "trust_score",
    "borme",
    "gleif",
    "signature",
    "full_dossier",
    "source_chain",
    "contact_depth",
    "economic_profile"
  ],
  "upgrade_url": "https://entia.systems/mcp-setup",
  "upgrade_teaser": {
    "field": "trust_score",
    "masked_value": "••• · SIGNAL",
    "unlocked_by_tier": "signal",
    "why": "Registry-corroborated trust composite (BORME / VIES / GLEIF)"
  },
  "checkout": {
    "tier": "signal",
    "price_eur_month": 29,
    "url": "https://api.entia.systems/api/v1/mcp/checkout?tier=signal",
    "method": "GET"
  },
  "source_signal": {
    "source": "VIES",
    "status": "valid",
    "claim": "EU VAT registered (European Commission VIES)"
  },
  "_meta": {
    "redacted_for_trace": true,
    "revenue_guard": "entity_lookup_full_data_requires_paid_tier"
  }
}

Con credencial

curl -s 'https://api.entia.systems/api/v1/v3/entity_lookup?query=A28015865' \
  -H "x-entia-key: $ENTIA_KEY"

02Las tres claves

Tres credenciales distintas viajan en la misma cabecera. No son intercambiables.

ENTIA emite tres tipos de credencial distintos que viajan en la misma cabecera, x-entia-key. Cubren superficies que no se solapan y una no sirve para la otra. Confundirlas es el error de integración más caro, porque el síntoma siempre es el mismo 401.

Cómo conseguir una clave

# 1 · Gratuita, nivel TRACE, sin tarjeta
curl -s -X POST https://api.entia.systems/api/v1/mcp/register \
  -H 'Content-Type: application/json' \
  -d '{"email":"tu@empresa.com"}'

# 2 · Plan de pago: 303 a Stripe Checkout
curl -sI 'https://api.entia.systems/api/v1/mcp/checkout?tier=signal'

# 3 · Comprobar qué plan tiene una clave
curl -s https://api.entia.systems/api/v1/mcp/key/validate -H "x-entia-key: $ENTIA_KEY"

Tras el pago, la clave se revela en /mcp-dashboard. Los planes SCALE y ENTERPRISE no tienen checkout público: se contratan por /api/v1/mcp/enterprise/contact o en fv@entia.systems.

Formas de mandarla

03Endpoints

Qué hay, quién puede llamarlo y qué descuenta.

Estado y descubrimiento

Consulta sin credencial

Datos verificados · /api/v1/v3/*

Esta familia es la misma capacidad que sirve el MCP, con envoltorio HTTP en vez de JSON-RPC. Los parámetros, la semántica de cada campo, las trampas de cada respuesta y los ejemplos medidos están documentados una sola vez, en la referencia de herramientas MCP, para que las dos superficies no puedan contradecirse.

Identidad · /v1/*

curl -s https://api.entia.systems/v1/verify/vat/IE6388047V -H "x-entia-key: $ENTIA_KEY"

Devuelve valid, vat_id, country_code, name, address, source y _meta. Nombre y dirección dependen del país: Irlanda los divulga, España no —la administración española no publica esos campos por VIES—. Para el nombre legal español usa /api/v1/v3/entity_lookup, que lo resuelve contra el registro mercantil.

Planes y ciclo de la clave

Licencia, política y procedencia

El corpus publicado · /v1/identity/…

Cada entidad del corpus tiene una dirección estable con dos caras. Es superficie abierta: no lleva credencial, y está pensada para que la lean crawlers y agentes.

/v1/identity/{pais}/{sector}/{ciudad}/{slug}          # ficha para personas
/v1/identity/{pais}/{sector}/{ciudad}/{slug}.jsonld   # gemelo para maquinas

curl -s https://entia.systems/v1/identity/es/dental/madrid/albus-dental-studio-dentista-en-mirasierra.jsonld

Devuelve 200 con content-type: application/ld+json y un @graph de Schema.org con cuatro nodos: la Organization de la entidad, la WebPage que la publica, el BreadcrumbList de su ruta y la Organization de ENTIA como editor. Los @id son estables y citables.

Cobertura

Diez países, 11.330.391 entidades y 40.345.410 actos del registro mercantil español indexados. Medición del 2026-08-27; el número vivo sale siempre de /api/v1/stats/live, no de esta página.

A nivel europeo se cruzan además VIES, de la Comisión Europea, y el identificador LEI de GLEIF.

Profile Store · prepago

GET /api/v1/profile-store/{cc}/{sector}/{city}/{slug}/{profile}

Perfiles derivados de una ficha publicada, cobrados por petición contra saldo en euros, no contra la cuota de un plan. Usa una lista de claves propia: una credencial de suscripción MCP no vale aquí. Si el perfil pedido no está en el catálogo, devuelve 400 con la lista de los permitidos; si no hay saldo, 402.

04Errores

Cuerpos medidos, no transcritos de un diseño.

Los cuerpos de esta tabla están medidos, no transcritos de un diseño.

05Límites y caché

Cuánto puedes pedir, y qué señales NO vas a recibir.

Lo que NO vas a recibir

Cabeceras que sí devuelve

Caché

Las consultas de datos se sirven desde caché cuando pueden. La respuesta lo declara —en _meta.cache_status o en x-entia-cache— y, en los agregados, con _cached_at y _cache_ttl. Un latency_ms alto junto a un acierto de caché es la latencia del cálculo original, no la de tu llamada: mide en tu cliente si necesitas latencia de servicio.

06Versionado

Qué rompe, qué no, y dos cosas que no existen aunque se documentaran.

No se sirve especificación OpenAPI

https://api.entia.systems/openapi.json y https://api.entia.systems/docs devuelven 404, y es deliberado: la especificación que genera el framework describe también la superficie interna —panel de control, cron, administración de facturación—, y publicarla sería publicar un mapa de lo que no es de nadie. La decisión se tomó el 30 de junio de 2026.

Mientras no exista una especificación curada que contenga solo lo público, el contrato legible por máquina es el del MCP: tools/list en https://mcp.entia.systems/mcp devuelve el esquema de entrada y de salida de cada capacidad, y es la misma capacidad que sirve /api/v1/v3/*.

No hay webhooks salientes

Qué se considera un cambio que rompe

El prefijo de versión (/v1/, /api/v1/v3/) cambia solo ante una ruptura de contrato. Una retirada se anuncia con su alternativa antes de ejecutarse.

07Procedencia y límites

De dónde sale cada dato y qué es exactamente lo que ENTIA no afirma.

De dónde sale el dato

Registros públicos oficiales: boletín mercantil y agencia tributaria en España, Companies House en Reino Unido, SIRENE en Francia, registro empresarial estonio, Brønnøysund en Noruega, y a nivel europeo el sistema VIES de la Comisión y el identificador LEI. Las respuestas nombran su fuente.

Un dato que no se puede acreditar no se sirve

Cuando un valor no es defendible, el contrato devuelve null y lo declara, en vez de entregar un número presentable. /api/v1/stats/live devuelve null en homes_published y en jsonld_generated, y los lista en _unverified. En los perfiles territoriales, un valor fuera de rango llega con value: null, comparable: false, un warning que nombra el motivo y el valor crudo que lo provocó.

Lo que ENTIA no afirma

Datos personales

La API trata personas jurídicas. La única excepción es /api/v1/v3/professional_lookup, que verifica colegiación de personas físicas: exige tier Enterprise y acuerdo de encargo de tratamiento firmado, y su respuesta va minimizada por diseño —se eliminan nombre y apellidos antes de responder—.

Responsable

PrecisionAI Marketing OÜ, Sepapaja tn 4, 11415 Tallin, Estonia. Código de registro mercantil 17048063. Infraestructura en la Unión Europea. Condiciones en /legal/en/api-terms.

Contratos verificados contra api_gateway.py, core/mcp/tools_rest_api.py, core/rest_api.py y core/mcp/plans.py. Respuestas y cuerpos de error medidos contra producción el 2026-08-27.
Las herramientas de datos comparten contrato con el MCP y se documentan una sola vez, en /mcp-docs, para que las dos superficies no puedan contradecirse.