---
title: "debit-notes__list_debit_notes"
method: POST
path: "/tools/debit-notes__list_debit_notes"
tags: ["Gastos"]
---

# debit-notes__list_debit_notes

`POST /tools/debit-notes__list_debit_notes`

### MCP
`list_debit_notes` → `debit-notes__list_debit_notes`.

### HTTP
`GET /v1/debit-notes`

### Query (arguments)
Paginación: `start` (default 0), `limit` (default 30). `type`: normal | adjustmentNote | all (default normal).
Filtros: `fields`, `metadata`, `order_field`, `order_direction`, `number`, `date`, `item_id`, `provider_name`,
`emissionStatus`, `idGlobal`, `client_id`, `id` (lista de ids locales, máx. **30** en un request), rangos de fecha, etc.

### Respuesta
HTTP **200**: arreglo o `{ metadata, data }` si metadata está definido.

### Errores frecuentes
| Código | Significado | Acción |
|--------|-------------|--------|
| 903 | Paginación inválida o más de 30 ids en `id` | `start`≥0; `limit` válido; máx. 30 ids en `id` |
| 400 | Validación | Revisar `message` y `code` en el cuerpo |

## Request body

- object
  - `start` integer
  - `limit` integer
  - `fields` string
  - `metadata` string
  - `type` 'normal' | 'adjustmentNote' | 'all'
  - `order_field` 'number' | 'name' | 'date' | 'id'
  - `order_direction` 'ASC' | 'DESC'
  - `number` string
  - `date` string, date
  - `item_id` integer
  - `provider_name` string
  - `emissionStatus` string
  - `idGlobal` string
  - `client_id` integer
  - `id` string — Ids separados por coma, máx. 30
  - `date_afterOrNow` string
  - `date_beforeOrNow` string
  - `date_between` string

## Response `200`

Lista de notas de débito

---

[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/versions/cd52d3f68f1b/schema)