Devuelve las compras de la empresa, de las nuevas a las antiguas por fecha del pedido de compra. Las líneas de las compras no se incluyen en la lista; las devuelve [v1/purchases/get_entry](https://developers.controlata.com/hc/api-docs/articles/api-purchases-get-entry-es).

```
v1/purchases/get_list.php
```

## Parámetros

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| date_from | string | No | Compras desde esta fecha de pedido inclusive |
| date_to | string | No | Compras hasta esta fecha de pedido inclusive |
| supplier_id | int | No | Solo las compras de este proveedor |
| limit | int | No | Tamaño de página, de 1 a 1000 |
| offset | int | No | Cuántos registros omitir |

Los filtros de fecha funcionan sobre date_placed. Sin parámetros se devuelven todas las compras de la empresa. Consulta la paginación en [Reglas generales](https://developers.controlata.com/hc/api-docs/articles/api-rules-es).

## Respuesta

Un array purchases con los campos de la compra:

| Campo | Tipo | Descripción |
|---|---|---|
| id | int | ID de la compra |
| status | int | Estado, un código de [Cambiar el estado de la compra](https://developers.controlata.com/hc/api-docs/articles/api-purchases-update-status-es) |
| payment | int | Estado de pago, un código de [Cambiar el estado de pago](https://developers.controlata.com/hc/api-docs/articles/api-purchases-update-payment-es) |
| date_placed | string | Fecha del pedido de compra |
| date_received | string | Fecha de recepción. Cadena vacía si no se ha fijado |
| supplier_id | int | ID del proveedor |
| supplier_name | string | Nombre del proveedor |
| materials_storage_id | int | Almacén de materiales |
| materials_storage_name | string | Nombre del almacén de materiales |
| products_storage_id | int | Almacén de productos |
| products_storage_name | string | Nombre del almacén de productos |
| subtotal | float | Suma de las líneas |
| delivery_price | float | Coste de envío |
| discount | float | Descuento |
| total | float | Total: subtotal más delivery_price menos discount |
| amount | float | Cantidad total si todas las líneas comparten una unidad, si no null |
| lines | int | Número de líneas |
| notes | string | Notas |

El campo total en la raíz de la respuesta contiene el número total de compras que cumplen los filtros.

## Ejemplo de solicitud

```
{
    "date_from": "2026-10-01",
    "supplier_id": 45,
    "limit": 100,
    "offset": 0
}
```

## Ejemplo de respuesta

```
{
    "success": true,
    "purchases": [
        {
            "id": 29645,
            "status": 1,
            "payment": 0,
            "date_placed": "2026-10-06",
            "date_received": "",
            "supplier_id": 45,
            "supplier_name": "Maderas García",
            "materials_storage_id": 3998,
            "materials_storage_name": "Almacén principal",
            "products_storage_id": 3998,
            "products_storage_name": "Almacén principal",
            "subtotal": 30000,
            "delivery_price": 1500,
            "discount": 0,
            "total": 31500,
            "amount": null,
            "lines": 2,
            "notes": "Factura n.º 118"
        }
    ],
    "total": 1
}
```

## Errores

| Error | Motivo |
|---|---|
| Date is not a valid date in format YYYY-MM-DD | date_from o date_to no válida |
| Invalid limit value. Must be between 1 and 1000 | limit no válido |
| Invalid offset value. Must be 0 or greater | offset no válido |
| Offset requires limit | se envió offset sin limit |
