---
title: "purchase-orders__list-purchase-orders"
method: POST
path: "/tools/purchase-orders__list-purchase-orders"
tags: ["Gastos"]
---

# purchase-orders__list-purchase-orders

`POST /tools/purchase-orders__list-purchase-orders`

### MCP
`list-purchase-orders` → `purchase-orders__list-purchase-orders`.

### HTTP
`GET /v1/purchase-orders`

### Query (arguments)
Defaults API/MCP: **start=0**, **limit=30**. Opcional: `metadata` (boolean), `order_field` (name, date, id, deliveryDate, status),
`order_direction` (ASC|DESC), `fields`, `client_id`, `provider_name`, `costCenter_id` (usar `null`/`none`/`0` para sin CC),
`warehouse_id`, `fullNumber`, `number`, `item_id`, `status`, `date`, `deliveryDate`, `delivery_date`, `id`, `currency`.

### Respuesta
Arreglo de órdenes o `{ metadata: { total }, data }` con metadata=true.

### Errores frecuentes
| Código | Significado | Acción |
|--------|-------------|--------|
| 903 | Paginación inválida (`start`/`limit`) | Valores dentro del máximo del API |
| 905 | Petición mal formada o serialización | Revisar query y tipos |
| 400 | Validación | Revisar `message` y `code` en el cuerpo |

## Request body

- object
  - `start` number
  - `limit` number
  - `metadata` boolean
  - `order_field` 'name' | 'date' | 'id' | 'deliveryDate' | 'status'
  - `order_direction` 'ASC' | 'DESC'
  - `fields` string
  - `client_id` number
  - `provider_name` string
  - `costCenter_id` string
  - `warehouse_id` string
  - `fullNumber` string
  - `number` string
  - `item_id` number
  - `status` string
  - `date` string
  - `deliveryDate` string
  - `delivery_date` string
  - `id` string
  - `currency` string

## Response `200`

Lista de purchase orders

---

[API](https://skmtc.net/alegra/apis/ingresos.md) · [All operations](https://skmtc.net/alegra/apis/ingresos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/ingresos/revisions/cd52d3f68f1b/schema)