--- title: "Pobierz listę faktur wewnętrznych" description: "Zakres: `api:invoices:read`." --- > 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 › Faktury wewnętrzne `GET /internal_invoices.json` Zakres: `api:invoices:read`. ## Authentication Requires one of the following: - `ApiKey`, apiKey, in header, header `X-inFakt-ApiKey` - `Token`, apiKey, in header, header `X-Token` ## Query parameters - `page` (`InternalInvoices_list.query.page`; integer, optional) — Numer strony liczony od 1; ignorowany, gdy wysłany jest `offset`. - format `int32`; default `1` - `per_page` (`InternalInvoices_list.query.per_page`; integer, optional) — Liczba wyników na stronę przy `page`. Serwer jej nie ogranicza. - format `int32`; default `10` - `offset` (`InternalInvoices_list.query.offset`; integer, optional) — Indeks pierwszego wyniku (liczba pomijanych encji). - format `int32` - `limit` (`InternalInvoices_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` (`InternalInvoices_list.query.pagination_without_total`; boolean, optional) — Pomiń liczenie; `metainfo.total_count` przyjmuje wartość `null`. - `fields` (`InternalInvoices_list.query.fields`; string, optional) — Zawężenie pól: nazwy pól API rozdzielone przecinkami, np. `id,company_name`; `id` jest zwykle dodawane. Odpowiedź zawiera wtedy tylko te pola, więc nie odpowiada pełnemu schematowi. Pola wyliczane, a nie zapisywane, mogą kończyć się błędem `500`; operacja je wymienia. - `order` (`InternalInvoices_list.query.order`; string, optional) — Sortowanie: ``, ` asc` albo ` desc` z nazwą pola API, np. `name desc`. Pole, po którym nie da się sortować, jest ignorowane bez błędu. - `q[number_eq]` (`InternalInvoices_list.query.q[number_eq]`; string, optional) - `q[invoice_date_gteq]` (`InternalInvoices_list.query.q[invoice_date_gteq]`; string, optional) - format `date` - `q[invoice_date_lteq]` (`InternalInvoices_list.query.q[invoice_date_lteq]`; string, optional) - format `date` ## Code samples ### cURL ```bash curl --request GET \ --url https://api.sandbox-infakt.pl/v3/internal_invoices.json \ --header 'X-inFakt-ApiKey: ' ``` ### TypeScript ```typescript const url = 'https://api.sandbox-infakt.pl/v3/internal_invoices.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/internal_invoices.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/internal_invoices.json?offset=10&limit=10", "previous": "https://api.infakt.pl/v3/internal_invoices.json?offset=0&limit=10" }, "entities": [ { "id": 3001, "uuid": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d", "number": "1/FW/10/2026", "kind": "internal", "transaction_kind_symbol": "free_transfer_of_goods", "invoice_date": "2026-10-01", "net_price": 0, "tax_price": 0, "gross_price": 12300, "status": "draft", "notes": "Nieodpłatne przekazanie towaru", "services": [ { "name": "BRAK", "tax_symbol": "23", "net_price": 10000, "vat_price": 2300, "gross_price": 12300 } ], "ksef_data": null, "third_party_addresses": [], "related_exchange_differences_internal_evidences": [] } ] } ``` - `metainfo` (`InternalInvoices_list.response.200.metainfo`; object, required) - `count` (`InternalInvoices_list.response.200.metainfo.count`; integer, required) — Liczba encji na tej stronie. - format `int32` - `total_count` (`InternalInvoices_list.response.200.metainfo.total_count`; any of, required) — Liczba pasujących encji; `null`, gdy `pagination_without_total=true`. - any of: `integer`, `null` - `next` (`InternalInvoices_list.response.200.metainfo.next`; string, required) — Bezwzględny URL następnej strony w postaci `offset`/`limit`. - `previous` (`InternalInvoices_list.response.200.metainfo.previous`; string, required) — Bezwzględny URL poprzedniej strony w postaci `offset`/`limit`. - `entities` (`InternalInvoices_list.response.200.entities`; array, required) - `id` (`InternalInvoices_list.response.200.entities.id`; integer, required) - format `int64` - `uuid` (`InternalInvoices_list.response.200.entities.uuid`; string, required) - format `uuid` - `number` (`InternalInvoices_list.response.200.entities.number`; string, required) - `kind` (`InternalInvoices_list.response.200.entities.kind`; string, required) - one of `"vat"`, `"proforma"`, `"margin"`, `"advance"`, `"correction"`, `"margin_correction"`, `"margin_advance"`, `"final"`, `"margin_final"`, `"fiscal_report"`, `"internal"` - `transaction_kind_symbol` (`InternalInvoices_list.response.200.entities.transaction_kind_symbol`; string, required) — Zobacz `GET /transaction_kinds.json`. - `invoice_date` (`InternalInvoices_list.response.200.entities.invoice_date`; string, required) - format `date` - `net_price` (`InternalInvoices_list.response.200.entities.net_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `tax_price` (`InternalInvoices_list.response.200.entities.tax_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `gross_price` (`InternalInvoices_list.response.200.entities.gross_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `status` (`InternalInvoices_list.response.200.entities.status`; string, required) - one of `"draft"`, `"sent"`, `"printed"`, `"unpaid"`, `"paid"`, `"scheduled"` - `notes` (`InternalInvoices_list.response.200.entities.notes`; any of, required) - any of: `string`, `null` - `services` (`InternalInvoices_list.response.200.entities.services`; array, required) - `name` (`InternalInvoices_list.response.200.entities.services.name`; string, required) — Zawsze `BRAK`. - `tax_symbol` (`InternalInvoices_list.response.200.entities.services.tax_symbol`; string, required) - `net_price` (`InternalInvoices_list.response.200.entities.services.net_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `vat_price` (`InternalInvoices_list.response.200.entities.services.vat_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `gross_price` (`InternalInvoices_list.response.200.entities.services.gross_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `ksef_data` (`InternalInvoices_list.response.200.entities.ksef_data`; any of, required) - any of: `InvoiceKsefData`, `null` - `third_party_addresses` (`InternalInvoices_list.response.200.entities.third_party_addresses`; array, required) - `id` (`InternalInvoices_list.response.200.entities.third_party_addresses.id`; integer, required) - format `int64` - `company_name` (`InternalInvoices_list.response.200.entities.third_party_addresses.company_name`; any of, required) - any of: `string`, `null` - `tax_id` (`InternalInvoices_list.response.200.entities.third_party_addresses.tax_id`; any of, required) - any of: `string`, `null` - `street` (`InternalInvoices_list.response.200.entities.third_party_addresses.street`; any of, required) - any of: `string`, `null` - `building_number` (`InternalInvoices_list.response.200.entities.third_party_addresses.building_number`; any of, required) - any of: `string`, `null` - `door_number` (`InternalInvoices_list.response.200.entities.third_party_addresses.door_number`; any of, required) - any of: `string`, `null` - `post_code` (`InternalInvoices_list.response.200.entities.third_party_addresses.post_code`; any of, required) - any of: `string`, `null` - `city` (`InternalInvoices_list.response.200.entities.third_party_addresses.city`; any of, required) - any of: `string`, `null` - `country_code` (`InternalInvoices_list.response.200.entities.third_party_addresses.country_code`; any of, required) - any of: `CountryCode`, `null` - `role_code` (`InternalInvoices_list.response.200.entities.third_party_addresses.role_code`; any of, required) — Kod roli podmiotu trzeciego w KSeF; zobacz `ThirdPartyAddressInput.role_code`. - any of: `string`, `null` - `internal_identifier` (`InternalInvoices_list.response.200.entities.third_party_addresses.internal_identifier`; any of, required) - any of: `string`, `null` - `related_exchange_differences_internal_evidences` (`InternalInvoices_list.response.200.entities.related_exchange_differences_internal_evidences`; array, required) - `id` (`InternalInvoices_list.response.200.entities.related_exchange_differences_internal_evidences.id`; integer, required) - format `int64` - `number` (`InternalInvoices_list.response.200.entities.related_exchange_differences_internal_evidences.number`; string, required) - `uuid` (`InternalInvoices_list.response.200.entities.related_exchange_differences_internal_evidences.uuid`; string, required) - format `uuid` - `parent_invoice_data` (`InternalInvoices_list.response.200.entities.parent_invoice_data`; null, optional) — Tylko w odpowiedzi `get`; zawsze `null`. ### 400 Nieprawidłowe parametry wyszukiwania (`q[...]`); na niektórych endpointach także nieprawidłowe parametry stronicowania. #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`InternalInvoices_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` (`InternalInvoices_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` (`InternalInvoices_list.response.400.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`InternalInvoices_list.response.400.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`InternalInvoices_list.response.400.url`; string, optional) - `action_url` (`InternalInvoices_list.response.400.action_url`; string, optional) ### 401 Brak klucza API, nieprawidłowy klucz albo klucz bez wymaganego zakresu uprawnień. #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`InternalInvoices_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` (`InternalInvoices_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` (`InternalInvoices_list.response.401.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`InternalInvoices_list.response.401.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`InternalInvoices_list.response.401.url`; string, optional) - `action_url` (`InternalInvoices_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` (`InternalInvoices_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` (`InternalInvoices_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` (`InternalInvoices_list.response.402.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`InternalInvoices_list.response.402.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`InternalInvoices_list.response.402.url`; string, optional) - `action_url` (`InternalInvoices_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` (`InternalInvoices_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` (`InternalInvoices_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` (`InternalInvoices_list.response.406.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`InternalInvoices_list.response.406.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`InternalInvoices_list.response.406.url`; string, optional) - `action_url` (`InternalInvoices_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` (`InternalInvoices_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` (`InternalInvoices_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` (`InternalInvoices_list.response.423.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`InternalInvoices_list.response.423.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`InternalInvoices_list.response.423.url`; string, optional) - `action_url` (`InternalInvoices_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` (`InternalInvoices_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` (`InternalInvoices_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` (`InternalInvoices_list.response.429.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`InternalInvoices_list.response.429.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`InternalInvoices_list.response.429.url`; string, optional) - `action_url` (`InternalInvoices_list.response.429.action_url`; string, optional) Source: https://docs.niebieskiorzel.pl/api/internal-invoices-json/list/index.md