# Tu primera consulta

Siga estos 3 pasos para buscar y enriquecer una entidad por primera vez.

## 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](/docs/conceptos/codigos-de-producto).

Anterior: [← Autenticación](/docs/guias/autenticacion)

Siguiente: [Parámetro include →](/docs/guias/include-parameter)