---
title: "Listar documentos de ajuste"
method: GET
path: "/adjustment-documents"
tags: ["Adjustment Documents"]
---

# Listar documentos de ajuste

`GET /adjustment-documents`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/adjustment-documents`
- Auth: API key in header `x-api-key`

Devuelve una lista paginada de los documentos de ajuste de la organización, del más reciente al más antiguo. Se usa para recorrer o conciliar los documentos registrados, por ejemplo todos los de un Customer con `customer_id`. Incluye los documentos anulados, con `status=void`. Los filtros son opcionales y se combinan con AND. La paginación es por cursor: reenvía el `next_cursor` de la respuesta para avanzar de página; es null en la última página.

**Límite de tasa:** 20 solicitudes por segundo. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa).

## Query parameters

- `page_size` integer: Cantidad máxima de elementos por página (entre 1 y 100).
- `next_cursor` string: Cursor de la página siguiente. Envía el `next_cursor` devuelto en la respuesta anterior para continuar; omítelo en la primera llamada.
- `customer_id` string: Filtra por el identificador público del Customer (`cus_...`).
- `account_id` string: Filtra por el identificador público de la Account (`acc_...`).
- `invoice_id` string: Filtra por el identificador público de la Invoice de origen (`in_...`).
- `type` 'credit_note' | 'supplier_invoice': An enumeration.
- `status` AdjustmentDocumentStatus[]: Filtra por estado del documento: `available`, `used` o `void`. Puede repetirse para incluir varios estados, hasta 3 veces.
- `external_id` string: Filtra por el identificador definido por la organización (1 a 256 caracteres).
- `issued_at_from` string, date-time: Devuelve solo los documentos emitidos desde esta fecha y hora (inclusive), en formato ISO 8601 con hora; una fecha sola se rechaza. Sin zona horaria se interpreta como UTC.
- `issued_at_to` string, date-time: Devuelve solo los documentos emitidos hasta esta fecha y hora (inclusive), en formato ISO 8601 con hora; una fecha sola se rechaza. Sin zona horaria se interpreta como UTC. No puede ser anterior a `issued_at_from`.

## Headers

- `x-account-key` string

## Response `200`

Successful Response

- ListAdjustmentDocumentsResponse
  - `items` AdjustmentDocumentWithStatusResponse[], required: Documentos de ajuste de la página, del más reciente al más antiguo.
    - `amount` number, required: Monto del documento en la moneda de la Account.
    - `created_at` string, date-time, required: Fecha y hora de registro en UTC.
    - `external_id` string, required: Identificador definido por la organización.
    - `id` string, required: Identificador del documento de ajuste.
    - `id_account` string, required: Identificador de la Account.
    - `id_customer` string, required: Identificador del Customer.
    - `id_origin_invoice` string: Identificador de la Invoice a la que está ligado el documento, que solo se puede aplicar al pagar esa Invoice. null si se puede aplicar al pagar cualquier Invoice del mismo Customer y Account.
    - `is_void` boolean: Indica si el documento está anulado. Los documentos anulados se excluyen de la disponibilidad al momento del cobro.
    - `issued_at` string, date-time: Fecha y hora de emisión del documento (UTC), distinta de la de registro. null si no está definida.
    - `metadata` object: Metadata de pares clave/valor de formato libre asociada al documento.
    - `status` 'available' | 'used' | 'void', required: Derived, not stored: void > used > available.
    - `type` 'credit_note' | 'supplier_invoice', required: An enumeration.
  - `next_cursor` string: Cursor para pedir la página siguiente. null si no hay más resultados.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El recurso solicitado no existe.
- `422`: Los parámetros no pasaron la validación: `page_size` fuera de 1 a 100, parámetro desconocido, identificador público inválido, filtro con un valor no soportado, `issued_at_from` posterior a `issued_at_to` o `next_cursor` inválido.
- `429`: Se superó el límite de peticiones permitidas.

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/adjustment-documents/get.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)