# List

Para consultar el listado de documentos podemos generar la siguiente solicitud con el archivo `payload.json`:

```
curl "https://agents.boolfy.com/api/documents/list" \ 
    -H "Authorization: Bearer BOOLFY_BEARER_KEY" \
    -H "Content-Type: application/json" \
    -d @payload.json
```

El archivo `payload.json` debe tener el siguiente formato:

```json
{
    "Agent": "Facturas",
    "FromDate": "2024/01/01",
    "ToDate": "2024/01/31",
    "State": "Finished",
    "DocumentState": "Approved",
    "FileFormat": "JSON"
}
```

Detallamos en forma completa los campos de la solicitud:

<table><thead><tr><th width="221">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td>Agent</td><td>Obligatorio. Especifica el nombre del agente IA de Boolfy para el documento. </td></tr><tr><td>FromDate</td><td>Obligatorio. Especifica la fecha desde del listado en formato: yyyy\mm\dd.</td></tr><tr><td>ToDate</td><td>Obligatorio. Especifica la fecha hasta del listado en formato: yyyy\mm\dd.</td></tr><tr><td>State</td><td>Opcional. Es el estado del <a href="../../descripcion-general-de-las-apis#estados-del-proceso">Proceso del documento</a>. Si no se especifica se asume Finished. Para consultar documentos enviados, especificar Sended. </td></tr><tr><td>DocumentState</td><td>Opcional. Es el <a href="../../descripcion-general-de-las-apis#estados-de-revision">Estado de revisión</a>. Si no se especifica, este dato no filtra los documentos a obtener.</td></tr><tr><td>FileFormat</td><td>Opcional. Es el formato del campo response en la respuesta. Sus valores posibles son: JSON, CSV o XML. Si no se especifica, se asume: JSON.</td></tr></tbody></table>

### Respuesta

La respuesta exitosa para la consulta es:

```json
{
    "code": 200,
    "msg": null,
    "response": "[{\"Identifier\":\"5a37b2ab...",\"Pages\":2,\"Filename\":\"...},{...}]"
}
```

El campo Response es un listado de documentos. Los campos de este listado pueden consultarse en el método [GetInfo](https://docs-agents-api.boolfy.com/getinfo#respuesta).