# General

> Las operaciones de General de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código.

Fuente: https://platform.trevol.si/docs/api/general

Salud, la empresa de la llave y la consulta de adquirientes.

Los ejemplos son peticiones con cURL. La llave va en `TREVOL_API_KEY`; los cuerpos de ejemplo son los de la especificación. Los errores comunes están en [Errores](/docs/errores).

## Salud

`GET /v1/health` · `getHealth`

**Respuestas**

| Estado | Qué pasó |
| --- | --- |
| 200 | ok |

`GET /v1/health` (`getHealth`)

#### cURL

```bash
curl "https://api.trevol.si/v1/health" \
  -H "Authorization: Bearer $TREVOL_API_KEY"
```

## La empresa de la llave

`GET /v1/company` · `retrieveCompany`

La empresa de la llave: NIT, razón social, ambiente y numeraciones activas. Desde la fase 3 trae `capabilities`, un resumen de lo que ESTA llave puede emitir ahora: documento soporte (con su numeración), documento equivalente (con los prefijos POS), nómina (`status`: `enabled`, `testing`, `not_registered` o `not_enabled`, según el ambiente de la llave) y eventos RADIAN (representante legal). Es informativo: si una lectura falla, esa clave no aparece.

**Respuestas**

| Estado | Qué pasó |
| --- | --- |
| 200 | La empresa, su ambiente y sus numeraciones activas ([Company](/docs/api/objetos#Company)) |
| Error | Error (application/problem+json) ([Problem](/docs/api/objetos#Problem)) |

`GET /v1/company` (`retrieveCompany`)

#### cURL

```bash
curl "https://api.trevol.si/v1/company" \
  -H "Authorization: Bearer $TREVOL_API_KEY"
```

[Probar en el Playground](https://platform.trevol.si/playground?op=retrieveCompany)

## Datos del adquiriente en la DIAN

`GET /v1/dian/acquirer` · `retrieveDianAcquirer`

**Parámetros**

| Nombre | En | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- | --- |
| `document_type` | consulta | texto | sí |  |
| `document_number` | consulta | texto | sí |  |

**Respuestas**

| Estado | Qué pasó |
| --- | --- |
| 200 | {found, name, email} ([Acquirer](/docs/api/objetos#Acquirer)) |
| Error | Error (application/problem+json) ([Problem](/docs/api/objetos#Problem)) |

`GET /v1/dian/acquirer` (`retrieveDianAcquirer`)

#### cURL

```bash
curl "https://api.trevol.si/v1/dian/acquirer?document_type=31&document_number=900373591" \
  -H "Authorization: Bearer $TREVOL_API_KEY"
```

[Probar en el Playground](https://platform.trevol.si/playground?op=retrieveDianAcquirer)