---
title: "Read one tax document's data (amounts, VAT, customer, payment reference, PDF link)"
method: GET
path: "/v1/billing/documents/{id}"
---

# Read one tax document's data (amounts, VAT, customer, payment reference, PDF link)

`GET /v1/billing/documents/{id}`

## Request

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

One tax document's data - amounts, VAT, customer, payment reference and a link to the PDF.

## Path parameters

- `id` string, required

## Response `200`

Tax document

- object
  - `document` 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".

## Other responses

- `401`: Error codes: unauthorized (request).
- `404`: Error codes: invoice_not_found (account).
- `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)