---
title: "Obtener documento de ajuste"
method: GET
path: "/adjustment-documents/{id_adjustment_document}"
tags: ["Adjustment Documents"]
---

# Obtener documento de ajuste

`GET /adjustment-documents/{id_adjustment_document}`

## Request

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

Devuelve un documento de ajuste a partir de su identificador público, incluyendo su estado: `available` si todavía se puede aplicar como saldo a favor, `used` si ya se aplicó en un pago exitoso y `void` si está anulado.

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

## Path parameters

- `id_adjustment_document` string, required: Identificador público del documento de ajuste (`ad_...`).

## Headers

- `x-account-key` string

## Response `200`

Successful Response

- AdjustmentDocumentWithStatusResponse: Subclass of BaseModel that allows public aliases for fields. _aliases defines aliases in the way "external": "internal"
  - `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.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El documento de ajuste no existe bajo la organización autenticada.
- `422`: El identificador del documento no tiene el formato `ad_...`.
- `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/:id_adjustment_document/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)