---
title: "Get list of accounting documents."
method: GET
path: "/rest/api/finance/documents/"
tags: ["Finance document"]
---

# Get list of accounting documents.

`GET /rest/api/finance/documents/`

List of accounting documents

## Query parameters

- `type` 1 | 5 | 10 | 31
- `hasDocumentDocumentType` 1 | 2
- `hasNotDocumentDocumentType` 1 | 2
- `isFiscal` boolean
- `documentConfig[]` integer[]
- `invoiceBefore` string, date-time — Date of finance document invoice at before date, takes the value of ISO 8601 date encoded to URL, e.g. `2022-03-01T14:40:33+0200`
- `invoiceAfter` string, date-time — Date of finance document invoice at after date, takes the value of ISO 8601 date encoded to URL, e.g. `2022-03-01T14:40:33+0200`
- `offset` integer — Position indicator (0-beginning, 1-skips one record, 256 - skips 256 records)
- `limit` integer — Limit of returned results, max 512 records

## Response `200`

Returns list of accounting documents

- object — This object represents list response.
  - `documents` RestDocumentDTO[] — List of accounting documents
    - `id` integer, nullable — Internal ID of the fiscal document
    - `documentNumber` string, nullable — Fiscal document number
    - `originalAmountTotalWithTax` string, nullable — Gross amount on the document
    - `originalAmountTotalWithoutTax` string, nullable — Nett amount on the document
    - `originalCurrencyExchangeValue` string, nullable — Exchange rate
    - `originalCurrency` string, nullable — Currency in which the order was made
    - `currency` string, nullable — Currency on the document
    - `createdAt` string, date-time, nullable — Date the document was created in Apilo
    - `invoicedAt` string, date-time, nullable, required — Date of issuance of the document
    - `soldAt` string, date-time, nullable — Date of sale on the document
    - `type` string — Document type (1 - Invoice, 2 - Margin invoice, 5 - Receipt, 10 - Proforma invoice)
    - `documentReceiver` RestDocumentPersonalInfoDTO — Collection of personal info belongs to Fiscal document
      - `id` integer, nullable — Internal ID of the personal info
      - `name` string, nullable — Person name
      - `companyName` string, nullable — Company name
      - `companyTaxNumber` string, nullable — Company Tax ID
      - `streetName` string, nullable — Street name
      - `streetNumber` string, nullable — Street number
      - `city` string, nullable — City
      - `zipCode` string, nullable — Zip code
      - `country` string, nullable — Country code
      - `type` 'house' | 'company' | 'parcel' — Document address type
    - `documentIssuer` RestDocumentPersonalInfoDTO — Collection of personal info belongs to Fiscal document
      - `id` integer, nullable — Internal ID of the personal info
      - `name` string, nullable — Person name
      - `companyName` string, nullable — Company name
      - `companyTaxNumber` string, nullable — Company Tax ID
      - `streetName` string, nullable — Street name
      - `streetNumber` string, nullable — Street number
      - `city` string, nullable — City
      - `zipCode` string, nullable — Zip code
      - `country` string, nullable — Country code
      - `type` 'house' | 'company' | 'parcel' — Document address type
    - `documentItems` RestDocumentItemDTO[] — Docment items
      - `id` integer — Internal ID of the item
      - `originalPriceWithTax` string, nullable — Gross price of the invoice item
      - `originalPriceWithoutTax` string, nullable — Net price of the invoice item
      - `tax` string, nullable — Tax of the invoice item
      - `quantity` integer, nullable — Quantity of the invoice items
      - `originalAmountTotalWithTax` string, nullable — Gross value of the invoice item
      - `originalAmountTotalWithoutTax` string, nullable — Net value of the invoice item
      - `originalAmountTotalTax` string, nullable — Tax value of the invoice item
      - `gtu` string, nullable — GTU codes are a type of classification closely related <a href='https://www.podatki.gov.pl/glos-podatnika-szczegoly-zgloszenia?application=114710'>to JPK_VAT</a>
      - `name` string, nullable — External document number
      - `sku` string — SKU
      - `ean` string — EAN
      - `unit` string — Product unit
      - `type` string — Order item type (`1-Product`, `2-Shipment`, `3-service`)
    - `paymentType` integer, nullable, required — <a href='#tag/Order/operation/get_rest_orders_payment_map'>Payment method ID</a>
    - `orderId` string, nullable — Order Id
  - `totalCount` integer — Number of matching results
  - `currentOffset` integer — Current list offset
  - `pageResultCount` integer — Number of results per page

## Other responses

- `401` — Authorization failed

---

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