Documentación Ver secciones Cerrar
Tu primera consulta
Siga estos 3 pasos para buscar y enriquecer una entidad por primera vez.
Dos formas de construir
API REST — para aplicaciones deterministas (consultas fijas, procesos
batch, dashboards, backends): contrato estable, baja latencia y su propia llave. Esta guía
usa REST sobre la superficie v5 (nativa para agentes, Panamá — el mismo
modelo de datos que expone el MCP), cuyo contrato OpenAPI se publica en
api.panadata.net/v5/openapi.yml.
Ecuador sigue en el contrato v4 congelado; lo cubre la última sección.
MCP — para agentes / LLMs en tiempo de ejecución (copilotos, «pregúntale a los datos») o para prototipar: conectar el MCP.
Paso 1: Buscar por nombre o RUC
Use el endpoint de búsqueda para encontrar entidades por nombre o número de RUC:
curl 'https://api.panadata.net/v5/entities?q=panadata' \ --header 'Authorization: Bearer pk_su_llave'
La respuesta incluye una lista de coincidencias. Cada resultado trae un
id público tipado
(pa_own_12345) que se pega
tal cual en GET /v5/entities/{id}.
El id lleva la jurisdicción adentro: no hace falta repetir el país en la ruta, y no se
arma a mano.
Paso 2: Identificar la entidad correcta
Revise los resultados y tome nota del
id
de la entidad que le interesa. Puede confirmar por nombre, RUC o tipo de entidad.
Paso 3: Enriquecer con módulos
Use el endpoint de detalle con el parámetro
include
para obtener la información que necesita:
curl 'https://api.panadata.net/v5/entities/pa_own_12345?include=DAT-CORE' \ --header 'Authorization: Bearer pk_su_llave'
Puede solicitar múltiples códigos separados por coma:
curl 'https://api.panadata.net/v5/entities/pa_own_12345?include=DAT-CORE,DAT-GOV,DAT-RISK' \ --header 'Authorization: Bearer pk_su_llave'
Consejo:
Empiece con DAT-CORE para
ver los datos básicos. Luego agregue módulos adicionales según lo que necesite.
Consulte qué información existe en
Cobertura de datos,
y previsualice el costo de cualquier combinación con dry_run.
¿Y Ecuador?
Ecuador todavía se consulta por el contrato v4 congelado, con sus propias rutas por
jurisdicción (no por id tipado). La búsqueda acepta nombre o RUC y el detalle acepta tres códigos:
CHK-BIN,
DAT-CORE y
DAT-ALL.
curl 'https://api.panadata.net/v4/ecuador/entidades?ruc=1768040920001' \ --header 'Authorization: Bearer pk_su_llave'
curl 'https://api.panadata.net/v4/ecuador/entidades/52015398?include=DAT-ALL' \ --header 'Authorization: Bearer pk_su_llave'
Ecuador está limitado a organizaciones jurídicas. Los detalles del catálogo están en Jurisdicciones.
Anterior: ← Autenticación
Siguiente: Parámetro include →