# Nivel gratuito (DAT-FREE)

La versión del API que responde preguntas sobre la data sin entregar la data: por entidad, si existe, si está vigente, un puñado de booleanos, conteos en rangos y el score. Nunca un nombre de tercero, un monto, una fecha, un documento.

En despliegue. Este es el contrato del nivel gratuito; el gateway lo activa por partes. Hoy los requests sin llave (nivel 0) todavía exigen una llave, por API y por MCP; una llave con saldo cero sigue respondiendo `CHK-BIN` y `DAT-CORE` con el límite diario vigente; los 403 y 429 del gateway traen un `upgrade_url` con el paso siguiente. Esta página cambia a medida que cada parte entra.

## Para qué sirve

Con una llave gratuita obtienes el **id de Panadata** de una entidad y sabes qué hay detrás; los registros cuestan tokens. Alcanza para validar una regla de compuerta sobre un RUC o una cédula, pre-chequear un proveedor, priorizar una lista de 300 filas por señales o probar el JSON mientras construyes. No alcanza, a propósito, para operar una cartera.

Cuatro reglas: **respuestas, no registros** (todo campo es un booleano, un rango, un año o un score); **cada campo apunta a un SKU pagado** (DAT-FREE es el menú, el precio está en [Precios](/docs/precios)); **mismo meter, mismo id** en todos los niveles; y **lo que hace el MCP lo hace el API** , con el mismo nivel de acceso y la misma respuesta.

## Los cuatro niveles

| Nivel | Quién | Qué devuelve | Límite |
| --- | --- | --- | --- |
| 0. Sin llave | cualquiera: cualquier sesión de Claude, Cursor o ChatGPT vía el MCP público; cualquier request HTTP a `platform.panadata.net` sin cabecera | `resolve` con ids enmascarados, existe, nombre, tipo, año, **score** y el **menú** (`codigos_con_datos`) | ~20 entidades/día por sesión o IP; **presupuesto global de 1,000 consultas/día** para todo el nivel |
| 1. Llave gratuita | email + teléfono verificados | la ficha DAT-FREE completa: booleanos y rangos | 500/mes (1,000 con dominio corporativo), 30/día, 1 rps, lote 10 |
| 2. Sandbox US$95 | quien paga | registros completos, 95 tokens, llave permanente | 1 rps |
| 3. Packs | Piloto / Barrido / Programa | registros a volumen, lote 100, estimador | por pack |

El nivel 0 da el menú y el score pero no los booleanos: un agente sin llave aprende «Panadata tiene datos judiciales, inmobiliarios y de comercio sobre esta sociedad y la puntúa 71». Los booleanos detrás cuestan un email y un teléfono. Los registros cuestan tokens.

## La ficha DAT-FREE

`GET /v5/entities/{id}?include=DAT-FREE` cuesta 0 tokens. Ejemplo para una organización, con llave gratuita:

```
{
  "id": "pa_own_4629361",
  "nivel": "DAT-FREE",
  "existe": true, "vigente": true, "suspendida": false,
  "tipo": "organizacion", "anio_constitucion": 1998,
  "directores": "3-9",
  "tiene_judicial": true, "moroso_css": false, "contrata_con_estado": true,
  "en_planilla_estatal": false, "pep_local": false,
  "inmuebles": "10+", "comercio_exterior": true, "noticias": true,
  "score": 71,
  "codigos_con_datos": ["DAT-CORE","DAT-REGISTRY","DAT-BUSINESS","DAT-RISK-JUDICIAL","DAT-ESTADO","DAT-REALESTATE","DAT-REALESTATE-INTEL","DAT-TRADE-INTEL","DAT-NETWORK","DAT-DOC"],
  "actualizado": "2026-09",
  "siguiente_paso": {"para_ver_los_registros": "https://platform.panadata.net/docs/precios", "tokens_dat_core": 0.66}
}
```

Sin llave (nivel 0) la ficha se reduce a `existe`, `vigente`, `suspendida`, `tipo`, `anio_constitucion`, `score`, `codigos_con_datos`, `actualizado` y `siguiente_paso`; los booleanos y rangos aparecen con llave gratuita. Para una persona natural la ficha es la misma menos `directores`, `contrata_con_estado` y `comercio_exterior`, y con `en_planilla_estatal`, `pep_local` e `inmuebles` como campos principales.

| Campo | Forma | SKU pagado detrás |
| --- | --- | --- |
| existe, vigente, suspendida | booleanos | DAT-CORE |
| tipo | persona / organizacion / fundacion … | DAT-CORE |
| anio\_constitucion | año (solo el año) | DAT-CORE |
| directores | rango 0 / 1-2 / 3-9 / 10+ | DAT-CORE (nombres y cargos) |
| tiene\_judicial | booleano | DAT-RISK-JUDICIAL |
| moroso\_css | booleano | DAT-RISK-CSS |
| contrata\_con\_estado | booleano | DAT-ESTADO |
| en\_planilla\_estatal | booleano | DAT-PAYROLL |
| pep\_local | booleano | DAT-PEP-LOCAL |
| inmuebles | rango 0 / 1-2 / 3-9 / 10+ | DAT-REALESTATE |
| comercio\_exterior | booleano | DAT-BIZ-TRADE / DAT-TRADE-INTEL |
| noticias | booleano | DAT-RISK-NEWS |
| score | número 0–100, sin desglose | DAT-SCORE (con desglose) |
| codigos\_con\_datos | lista de códigos DAT que devolverían datos | cada uno |
| actualizado | mes/año del índice | UPD-LIVE (dato en vivo) |

Los tokens de cada SKU están en [Precios](/docs/precios) y en vivo en `GET /v5/catalog`.

## Límites

| Límite | Valor | Por qué |
| --- | --- | --- |
| Nivel 0, por sesión MCP o por IP | ~20 entidades/día, 1 request cada 2 s, una entidad por llamada | suficiente para que un agente responda una pregunta; insuficiente para una lista |
| Nivel 0, global | 1,000 consultas/día para todo el nivel; 429 con enlace a la llave gratuita al agotarse | el techo lo elegimos nosotros; conservador hasta ver tráfico real |
| Entidades por mes (nivel 1) | 500 por cuenta verificada (resolve + fichas DAT-FREE cuentan juntos; dry\_run no cuenta) | una muestra de 300 filas o 10 al día en micro-producción caben; una cartera no |
| Con dominio corporativo verificado | 1,000 | premia al comprador probable sin regalar volumen |
| Por día | 30 | que los 500 no se gasten en una tarde sobre una lista |
| Tasa | 1 request/segundo | una muestra de 300 tarda cinco minutos; molesto, pero gratis |
| Lote (resolve/batch) | 10 filas | el batch grande es para packs |
| Vigencia de la llave | 90 días sin compra; cualquier compra (Sandbox US$95 en adelante) la vuelve permanente | evita llaves zombis y cuentas fábrica |
| Verificación | email + teléfono; una cuenta gratuita por teléfono | frena el sharding de cuentas |
| Estimador (resolve/batch con with\_presence, agregados) | 5,000 filas/mes gratis; más, por Ventas | no devuelve dato por entidad; es la herramienta de conversión |

Cuando se agota: `429` con `code: free_tier_limit` y `upgrade_url`; cuando se pide un código fuera del nivel: `403` con `locked_codes` y `free_tier_codes`. El MCP lee esos campos y muestra el paso siguiente en vez de un error.

## Sin llave: el mismo request por API y por MCP

Las dos operaciones del nivel 0 responden **sin cabecera de autenticación**. Cada tool del MCP tiene su ruta HTTP y devuelve lo mismo; si un día una tool solo existe en el MCP, es un bug. Para conectar un agente sin llave:

```
claude mcp add --transport http panadata https://mcp.panadata.net/mcp
```

### 1. Resolver una entidad

API — `POST /v5/resolve`

```
curl -X POST 'https://api.panadata.net/v5/resolve' \
  --header 'Content-Type: application/json' \
  --data '{"name": "Cerveceria Nacional"}'
```

MCP — tool `resolve_entity`

```
resolve_entity({"name": "Cerveceria Nacional"})
```

Candidatos con nombre, tipo, identificador **enmascarado** (`8- ***-2264`, `155*** -2-2016`), `confidence`, `matched_on` y `exact_homonyms`; una fila por llamada. Con llave gratuita, además `resolve/batch` hasta 10 filas; con tokens, el identificador completo y lote de 100.

### 2. Leer la ficha DAT-FREE

API — `GET /v5/entities/{id}`

```
curl 'https://api.panadata.net/v5/entities/pa_own_4629361?include=DAT-FREE'
```

MCP — tool `get_entity`

```
get_entity({"id": "pa_own_4629361", "include": ["DAT-FREE"]})
```

Sin llave: existe, vigente, suspendida, tipo, año, score, menú, actualizado y `siguiente_paso`. Con llave gratuita (`Authorization: Bearer pk_…`): la ficha completa de arriba. Con tokens: los códigos que el menú anuncia.

## Qué no devuelve, aunque nos cueste poco

- **Nombres de terceros.** Ni directores, ni dueños, ni acreedores, ni contrapartes. Solo el nombre de la entidad resuelta.
- **Montos.** Ni valores de propiedades, ni salarios, ni valores de contratos.
- **Fechas** más allá del año de constitución y del mes de actualización.
- **Conteos exactos.** «Tiene 4 propiedades» es un hecho sobre una persona; «tiene 3–9» es una señal.
- **Identificadores completos** en `resolve`.
- **Búsquedas.** Ningún endpoint que devuelva una lista de entidades a partir de criterios. Siguen pagados.
- **Listas internacionales (DAT-SCREEN)**, documentos, dockets, OCR, dato en vivo, red de control, historial.

Cuando necesites los registros

La ficha dice qué hay; leerlo cuesta tokens. El Sandbox de US$95 da el JSON completo y una llave permanente; los packs, volumen y lote de 100. [Ver precios](/docs/precios).