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 la lista completa en
Códigos de producto.
¿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 →