---
title: "Read an invoice"
method: GET
path: "/invoices/{id}"
---

# Read an invoice

`GET /invoices/{id}`

## Request

- Base URL: `https://swap.vurto.cc/v1`
- URL: `https://swap.vurto.cc/v1/invoices/{id}`
- Auth: none required

Pending payments are re-checked on-chain on every read; a payment pending for over an hour becomes tx_not_found.

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `invoice` object
    - `id` string
    - `label` string: INV-XXXX-XXXX, what people copy.
    - `family` 'evm' | 'svm'
    - `chainId` union
      - integer
      - string
    - `recipient` string
    - `token` string
    - `tokenSymbol` string
    - `tokenDecimals` integer
    - `amount` string: Requested amount, raw units.
    - `memo` string, nullable
    - `status` 'open' | 'paid'
    - `paidTx` string, nullable
    - `received` string: Raw amount measured on-chain reaching the recipient, over confirmed payments.
    - `url` string: Share this: https://swap.vurto.cc/i/<id>. Link previews show the QR.
    - `qr` string: PNG of the QR for url.
    - `payments` object[]

## Other responses

- `404`: invoice_not_found

---

[API](https://skmtc.dev/vurto/apis/vurto-swap-public-api.md) · [All operations](https://skmtc.dev/vurto/apis/vurto-swap-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vurto/apis/vurto-swap-public-api/revisions/423be3a193b5?raw)