--- title: "Pobierz listę kosztów" description: "Zakres: `api:costs:read`. Koszty, skany dokumentów i dowody wewnętrzne, od najnowszej daty wystawienia.\nPrzy `offset` i `limit` wartość `offset` musi być wielokrotnością `limit` albo `limit - 1`; w przeciwnym razie `400`." --- > Documentation Index > Fetch the complete documentation index at: https://docs.niebieskiorzel.pl/llms.txt > Use this file to discover all available pages before exploring further. Path: inFakt API › Koszty `GET /documents/costs.json` Zakres: `api:costs:read`. Koszty, skany dokumentów i dowody wewnętrzne, od najnowszej daty wystawienia. Przy `offset` i `limit` wartość `offset` musi być wielokrotnością `limit` albo `limit - 1`; w przeciwnym razie `400`. ## Authentication Requires one of the following: - `ApiKey`, apiKey, in header, header `X-inFakt-ApiKey` - `Token`, apiKey, in header, header `X-Token` ## Query parameters - `page` (`CostDocuments_list.query.page`; integer, optional) — Numer strony liczony od 1; ignorowany, gdy wysłany jest `offset`. - format `int32`; default `1` - `per_page` (`CostDocuments_list.query.per_page`; integer, optional) — Liczba wyników na stronę przy `page`. Serwer jej nie ogranicza. - format `int32`; default `10` - `offset` (`CostDocuments_list.query.offset`; integer, optional) — Indeks pierwszego wyniku (liczba pomijanych encji). - format `int32` - `limit` (`CostDocuments_list.query.limit`; integer, optional) — Liczba wyników na stronę przy `offset`; domyślnie 10, ignorowana bez `offset`. Większość list bez błędu obniża wartości powyżej 100 do 100. - format `int32` - `pagination_without_total` (`CostDocuments_list.query.pagination_without_total`; boolean, optional) — Pomiń liczenie; `metainfo.total_count` przyjmuje wartość `null`. - `order` (`CostDocuments_list.query.order`; string, optional) — Kolumna sortowania i kierunek małymi literami. Domyślnie `issue_date desc`. Bez kierunku albo z kierunkiem wielkimi literami obowiązuje kolejność domyślna. Dokumenty bez wartości trafiają na koniec dla każdej kolumny poza `created_at` i `currency`. - one of `"issue_date desc"`, `"issue_date asc"`, `"received_date desc"`, `"received_date asc"`, `"due_date desc"`, `"due_date asc"`, `"accounted_at desc"`, `"accounted_at asc"`, `"created_at desc"`, `"created_at asc"`, `"category desc"`, `"category asc"`, `"net_price desc"`, `"net_price asc"`, `"gross_price desc"`, `"gross_price asc"`, `"tax_price desc"`, `"tax_price asc"`, `"currency desc"`, `"currency asc"` - `q[created_at_gteq]` (`CostDocuments_list.query.q[created_at_gteq]`; string, optional) - format `date` - `q[created_at_lteq]` (`CostDocuments_list.query.q[created_at_lteq]`; string, optional) - format `date` - `q[issue_date_gteq]` (`CostDocuments_list.query.q[issue_date_gteq]`; string, optional) - format `date` - `q[issue_date_lteq]` (`CostDocuments_list.query.q[issue_date_lteq]`; string, optional) - format `date` - `q[received_date_gteq]` (`CostDocuments_list.query.q[received_date_gteq]`; string, optional) - format `date` - `q[received_date_lteq]` (`CostDocuments_list.query.q[received_date_lteq]`; string, optional) - format `date` - `q[due_date_gteq]` (`CostDocuments_list.query.q[due_date_gteq]`; string, optional) - format `date` - `q[due_date_lteq]` (`CostDocuments_list.query.q[due_date_lteq]`; string, optional) - format `date` - `q[accounted_at_date_gteq]` (`CostDocuments_list.query.q[accounted_at_date_gteq]`; string, optional) — Data zaksięgowania; skany dokumentów są pomijane. - format `date` - `q[accounted_at_date_lteq]` (`CostDocuments_list.query.q[accounted_at_date_lteq]`; string, optional) — Data zaksięgowania; skany dokumentów są pomijane. - format `date` - `q[seller_name_i_cont]` (`CostDocuments_list.query.q[seller_name_i_cont]`; string, optional) - `q[seller_tax_code_i_cont]` (`CostDocuments_list.query.q[seller_tax_code_i_cont]`; string, optional) - `q[number_i_cont]` (`CostDocuments_list.query.q[number_i_cont]`; string, optional) - `q[description_i_cont]` (`CostDocuments_list.query.q[description_i_cont]`; string, optional) - `q[net_in_cents_gteq]` (`CostDocuments_list.query.q[net_in_cents_gteq]`; integer, optional) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `q[net_in_cents_lteq]` (`CostDocuments_list.query.q[net_in_cents_lteq]`; integer, optional) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `q[gross_in_cents_gteq]` (`CostDocuments_list.query.q[gross_in_cents_gteq]`; integer, optional) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `q[gross_in_cents_lteq]` (`CostDocuments_list.query.q[gross_in_cents_lteq]`; integer, optional) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `q[currency_in][]` (`CostDocuments_list.query.q[currency_in][]`; array, optional) — Kody walut, np. `EUR`. - `q[kind_in][]` (`CostDocuments_list.query.q[kind_in][]`; array, optional) - `q[category_in][]` (`CostDocuments_list.query.q[category_in][]`; array, optional) — Nazwy kategorii kosztu, np. `Paliwo`. - `q[category_i_cont]` (`CostDocuments_list.query.q[category_i_cont]`; string, optional) — Fragment nazwy kategorii kosztu. - `q[document_type_in][]` (`CostDocuments_list.query.q[document_type_in][]`; array, optional) — Skany dokumentów są pomijane. - `q[source_eq]` (`CostDocuments_list.query.q[source_eq]`; string, optional) - `q[with_attachments_eq]` (`CostDocuments_list.query.q[with_attachments_eq]`; boolean, optional) - `q[with_notes_eq]` (`CostDocuments_list.query.q[with_notes_eq]`; boolean, optional) - `q[search_input]` (`CostDocuments_list.query.q[search_input]`; string, optional) — Szuka jednocześnie w nazwie sprzedawcy, NIP-ie, numerze i opisie. - `q[document_statuses_symbol_in][]` (`CostDocuments_list.query.q[document_statuses_symbol_in][]`; array, optional) — Symbole statusów z `statuses[].symbol`; dokument musi mieć wszystkie. Płatność: `paid`, `unpaid`, `partial_payment`, `in_progress`, `payment_not_applicable`. Księgowanie: `cost_accounted`, `autox_accounted`, `cost_not_accounted`, `cost_rejected`, `to_clarify`, `cost_accounting_not_applicable`. - `q[payment_document_statuses_symbol_in][]` (`CostDocuments_list.query.q[payment_document_statuses_symbol_in][]`; array, optional) — Symbole statusów płatności; dokument musi mieć którykolwiek z nich (łączone przez OR z `cost_accounting_document_statuses_symbol_in`). - `q[cost_accounting_document_statuses_symbol_in][]` (`CostDocuments_list.query.q[cost_accounting_document_statuses_symbol_in][]`; array, optional) — Symbole statusów księgowania; dokument musi mieć którykolwiek z nich (łączone przez OR z `payment_document_statuses_symbol_in`). ## Code samples ### cURL ```bash curl --request GET \ --url https://api.sandbox-infakt.pl/v3/documents/costs.json \ --header 'X-inFakt-ApiKey: ' ``` ### TypeScript ```typescript const url = 'https://api.sandbox-infakt.pl/v3/documents/costs.json'; const options = {method: 'GET', headers: {'X-inFakt-ApiKey': ''}}; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error(err)); ``` ### Python ```python import requests url = "https://api.sandbox-infakt.pl/v3/documents/costs.json" headers = {"X-inFakt-ApiKey": ""} response = requests.get(url, headers=headers) print(response.text) ``` ## Responses ### 200 Sukces #### Example ```json { "metainfo": { "count": 1, "total_count": 1, "next": "https://api.infakt.pl/v3/documents/costs.json?q%5Bissue_date_gteq%5D=2026-10-01&limit=10&offset=10", "previous": "https://api.infakt.pl/v3/documents/costs.json?q%5Bissue_date_gteq%5D=2026-10-01&limit=10&offset=0" }, "count": 1, "total_count": 1, "current_page": 1, "pages": 1, "entities": [ { "uuid": "2f6e8a1c-3b4d-4e5f-9a6b-7c8d9e0f1a2b", "number": "FV/123/10/2026", "net_price": 10000, "gross_price": 12300, "tax_price": 2300, "currency": "PLN", "accounted_at": "2026-10-02", "issue_date": "2026-10-01", "received_date": "2026-10-02", "due_date": "2026-10-15", "seller_name": "Dostawca Sp. z o.o.", "seller_tax_code": "1234563218", "seller_bank_account": "61109010140000071219812874", "description": null, "added_by": "Jan Kowalski", "category": "Artykuły biurowe", "kind": "cost", "notes_count": 0, "newest_note": null, "duplicated": false, "created_at": "2026-10-02 10:15:00 +0200", "source": null, "reconciliation_id": null, "statuses": [], "attachments": [ { "file_name": "faktura.pdf", "file_url": "https://infakt-files.s3.eu-central-1.amazonaws.com/q7w3k9x2m4p8?response-content-disposition=inline%3B%20filename%3D%22faktura.pdf%22&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20261002T081500Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=5f1c0e9a", "download_url": "https://infakt-files.s3.eu-central-1.amazonaws.com/q7w3k9x2m4p8?response-content-disposition=attachment%3B%20filename%3D%22faktura.pdf%22&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20261002T081500Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=9b2d4a71", "document_scan_uuid": "3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f", "kind_id": 21 } ], "related_internal_note": null, "notes": [], "related_exchange_differences_internal_evidences": [] } ] } ``` - `metainfo` (`CostDocuments_list.response.200.metainfo`; object, required) - `count` (`CostDocuments_list.response.200.metainfo.count`; integer, required) — Liczba encji na tej stronie. - format `int32` - `total_count` (`CostDocuments_list.response.200.metainfo.total_count`; any of, required) — Liczba pasujących encji; `null`, gdy `pagination_without_total=true`. - any of: `integer`, `null` - `next` (`CostDocuments_list.response.200.metainfo.next`; string, required) — Bezwzględny URL następnej strony w postaci `offset`/`limit`. - `previous` (`CostDocuments_list.response.200.metainfo.previous`; string, required) — Bezwzględny URL poprzedniej strony w postaci `offset`/`limit`. - `entities` (`CostDocuments_list.response.200.entities`; array, required) - `uuid` (`CostDocuments_list.response.200.entities.uuid`; string, required) - format `uuid` - `number` (`CostDocuments_list.response.200.entities.number`; any of, required) - any of: `string`, `null` - `net_price` (`CostDocuments_list.response.200.entities.net_price`; any of, required) - any of: `Money`, `null` - `gross_price` (`CostDocuments_list.response.200.entities.gross_price`; any of, required) - any of: `Money`, `null` - `tax_price` (`CostDocuments_list.response.200.entities.tax_price`; any of, required) - any of: `Money`, `null` - `currency` (`CostDocuments_list.response.200.entities.currency`; any of, required) - any of: `string`, `null` - `accounted_at` (`CostDocuments_list.response.200.entities.accounted_at`; any of, required) - any of: `string`, `null` - `issue_date` (`CostDocuments_list.response.200.entities.issue_date`; any of, required) - any of: `string`, `null` - `received_date` (`CostDocuments_list.response.200.entities.received_date`; any of, required) - any of: `string`, `null` - `due_date` (`CostDocuments_list.response.200.entities.due_date`; any of, required) - any of: `string`, `null` - `seller_name` (`CostDocuments_list.response.200.entities.seller_name`; any of, required) - any of: `string`, `null` - `seller_tax_code` (`CostDocuments_list.response.200.entities.seller_tax_code`; any of, required) - any of: `string`, `null` - `seller_bank_account` (`CostDocuments_list.response.200.entities.seller_bank_account`; any of, required) - any of: `string`, `null` - `description` (`CostDocuments_list.response.200.entities.description`; any of, required) - any of: `string`, `null` - `added_by` (`CostDocuments_list.response.200.entities.added_by`; string, required) - `category` (`CostDocuments_list.response.200.entities.category`; any of, required) — Nazwa kategorii kosztu. - any of: `string`, `null` - `kind` (`CostDocuments_list.response.200.entities.kind`; string, required) - one of `"cost"`, `"document_scan"`, `"internal_evidence"`, `"health_fee_evidence"`, `"work_fund_evidence"` - `notes_count` (`CostDocuments_list.response.200.entities.notes_count`; any of, required) - any of: `integer`, `null` - `newest_note` (`CostDocuments_list.response.200.entities.newest_note`; any of, required) - any of: `DocumentNote`, `null` - `duplicated` (`CostDocuments_list.response.200.entities.duplicated`; boolean, required) - `created_at` (`CostDocuments_list.response.200.entities.created_at`; string, required) — Znacznik czasu ze strefą czasową. - `source` (`CostDocuments_list.response.200.entities.source`; any of, required) - any of: `string`, `null` - `reconciliation_id` (`CostDocuments_list.response.200.entities.reconciliation_id`; any of, required) - any of: `integer`, `null` - `statuses` (`CostDocuments_list.response.200.entities.statuses`; array, required) - `symbol` (`CostDocuments_list.response.200.entities.statuses.symbol`; string, required) - `name` (`CostDocuments_list.response.200.entities.statuses.name`; string, required) - `group` (`CostDocuments_list.response.200.entities.statuses.group`; string, required) - `attachments` (`CostDocuments_list.response.200.entities.attachments`; array, optional) — Tylko w odpowiedzi `get`. - `file_name` (`CostDocuments_list.response.200.entities.attachments.file_name`; string, required) - `file_url` (`CostDocuments_list.response.200.entities.attachments.file_url`; string, required) — Tymczasowy link, który wyświetla plik w przeglądarce; ważny 5 minut. - `download_url` (`CostDocuments_list.response.200.entities.attachments.download_url`; string, required) — Tymczasowy link do pobrania pliku; ważny 5 minut. - `document_scan_uuid` (`CostDocuments_list.response.200.entities.attachments.document_scan_uuid`; any of, required) - any of: `Uuid`, `null` - `kind_id` (`CostDocuments_list.response.200.entities.attachments.kind_id`; any of, required) - any of: `integer`, `null` - `related_internal_note` (`CostDocuments_list.response.200.entities.related_internal_note`; any of, optional) — Tylko w odpowiedzi `get`. - any of: `InternalNoteReference`, `null` - `notes` (`CostDocuments_list.response.200.entities.notes`; array, optional) — Tylko w odpowiedzi `get`. - `kind` (`CostDocuments_list.response.200.entities.notes.kind`; string, required) - `content` (`CostDocuments_list.response.200.entities.notes.content`; string, required) - `created_by` (`CostDocuments_list.response.200.entities.notes.created_by`; any of, required) - any of: `string`, `null` - `author_first_name` (`CostDocuments_list.response.200.entities.notes.author_first_name`; any of, required) - any of: `string`, `null` - `author_last_name` (`CostDocuments_list.response.200.entities.notes.author_last_name`; any of, required) - any of: `string`, `null` - `author_avatar` (`CostDocuments_list.response.200.entities.notes.author_avatar`; any of, required) - any of: `string`, `null` - `created_at` (`CostDocuments_list.response.200.entities.notes.created_at`; string, required) - `related_exchange_differences_internal_evidences` (`CostDocuments_list.response.200.entities.related_exchange_differences_internal_evidences`; array, optional) — Tylko w odpowiedzi `get`. - `id` (`CostDocuments_list.response.200.entities.related_exchange_differences_internal_evidences.id`; integer, required) - format `int64` - `number` (`CostDocuments_list.response.200.entities.related_exchange_differences_internal_evidences.number`; string, required) - `uuid` (`CostDocuments_list.response.200.entities.related_exchange_differences_internal_evidences.uuid`; string, required) - format `uuid` - `count` (`CostDocuments_list.response.200.count`; integer, required) - format `int32` - `total_count` (`CostDocuments_list.response.200.total_count`; any of, required) - any of: `integer`, `null` - `current_page` (`CostDocuments_list.response.200.current_page`; integer, required) - format `int32` - `pages` (`CostDocuments_list.response.200.pages`; any of, required) - any of: `integer`, `null` ### 400 Nieprawidłowe parametry wyszukiwania (`q[...]`); na niektórych endpointach także nieprawidłowe parametry stronicowania. #### Example ```json { "error": "Nieprawidłowe parametry paginacji. Parametr offset musi być wielokrotnością parametru limit." } ``` - `error` (`CostDocuments_list.response.400.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`CostDocuments_list.response.400.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`CostDocuments_list.response.400.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`CostDocuments_list.response.400.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`CostDocuments_list.response.400.url`; string, optional) - `action_url` (`CostDocuments_list.response.400.action_url`; string, optional) ### 401 Brak klucza API, nieprawidłowy klucz albo klucz bez wymaganego zakresu uprawnień. #### Example ```json { "error": "Klucz API który podałeś jest nieprawidłowy." } ``` - `error` (`CostDocuments_list.response.401.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`CostDocuments_list.response.401.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`CostDocuments_list.response.401.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`CostDocuments_list.response.401.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`CostDocuments_list.response.401.url`; string, optional) - `action_url` (`CostDocuments_list.response.401.action_url`; string, optional) ### 402 API niedostępne w obecnym planie (`limit: plan_upgrade_needed`) albo osiągnięty limit dokumentów. #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`CostDocuments_list.response.402.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`CostDocuments_list.response.402.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`CostDocuments_list.response.402.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`CostDocuments_list.response.402.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`CostDocuments_list.response.402.url`; string, optional) - `action_url` (`CostDocuments_list.response.402.action_url`; string, optional) ### 406 Ścieżka nie kończy się na `.json`. #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`CostDocuments_list.response.406.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`CostDocuments_list.response.406.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`CostDocuments_list.response.406.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`CostDocuments_list.response.406.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`CostDocuments_list.response.406.url`; string, optional) - `action_url` (`CostDocuments_list.response.406.action_url`; string, optional) ### 423 Niepotwierdzony adres e-mail albo wymagana weryfikacja tożsamości. #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`CostDocuments_list.response.423.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`CostDocuments_list.response.423.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`CostDocuments_list.response.423.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`CostDocuments_list.response.423.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`CostDocuments_list.response.423.url`; string, optional) - `action_url` (`CostDocuments_list.response.423.action_url`; string, optional) ### 429 Przekroczony limit zapytań. Komunikat jest po angielsku, np. `API rate limit exceeded. Try again in 60 seconds.` #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`CostDocuments_list.response.429.error`; any of, optional) — Komunikat po polsku (po angielsku dla `429`). Niektóre akcje zamiast jednego tekstu zwracają listę komunikatów albo błędy walidacji według pól. - any of: `string`, `array`, `object` - `errors` (`CostDocuments_list.response.429.errors`; any of, optional) — Błędy walidacji według nazw pól API; na niektórych endpointach zwykły komunikat. - any of: `object`, `string` - `limit` (`CostDocuments_list.response.429.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`CostDocuments_list.response.429.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`CostDocuments_list.response.429.url`; string, optional) - `action_url` (`CostDocuments_list.response.429.action_url`; string, optional) Source: https://docs.niebieskiorzel.pl/api/cost-documents-list/index.md