# Panadata API

> REST API for accessing Panama public registry data — organizations and natural persons. Search by name or RUC, retrieve detailed records including corporate governance, assets, trade, legal documents, risk/compliance, and more.

Base URL: `https://api.panadata.net`
Platform: `https://platform.panadata.net`

## Getting started

1. Sign up at https://platform.panadata.net/users/sign_up and confirm your email
2. Create an API key in the dashboard — you'll get a `pk_*` Bearer token
3. Search for an entity, then fetch details with product codes

Free tier: confirmed accounts can query immediately without preloading balance (aggressive rate limits).

## Authentication

All API requests require a Bearer token:

```
Authorization: Bearer pk_XXXXXXXXXXXX
```

## Endpoints

### Health check
`GET /health` — No auth required. Returns `{"status":"ok","service":"panadata-api"}`.

### Search entities
`GET /v4/panama/entidades?nombre={name}` — Search by name (min 3 chars).
`GET /v4/panama/entidades?ruc={ruc}` — Search by RUC number.

Returns an array of matching entities with `id`, `nombre`, `ruc`/`cedula`, and `tipo`.

### Get entity detail
`GET /v4/panama/entidades/{id}?include={codes}` — Fetch detailed data for an entity.

The `include` parameter is required and accepts comma-separated product codes.

## Product codes and pricing

Every request has a **$0.01 base charge**. Product code costs are added on top.

| Code | Cost | What it returns |
|------|------|-----------------|
| CHK-BIN | $0.02 | Binary existence check — id, nombre, ruc/cedula |
| DAT-CORE | $0.15 | Core registry data, contact info, entity events |
| DAT-HOOK | $0.03 | Entity events (webhooks) |
| DAT-GOV | $0.15 | Directors, board members, legal representatives, government gazette |
| DAT-BIZ | $0.08 | Business licenses, trademarks, trusts |
| DAT-ASSET | $0.25 | Real estate, vehicles, vessels |
| DAT-TRADE | $0.20 | Import/export records and summaries |
| DAT-DOC | $0.06 | Scanned and digital documents |
| DAT-RISK | $0.20 | Delinquent debts, sanctions, court cases |
| DAT-PROC | $0.05 | Public procurement/tenders |
| DAT-NEWS | $0.12 | News mentions (local and global) |
| DAT-LEGAL | $0.10 | Migration and work permits |
| DAT-ALL | $1.35 | All available data levels |

Smart resolution: overlapping codes are deduplicated — you only pay for non-redundant data.

## Example workflow

```bash
# 1. Search by name
curl -H "Authorization: Bearer pk_XXX" \
  "https://api.panadata.net/v4/panama/entidades?nombre=copa+airlines"

# 2. Get details with product codes
curl -H "Authorization: Bearer pk_XXX" \
  "https://api.panadata.net/v4/panama/entidades/12345?include=DAT-CORE,DAT-GOV"
```

## Coverage

Currently active: **Panama** — 28 data sources, 34 data levels, 12 product codes.
Upcoming: Ecuador, Colombia.

## Documentation

- [Getting started](https://platform.panadata.net/docs/empezar)
- [Authentication guide](https://platform.panadata.net/docs/guias/autenticacion)
- [First query guide](https://platform.panadata.net/docs/guias/primera-consulta)
- [Include parameter guide](https://platform.panadata.net/docs/guias/include-parameter)
- [Sandbox vs API](https://platform.panadata.net/docs/guias/sandbox-vs-api)
- [Error handling](https://platform.panadata.net/docs/guias/errores)
- [API reference (OpenAPI)](https://platform.panadata.net/docs/referencia)
- [Jurisdictions](https://platform.panadata.net/docs/conceptos/jurisdicciones)
- [Data sources](https://platform.panadata.net/docs/conceptos/fuentes-de-datos)
- [Data levels](https://platform.panadata.net/docs/conceptos/niveles-de-datos)
- [Product codes](https://platform.panadata.net/docs/conceptos/codigos-de-producto)
- [Billing](https://platform.panadata.net/docs/conceptos/facturacion)

## Machine-readable specs

- [OpenAPI 3.0 (Spanish)](https://platform.panadata.net/openapi.yml)
- [OpenAPI 3.0 (English)](https://platform.panadata.net/openapi.en.yml)
- [AI plugin manifest](https://platform.panadata.net/.well-known/ai-plugin.json)
- [Full docs as a single markdown file](https://platform.panadata.net/llms-full.txt)

Every docs page is also available as markdown by appending `.md` to its URL — e.g. `https://platform.panadata.net/docs/conceptos/codigos-de-producto.md`.