---
title: "Obtener documentos tributarios"
method: GET
path: "/receipt"
tags: ["Receipts"]
---

# Obtener documentos tributarios

`GET /receipt`

## Request

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

Devuelve los documentos tributarios ya emitidos.

Admite dos formas de consulta: por `id_receipt`, que devuelve ese documento con su dirección de descarga, o por `id_transaction`, que devuelve todos los documentos emitidos por esa Transaction junto con el identificador externo de la deuda que respalda cada uno. Si se envían ambos, se resuelve por `id_receipt`.

Debe enviarse al menos uno de los dos; si no se envía ninguno, la respuesta es `400`.

## Query parameters

- `id_receipt` string, nullable: Identificador público del documento tributario a consultar (`rpt_…`).
- `id_transaction` string, nullable: Identificador público de una Transaction (`trs_…`) para obtener todos los documentos tributarios emitidos por ella.

## Headers

- `x-account-key` string

## Response `200`

El documento pedido por `id_receipt`, o el listado de documentos de la Transaction pedida por `id_transaction`.

- union
  - ReceiptDetail: Documento tributario ya emitido para una deuda.
    - `id_receipt` string, required: Identificador público del documento tributario (`rpt_…`).
    - `url` string, required: Dirección desde la que se puede descargar el documento.
  - TransactionReceipts: Documentos tributarios emitidos por una Transaction.
    - `receipts` TransactionReceiptDetail[], required: Documentos emitidos por la Transaction consultada, uno por cada deuda que pagó.
      - `id_receipt` string, required: Identificador público del documento tributario (`rpt_…`).
      - `invoice_external_id` string, required: Identificador externo de la deuda que el documento respalda.
      - `url` string, required: Dirección desde la que se puede descargar el documento.

## Other responses

- `400`: No se envió `id_receipt` ni `id_transaction`.
- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: El recurso solicitado no existe.
- `422`: El cuerpo de la petición no pasó la validación.
- `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/receipt/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)