---
title: "List issued tax documents for prepaid credit top-ups, most recent first"
method: GET
path: "/v1/billing/documents"
---

# List issued tax documents for prepaid credit top-ups, most recent first

`GET /v1/billing/documents`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/billing/documents`
- Auth: HTTP bearer

List of issued tax documents (credit top-ups, monthly plan payments, done-for-you orders) and credit notes, most recent first. `before` is a cursor (Unix ms, exclusive) - send the `nextBefore` from the previous page. The underlying storage never returns more than 100 records per call, even when `limit` asks for more.

## Query parameters

- `limit` integer
- `before` integer

## Response `200`

Tax documents

- object
  - `documents` object[], required
    - `id` string, required
    - `number` string, required
    - `issuedAt` number, required
    - `taxableAt` number, required
    - `netHal` number, required
    - `vatHal` number, required
    - `grossHal` number, required
    - `vatRatePercent` number, required
    - `reverseCharge` boolean, required
    - `description` string, required
    - `customer` object, required
      - `name` string, required
      - `company` string
      - `ico` string
      - `dic` string
      - `street` string
      - `city` string
      - `zip` string
      - `country` string
    - `paymentRef` string, required
    - `pdfUrl` string, required
    - `kind` 'invoice' | 'credit_note', required: Document kind. "invoice" (the default, including every document issued before this field existed) is a regular tax document; "credit_note" is a correction document refunding an earlier one (for example a done-for-you setup fee refund) - its net/vat/gross amounts are POSITIVE, the amount being credited back.
    - `correctsNumber` string: Number of the original document this credit note corrects. Present only when kind is "credit_note".
    - `correctionReason` string: Human-readable reason for the correction, printed on the credit note PDF. Present only when kind is "credit_note".
  - `hasMore` boolean, required
  - `nextBefore` number, nullable, required

## Other responses

- `400`: Error codes: validation (request).
- `401`: Error codes: unauthorized (request).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)