--- title: "Pobierz listę deklaracji VAT" description: "Zakres: `api:accounting:read`. Deklaracje VAT-7, od najnowszego okresu. Pliki JPK V7 zwraca `GET /saf_v7_files`." --- > 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 › Podatek VAT `GET /vat_taxes.json` Zakres: `api:accounting:read`. Deklaracje VAT-7, od najnowszego okresu. Pliki JPK V7 zwraca `GET /saf_v7_files`. ## Authentication Requires one of the following: - `ApiKey`, apiKey, in header, header `X-inFakt-ApiKey` - `Token`, apiKey, in header, header `X-Token` ## Query parameters - `page` (`VatDeclarations_list.query.page`; integer, optional) — Numer strony liczony od 1; ignorowany, gdy wysłany jest `offset`. - format `int32`; default `1` - `per_page` (`VatDeclarations_list.query.per_page`; integer, optional) — Liczba wyników na stronę przy `page`. Serwer jej nie ogranicza. - format `int32`; default `10` - `offset` (`VatDeclarations_list.query.offset`; integer, optional) — Indeks pierwszego wyniku (liczba pomijanych encji). - format `int32` - `limit` (`VatDeclarations_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` (`VatDeclarations_list.query.pagination_without_total`; boolean, optional) — Pomiń liczenie; `metainfo.total_count` przyjmuje wartość `null`. - `fields` (`VatDeclarations_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` (`VatDeclarations_list.query.order`; string, optional) — Sortowanie: `` albo ` desc`, gdzie `` to pole elementu listy, np. `payment_date desc`. Unikaj pól, które mogą być `null` lub nie występują w części elementów. ## Header parameters - `X-inFakt-ApiVersion` (`VatDeclarations_list.header.X-inFakt-ApiVersion`; string, optional) — `3.1` zwraca status deklaracji `sent` zamiast `printed`. - one of `"3.1"` ## Code samples ### cURL ```bash curl --request GET \ --url https://api.sandbox-infakt.pl/v3/vat_taxes.json \ --header 'X-inFakt-ApiKey: ' ``` ### TypeScript ```typescript const url = 'https://api.sandbox-infakt.pl/v3/vat_taxes.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/vat_taxes.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/vat_taxes.json?offset=10&limit=10", "previous": "https://api.infakt.pl/v3/vat_taxes.json?offset=0&limit=10" }, "entities": [ { "id": 1, "symbol": "VAT-7", "period": "2020-09-01", "period_name": "Wrzesień 2020", "period_type": "M", "correction_counter": 0, "payment_date": "2020-10-26", "vat_on_sale_price": 230000, "vat_on_purchases_price": 46000, "overpaid_price": 0, "tax_to_pay_price": 184000, "status": "paid", "real_pay_vat": 184000 } ] } ``` - `metainfo` (`VatDeclarations_list.response.200.metainfo`; object, required) - `count` (`VatDeclarations_list.response.200.metainfo.count`; integer, required) — Liczba encji na tej stronie. - format `int32` - `total_count` (`VatDeclarations_list.response.200.metainfo.total_count`; any of, required) — Liczba pasujących encji; `null`, gdy `pagination_without_total=true`. - any of: `integer`, `null` - `next` (`VatDeclarations_list.response.200.metainfo.next`; string, required) — Bezwzględny URL następnej strony w postaci `offset`/`limit`. - `previous` (`VatDeclarations_list.response.200.metainfo.previous`; string, required) — Bezwzględny URL poprzedniej strony w postaci `offset`/`limit`. - `entities` (`VatDeclarations_list.response.200.entities`; array, required) - `id` (`VatDeclarations_list.response.200.entities.id`; integer, required) - format `int64` - `symbol` (`VatDeclarations_list.response.200.entities.symbol`; string, required) — `PIT-5` (skala podatkowa), `PIT-5L` (podatek liniowy), `PPE` (ryczałt), `VAT-7`, `VAT-7K`, `VAT-UE` lub `VAT-UEK` (korekta). - `period` (`VatDeclarations_list.response.200.entities.period`; string, required) — Pierwszy dzień okresu. - format `date` - `period_name` (`VatDeclarations_list.response.200.entities.period_name`; string, required) - `period_type` (`VatDeclarations_list.response.200.entities.period_type`; string, required) — Miesięczny (`M`) lub kwartalny (`Q`). - `correction_counter` (`VatDeclarations_list.response.200.entities.correction_counter`; integer, required) - format `int32` - `payment_date` (`VatDeclarations_list.response.200.entities.payment_date`; string, required) - format `date` - `status` (`VatDeclarations_list.response.200.entities.status`; string, required) — Status deklaracji: `draft`, `printed`, `sent` lub `paid`. `sent` jest zwracany tylko z nagłówkiem `X-inFakt-ApiVersion: 3.1`, w przeciwnym razie jako `printed`. - `vat_on_sale_price` (`VatDeclarations_list.response.200.entities.vat_on_sale_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `vat_on_purchases_price` (`VatDeclarations_list.response.200.entities.vat_on_purchases_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `overpaid_price` (`VatDeclarations_list.response.200.entities.overpaid_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `tax_to_pay_price` (`VatDeclarations_list.response.200.entities.tax_to_pay_price`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` - `real_pay_vat` (`VatDeclarations_list.response.200.entities.real_pay_vat`; integer, required) — Kwota w groszach (1/100 PLN). `12300` oznacza 123,00 PLN. - format `int64` ### 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` (`VatDeclarations_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` (`VatDeclarations_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` (`VatDeclarations_list.response.401.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`VatDeclarations_list.response.401.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`VatDeclarations_list.response.401.url`; string, optional) - `action_url` (`VatDeclarations_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` (`VatDeclarations_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` (`VatDeclarations_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` (`VatDeclarations_list.response.402.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`VatDeclarations_list.response.402.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`VatDeclarations_list.response.402.url`; string, optional) - `action_url` (`VatDeclarations_list.response.402.action_url`; string, optional) ### 403 Brak uprawnień, limit planu dla tej akcji (`limit`) albo zawieszone konto. #### Example ```json { "error": "Zasób którego szukasz nie został znaleziony." } ``` - `error` (`VatDeclarations_list.response.403.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` (`VatDeclarations_list.response.403.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` (`VatDeclarations_list.response.403.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`VatDeclarations_list.response.403.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`VatDeclarations_list.response.403.url`; string, optional) - `action_url` (`VatDeclarations_list.response.403.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` (`VatDeclarations_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` (`VatDeclarations_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` (`VatDeclarations_list.response.406.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`VatDeclarations_list.response.406.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`VatDeclarations_list.response.406.url`; string, optional) - `action_url` (`VatDeclarations_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` (`VatDeclarations_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` (`VatDeclarations_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` (`VatDeclarations_list.response.423.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`VatDeclarations_list.response.423.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`VatDeclarations_list.response.423.url`; string, optional) - `action_url` (`VatDeclarations_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` (`VatDeclarations_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` (`VatDeclarations_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` (`VatDeclarations_list.response.429.limit`; string, optional) — Kod limitu planu, np. `limit_exceeded`, `plan_upgrade_needed`, `cant_add_client`. - `type` (`VatDeclarations_list.response.429.type`; string, optional) - one of `"redirect"`, `"email_not_confirmed"` - `url` (`VatDeclarations_list.response.429.url`; string, optional) - `action_url` (`VatDeclarations_list.response.429.action_url`; string, optional) Source: https://docs.niebieskiorzel.pl/api/vat-taxes-json/list/index.md