---
title: "Get Invoice"
method: GET
path: "/{invoices-type}/{document-id}.json"
tags: ["Invoices"]
---

# Get Invoice

`GET /{invoices-type}/{document-id}.json`

## Path parameters

- `document-id` integer, required
- `invoices-type` 'invoices' | 'invoice_receipts' | 'simplified_invoices' | 'credit_notes' | 'debit_notes', required

## Query parameters

- `api_key` string, required

## Response `200`

SUCCESS 

#### Possible values for field atcud:

* ABCD1234-1 (or similar) - Unique document identifier to the Tax Authority, when the sequence is registered.
* N/D - The document's sequence is relevant for ATCUD but is not registered in the Tax Authority.
* N/A - The document's sequence is not relevant for ATCUD and is not registered in the Tax Authority.

#### Response wrapper key

The parent key shown in the example below as `invoice` is only an example — it always matches the singular of the requested `{invoices-type}` path parameter: `invoice` for `invoices`, `invoice_receipt` for `invoice_receipts`, `simplified_invoice` for `simplified_invoices`, `credit_note` for `credit_notes`, and `debit_note` for `debit_notes`. The nested object shape is identical in every case.

- InvoiceGetResponse — Returned by the create, get, update, and change-state endpoints for `{invoices-type}` documents. The parent key shown here as `invoice` is only an example — the actual key always matches the singular of the requested `{invoices-type}` path parameter: `invoice` for `invoices`, `invoice_receipt` for `invoice_receipts`, `simplified_invoice` for `simplified_invoices`, `credit_note` for `credit_notes`, and `debit_note` for `debit_notes`. The nested object shape is identical in every case.
  - `invoice` FullDocumentObject
    - `id` integer
    - `status` string
    - `archived` boolean
    - `type` string
    - `sequence_number` string
    - `inverted_sequence_number` string
    - `atcud` string
    - `sequence_id` integer, nullable
    - `tax_exemption` string
    - `date` string
    - `due_date` string
    - `reference` string, nullable
    - `observations` string, nullable — No enforced character limit (text column).
    - `retention` string, nullable
    - `cancel_reason` string, nullable — Present after the document has been canceled. No enforced character limit (text column).
    - `permalink` string
    - `saft_hash` string — Server-generated. No enforced character limit (text column).
    - `sum` number
    - `discount` number, nullable
    - `before_taxes` number
    - `taxes` number
    - `total` number
    - `currency` string
    - `client` InvoiceClient
      - `id` integer
      - `name` string
      - `code` string
      - `country` string
      - `email` string
    - `items` InvoiceItem[]
      - `name` string
      - `description` string, nullable
      - `unit_price` string
      - `quantity` string
      - `unit` string
      - `discount` number
      - `tax` object
        - `id` integer
        - `name` string
        - `value` number
      - `subtotal` number
      - `tax_amount` number
      - `discount_amount` number
      - `total` number
    - `mb_reference` MbReference
      - `entity` string
      - `reference` string
      - `value` number

## Other responses

- `401` — ACCESS DENIED
- `404` — NOT FOUND

## Changes

- **2026-08-25** `5b82d4eb0d9f` — 10 breaking, 1 warning, 5 info
  - the response property `invoice/discount` became nullable for the status `200`
  - the response property `invoice/items/items/description` became nullable for the status `200`
  - the response property `invoice/observations` became nullable for the status `200`
  - the response property `invoice/reference` became nullable for the status `200`
  - …12 more

[Change history](https://skmtc.dev/invoicexpress/apis/invoicexpress-api/changes/:invoices-type/:document-id.json/get.md)

---

[API](https://skmtc.dev/invoicexpress/apis/invoicexpress-api.md) · [All operations](https://skmtc.dev/invoicexpress/apis/invoicexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/invoicexpress/invoicexpress-api/revisions/5b82d4eb0d9f/schema)