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. La superficie v4 (estable, multi-país) se muestra abajo; la
superficie v5 (nativa para agentes, Panamá — el mismo modelo de datos que
expone el MCP) publica su contrato OpenAPI en
api.panadata.net/v5/openapi.yml.
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/v4/panama/entidades?nombre=panadata' \ --header 'Authorization: Bearer pk_su_llave'
La respuesta incluye una lista de coincidencias. Cada resultado tiene un
id
que usará en GET /v4/panama/entidades/{id}.
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/v4/panama/entidades/12345?include=DAT-CORE' \ --header 'Authorization: Bearer pk_su_llave'
Puede solicitar múltiples códigos separados por coma:
curl 'https://api.panadata.net/v4/panama/entidades/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
Niveles de datos,
y previsualice el costo de cualquier combinación con dry_run.
¿Y Ecuador?
Cambie panama por
ecuador en la ruta
para consultar organizaciones ecuatorianas. 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 →