# Listar contenedores

Fuente: /containers/list-containers/

Lista los contenedores de documentos asociados a la cuenta.

**Método:**  GET `https://api.digitafirma.com/v1/containers`

### Request Body

A continuación se describen los parámetros esperados para realizar la búsqueda y paginación:

#### Objeto `indexContainerBatchRequest`

Permite filtrar los resultados de la búsqueda de contenedores.

| Atributo | Tipo | Descripción |
| :- | :- | :- |
| `search` | `string` | Término de búsqueda general (por ejemplo, parte del nombre del contenedor). |
| `status` | `string` | Filtro por el estado actual del contenedor. Ejemplo: `PARTIAL_SIGNED`. |
| `start_date` | `string` | Fecha de inicio para la búsqueda en formato ISO 8601. |
| `end_date` | `string` | Fecha de fin para la búsqueda en formato ISO 8601. |

#### Objeto `pageable`

Configura la paginación y el ordenamiento de los resultados devueltos por el API.

| Atributo | Tipo | Descripción |
| :- | :- | :- |
| `page` | `integer` | Número de página a consultar (el índice inicia en 0). |
| `size` | `integer` | Cantidad de registros devueltos por página. |
| `sort` | `array` | Arreglo de strings con los criterios de ordenamiento (campo y dirección `ASC`/`DESC`). |

## Ejemplo de Integración

```json
{
  "indexContainerBatchRequest": {
    "search": "Factura",
    "status": "PARTIAL_SIGNED",
    "start_date": "2026-05-01T00:00:00Z",
    "end_date": "2026-05-31T23:59:59Z"
  },
  "pageable": {
    "page": 0,
    "size": 20,
    "sort": [
      "created_at,DESC",
      "name,ASC"
    ]
  }
}
```