Jak uzyskać token API?

Aby wygenerować nowy token API zaloguj się do systemu a następnie przejdź do menu Konto -> Tokeny API. Z tego poziomu możesz wygenerować nowy token – pamiętaj aby go skopiować i zapisać, system wyświetli go wyłącznie raz.

Mam token API, jak mogę go użyć aby autoryzować request?

System SprzęciarzOS polega na weryfikacji za pomocą Bearer Token. W tym przypadku należy dodać nagłówek Authorization do każdego żądania HTTP:

Authorization: Bearer <twój_token>

GET


                /clients.json

Lista klientów

Pozwala na pobranie paginowanej listy klientów przypisanych do Twojego konta. Obsługuje wyszukiwanie pełnotekstowe po imieniu, nazwisku, nazwie firmy i adresie e-mail. Zwraca dane kontaktowe, adresowe oraz pola niestandardowe klientów.

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`page`	string	query	Nie	Numer strony
`query`	string	query	Nie	Fraza wyszukiwania

Przykład żądania

curl -X GET --location "https://PREFIX.sprzeciarz.pl/clients.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>"

Przykład odpowiedzi 200 OK

{
  "data": [
    {
      "id": "019e4a0e-3c43-7f5c-adab-1e089e56f73d",
      "display_name": "StackWave sp. z o.o.",
      "company": true,
      "first_name": "",
      "last_name": "",
      "pesel": "",
      "company_name": "StackWave sp. z o.o.",
      "nip": "1133187570",
      "regon": "543488478",
      "krs": "0001211144",
      "email": "kontakt@stackwave.pl",
      "phone": "+48506224741",
      "website": "",
      "country": "PL",
      "city": "Warszawa",
      "postal_code": "03-707",
      "street": "Floriańska 6 / U2",
      "notes": "",
      "department_id": null,
      "custom_fields": {},
      "date_of_birth": "1996-12-18",
      "created_at": "2026-02-09 22:31",
      "updated_at": "2026-04-28 13:22"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 25
  }
}

GET


                /clients/{client_id}.json

Szczegóły klienta

Pozwala na pobranie szczegółowych danych pojedynczego klienta na podstawie jego identyfikatora. Zwraca pełny profil klienta – dane osobowe lub firmowe, kontaktowe, adresowe, pola niestandardowe oraz znaczniki czasu utworzenia i ostatniej modyfikacji.

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`client_id`	string	path	Tak	Identyfikator klienta

Przykład żądania

curl -X GET --location "https://PREFIX.sprzeciarz.pl/clients/019e4a0e-3c43-7f5c-adab-1e089e56f73d.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>"

Przykład odpowiedzi 200 OK

{
  "id": "019e4a0e-3c43-7f5c-adab-1e089e56f73d",
  "display_name": "StackWave sp. z o.o.",
  "company": true,
  "first_name": "",
  "last_name": "",
  "pesel": "",
  "company_name": "StackWave sp. z o.o.",
  "nip": "1133187570",
  "regon": "543488478",
  "krs": "0001211144",
  "email": "kontakt@stackwave.pl",
  "phone": "+48506224741",
  "website": "",
  "country": "PL",
  "city": "Warszawa",
  "postal_code": "03-707",
  "street": "Floriańska 6 / U2",
  "notes": "",
  "department_id": null,
  "custom_fields": {
    "019e4a0e-3c46-7406-988c-dea11f5545ae": ""
  },
  "date_of_birth": "1996-12-18",
  "created_at": "2026-02-09 22:31",
  "updated_at": "2026-04-28 13:22"
}

POST


                /clients.json

Tworzenie klienta

Pozwala na stworzenie klienta w ramach Twojego konta W przypadku sukcesu zwraca pełny profil utworzonego klienta. Przy błędach walidacji zwraca listę błędów.

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`company`	boolean	body	Nie	Czy klient jest firmą
`first_name`	string	body	Tak	Imię – parametr wymagany dla klientów indywidualnych
`last_name`	string	body	Tak	Nazwa firmy – parametr wymagany dla klientów profesjonalnych
`company_name`	string	body	Tak	Nazwa firmy – parametr wymagany dla klientów profesjonalnych
`email`	string	body	Nie	Adres e-mail
`date_of_birth`	string	body	Nie	Data urodzenia (YYYY-MM-DD)
`pesel`	string	body	Nie	Nr PESEL
`nip`	string	body	Nie	Numer NIP
`regon`	string	body	Nie	Numer REGON
`krs`	string	body	Nie	Numer KRS
`phone`	string	body	Nie	Nr telefonu
`website`	string	body	Nie	Adres URL strony internetowej
`country`	string	body	Nie	Kod Alfa-2 kraju (PL)
`city`	string	body	Nie	Miasto
`postal_code`	string	body	Nie	Kod pocztowy (XX-XXX)
`street`	string	body	Nie	Ulica

Przykład żądania

curl -X POST --location "https://PREFIX.sprzeciarz.pl/clients.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{
          "company": true,
          "company_name": "StackWave sp. z o.o.",
          "nip": "1133187570",
          "regon": "543488478",
          "krs": "0001211144",
          "email": "kontakt@sprzeciarz.pl",
          "country": "PL",
          "city": "Warszawa",
          "postal_code": "03-707",
          "address": "ul. Floriańska 6/U2"
        }'

Przykład odpowiedzi 201 Created

{
  "id": "019e682b-94f3-7196-bdae-99a8e7ee162a",
  "display_name": "StackWave sp. z o.o.",
  "company": true,
  "first_name": null,
  "last_name": null,
  "pesel": null,
  "company_name": "StackWave sp. z o.o.",
  "nip": "1133187570",
  "regon": "543488478",
  "krs": "0001211144",
  "email": "kontakt@sprzeciarz.pl",
  "phone": null,
  "website": null,
  "country": "PL",
  "city": "Warszawa",
  "postal_code": "03-707",
  "street": null,
  "notes": null,
  "department_id": null,
  "custom_fields": {},
  "date_of_birth": null,
  "created_at": "2026-05-27 08:42",
  "updated_at": "2026-05-27 08:42"
}

POST


                /clients/{client_id}.json

Edycja klienta

Pozwala na edycję istniejącego klienta w ramach Twojego konta W przypadku sukcesu zwraca pełny profil utworzonego klienta. Przy błędach walidacji zwraca listę błędów.

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`client_id`	string	path	Tak	Identyfikator klienta
`company`	boolean	body	Nie	Czy klient jest firmą
`first_name`	string	body	Tak	Imię – parametr wymagany dla klientów indywidualnych
`last_name`	string	body	Tak	Nazwa firmy – parametr wymagany dla klientów profesjonalnych
`company_name`	string	body	Tak	Nazwa firmy – parametr wymagany dla klientów profesjonalnych
`email`	string	body	Nie	Adres e-mail
`date_of_birth`	string	body	Nie	Data urodzenia (YYYY-MM-DD)
`pesel`	string	body	Nie	Nr PESEL
`nip`	string	body	Nie	Numer NIP
`regon`	string	body	Nie	Numer REGON
`krs`	string	body	Nie	Numer KRS
`phone`	string	body	Nie	Nr telefonu
`website`	string	body	Nie	Adres URL strony internetowej
`country`	string	body	Nie	Kod Alfa-2 kraju (PL)
`city`	string	body	Nie	Miasto
`postal_code`	string	body	Nie	Kod pocztowy (XX-XXX)
`street`	string	body	Nie	Ulica

Przykład żądania

curl -X PATCH --location "https://PREFIX.sprzeciarz.pl/clients/019e658d-af76-7a48-988c-a61651e449a4.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{
          "company_name": "StackWave sp. z o.o.",
          "nip": "1133187570",
          "address": "ul. Floriańska 6/U2"
        }'

Przykład odpowiedzi 200 OK

{
  "id": "019e682b-94f3-7196-bdae-99a8e7ee162a",
  "display_name": "StackWave sp. z o.o.",
  "company": true,
  "first_name": null,
  "last_name": null,
  "pesel": null,
  "company_name": "StackWave sp. z o.o.",
  "nip": "1133187570",
  "regon": "543488478",
  "krs": "0001211144",
  "email": "kontakt@sprzeciarz.pl",
  "phone": null,
  "website": null,
  "country": "PL",
  "city": "Warszawa",
  "postal_code": "03-707",
  "street": null,
  "notes": null,
  "department_id": null,
  "custom_fields": {},
  "date_of_birth": null,
  "created_at": "2026-05-27 08:42",
  "updated_at": "2026-05-27 08:42"
}

DELETE


                /clients/{client_id}.json

Usuwanie klienta

Pozwala na usuwanie klienta w ramach Twojego konta.

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`client_id`	string	path	Tak	Identyfikator klienta

Przykład żądania

curl -X DELETE --location "https://PREIX.sprzeciarz.pl/clients/019e658d-af76-7a48-988c-a61651e449a4.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>"

Przykład odpowiedzi 204 No Content

No Content

GET


                items.json

Lista przedmiotów

Pozwala na pobranie paginowanej listy przedmiotów przypisanych do Twojego konta. Obsługuje wyszukiwanie pełnotekstowe po nazwie oraz unikalnym identyfikatorze przedmiotu. Zwraca pełne informacje o znalezionych przedmiotach.

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`page`	integer	query	Nie	Numer strony
`query`	string	query	Nie	Fraza wyszukiwania

Przykład żądania

curl -X GET --location "https://PREFIX.sprzeciarz.pl/items.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>"

Przykład odpowiedzi 200 OK

{
  "data": [
    {
      "id": "019e4a0e-3c53-7f8b-84ac-9dcf933c2b19",
      "name": "Mercedes CLA",
      "identifier": "merc",
      "description": "",
      "tracking_mode": "unique",
      "total_quantity": 1,
      "min_reservation_quantity": null,
      "max_reservation_quantity": null,
      "department_id": null,
      "protocol_type_id": null,
      "custom_fields": {},
      "created_at": "2026-02-18 15:32",
      "updated_at": "2026-03-03 07:58"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 25
  }
}

GET


                /items/availability

Dostępność przedmiotów

Pozwala na pobranie informacji o dostępności przedmiotów

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`date_from`	string	query	Tak	Data początkowa (YYYY-MM-DD)
`date_to`	string	query	Tak	Data końcowa (YYYY-MM-DD)
`only_available`	boolean	query	Nie	Przesyłamy true aby wyświetlić wyłącznie dostępne
`query`	string	query	Nie	Fraza wyszukiwania

Przykład żądania

curl -X GET --location "https://PREFIX.sprzeciarz.pl/items/availability.json?date_from=2026-05-10&date_to=2026-05-20" \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json"

Przykład odpowiedzi 200 OK

{
  "data": [
    {
      "id": "019e4a0e-3c53-7f8b-84ac-9dcf933c2b19",
      "name": "Mercedes CLA",
      "identifier": "merc",
      "description": "",
      "tracking_mode": "unique",
      "total_quantity": 1,
      "min_reservation_quantity": null,
      "max_reservation_quantity": null,
      "department_id": null,
      "protocol_type_id": null,
      "custom_fields": {},
      "created_at": "2026-02-18 15:32",
      "updated_at": "2026-03-03 07:58",
      "available_quantity": 1
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 25
  }
}

GET


                /items/{item_id}.json

Szczegóły przedmiotu

Endpoint pozwalający na pobranie danych szczegółowych przedmiotu

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`item_id`	string	path	Tak	Identyfikator przedmiotu

Przykład żądania

curl -X GET --location "https://PREFIX.sprzeciarz.pl/items/019e4a0e-3c53-7f8b-84ac-9dcf933c2b19.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>"

Przykład odpowiedzi 200 OK

{
  "id": "019e4a0e-3c53-7f8b-84ac-9dcf933c2b19",
  "name": "Mercedes CLA",
  "identifier": "merc",
  "description": "",
  "tracking_mode": "unique",
  "total_quantity": 1,
  "min_reservation_quantity": null,
  "max_reservation_quantity": null,
  "department_id": null,
  "protocol_type_id": null,
  "custom_fields": {},
  "created_at": "2026-02-18 15:32",
  "updated_at": "2026-03-03 07:58"
}

POST


                /items.json

Tworzenie przedmiotu

Endpoint pozwala na stworzenie nowego klienta w systemie

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`name`	string	body	Tak	Nazwa przedmiotu
`tracking_mode`	string	body	Tak	Metoda śledzenia – dostępne wartości `unique`, `quantity` oraz `serialized`
`identifier`	string	body	Tak	Identyfikator przedmiotu – wymagany tylko gdy `tracking_mode == unique`
`total_quantity`	string	body	Tak	Ilość – wymagany tylko gdy `tracking_mode == quantity`
`protocol_type_id`	string	body	Nie	Identyfikator typu protokołu
`department_id`	string	body	Nie	Identyfikator działu
`description`	string	body	Nie	Opis

Przykład żądania

curl -X POST --location "https://PREFIX.sprzeciarz.pl/items.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{
          "name": "Audi A6",
          "tracking_mode": "unique",
          "identifier": "ERA 75TM",
          "description": "Doskonałe auto na weekend"
        }'

Przykład odpowiedzi 200

{
  "id": "019e6839-4201-7da8-8d72-1d22cd7e4db3",
  "name": "Audi A6",
  "identifier": "ERA 75TM",
  "description": "Doskonałe auto na weekend",
  "tracking_mode": "unique",
  "total_quantity": 1,
  "min_reservation_quantity": null,
  "max_reservation_quantity": null,
  "department_id": null,
  "protocol_type_id": null,
  "custom_fields": {},
  "created_at": "2026-05-27 08:57",
  "updated_at": "2026-05-27 08:57"
}

PATCH


                /items/{item_id}.json

Edycja przedmiotu

Endpoint pozwala na edycję istniejącego przedmiotu w systemie

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`item_id`	string	path	Tak	Identyfikator przedmiotu
`name`	string	body	Nie	Nazwa przedmiotu
`tracking_mode`	string	body	Nie	Metoda śledzenia – dostępne wartości `unique`, `quantity` oraz `serialized`
`identifier`	string	body	Nie	Identyfikator przedmiotu – wymagany tylko gdy `tracking_mode == unique`
`total_quantity`	string	body	Nie	Ilość – wymagany tylko gdy `tracking_mode == quantity`
`protocol_type_id`	string	body	Nie	Identyfikator typu protokołu
`department_id`	string	body	Nie	Identyfikator działu
`description`	string	body	Nie	Opis

Przykład żądania

curl -X PATCH --location "https://PREFIX.sprzeciarz.pl/items/019e6809-9184-77d9-81de-530d8c6ff890.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>" \
    -d '{
          "name": "Audi A6",
          "identifier": "ERA 76TM",
          "description": "Doskonałe auto dla każdego"
        }'

Przykład odpowiedzi 200

{
  "id": "019e6839-4201-7da8-8d72-1d22cd7e4db3",
  "name": "Audi A6",
  "identifier": "ERA 76TM",
  "description": "Doskonałe auto dla każdego",
  "tracking_mode": "unique",
  "total_quantity": 1,
  "min_reservation_quantity": null,
  "max_reservation_quantity": null,
  "department_id": null,
  "protocol_type_id": null,
  "custom_fields": {},
  "created_at": "2026-05-27 08:57",
  "updated_at": "2026-05-27 08:58"
}

DELETE


                /items/{item_id}.json

Usuwanie przedmiotu

Endpoint pozwalający na usuwanie przedmiotu z systemu

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`item_id`	string	path	Tak	Identyfikator przedmiotu

Przykład żądania

curl -X DELETE --location "https://PREFIX.sprzeciarz.pl/items/019e4a0e-3c53-7f8b-84ac-9dcf933c2b19.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>"

Przykład odpowiedzi 204 No Content

No Content

GET


                /reservations

Lista rezerwacji

Endpoint pozwala na pobranie listy rezerwacji

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`page`	integer	query	Nie	Numer strony

Przykład żądania

curl -X GET --location "https://PREFIX.sprzeciarz.pl/reservations.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>"

Przykład odpowiedzi 200 OK

{
  "data": [
    {
      "id": "019e4c35-231b-7978-b08f-ab6c39de4c76",
      "number": "REZ-2026-05-0001",
      "total_price_gross": "1230.0",
      "total_price_net": "1000.0",
      "deposit": "500.0",
      "tax_rate": "23.0",
      "pickup_location": "ul. Topolowa 13",
      "return_location": "ul. Krakowska 11",
      "notes": "Możliwy zwrot brudnego auta",
      "internal_notes": "Dobry klient",
      "starts_at": "2026-05-22 22:23",
      "ends_at": "2026-05-29 22:23",
      "created_at": "2026-05-21 22:23",
      "updated_at": "2026-05-21 22:23",
      "status": {
        "id": "019e4a0e-3c74-7caa-8537-e926bbb45998",
        "name": "Nowa",
        "color": "#3B82F6",
        "blocking": true
      },
      "client": {
        "id": "019e4a0e-3c43-7f0d-80a3-28fe077f77f6",
        "first_name": "Adam",
        "last_name": "Nowak",
        "email": "",
        "phone": ""
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 7,
    "per_page": 25
  }
}

GET


                /reservations/{reservation_id}.json

Szczegóły rezerwacji

Endpoint pozwalający na pobranie informacji o konkretnej rezerwacji

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`reservation_id`	string	path	Tak	Identyfikator rezerwacji

Przykład żądania

curl -X GET --location "https://PREFIX.sprzeciarz.pl/reservations/019e4c35-231b-7978-b08f-ab6c39de4c76.json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <token>"

Przykład odpowiedzi 200 OK

{
  "id": "019e4c35-231b-7978-b08f-ab6c39de4c76",
  "number": "REZ-2026-05-0001",
  "total_price_gross": "0.0",
  "total_price_net": "0.0",
  "deposit": "0.0",
  "tax_rate": "23.0",
  "pickup_location": "",
  "return_location": "",
  "notes": null,
  "internal_notes": null,
  "starts_at": "2026-05-22 22:23",
  "ends_at": "2026-05-29 22:23",
  "created_at": "2026-05-21 22:23",
  "updated_at": "2026-05-21 22:23",
  "status": {
    "id": "019e4a0e-3c74-7caa-8537-e926bbb45998",
    "name": "Nowa",
    "color": "#3B82F6",
    "blocking": false
  },
  "client": {
    "id": "019e4a0e-3c43-7f0d-80a3-28fe077f77f6",
    "first_name": "Adam",
    "last_name": "Nowak",
    "email": "",
    "phone": "",
    "company_name": "",
    "company": false,
    "nip": "",
    "street": "",
    "city": "",
    "postal_code": "",
    "country": "PL"
  },
  "pickup_department": {
    "id": "019e4a0e-3c4a-7aeb-8c59-e24fa0fc415c",
    "name": "Kraków"
  },
  "return_department": {
    "id": "019e4a0e-3c4a-7aeb-8c59-e24fa0fc415c",
    "name": "Kraków"
  },
  "reservation_items": [
    {
      "id": "019e4c35-231f-78a0-8bfe-336a0a28a2e3",
      "quantity": 1,
      "unit_price_gross": "0.0",
      "unit_price_net": "0.0",
      "total_price_gross": "0.0",
      "total_price_net": "0.0",
      "tax_rate": "23.0",
      "discount_kind": "",
      "discount_percent": "0.0",
      "item": {
        "id": "019e4a0e-3c53-7f35-8cc4-770fe749df4a",
        "name": "Audi A6 C5"
      }
    }
  ],
  "payments": []
}

POST


                /reservations.json

Tworzenie rezerwacji

Pozwala na stworzenie rezerwacji w ramach Twojego konta W przypadku sukcesu zwraca pełne dane utworzonej rezerwacji. Przy błędach walidacji zwraca listę błędów.

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`status_id`	string	body	Tak	Identyfikator statusu
`starts_at`	string	body	Tak	Data i godzina rozpoczęcia (YYYY-MM-DD HH:MM)
`ends_at`	string	body	Nie	Data i godzina zakończenia (YYYY-MM-DD HH:MM)
`pickup_department_id`	string	body	Nie	Identyfikator oddziału wydania
`return_department_id`	string	body	Nie	Identyfikator oddziału zwrotu
`client_company`	boolean	body	Nie	Informacja czy klient jest firmą
`client_first_name`	string	body	Nie	Imię klienta
`client_last_name`	string	body	Nie	Nazwisko klienta
`client_street`	string	body	Nie	Adres klienta
`client_city`	string	body	Nie	Miasto klienta
`client_postal_code`	string	body	Nie	Kod pocztowy klienta
`client_country`	string	body	Nie	Kod kraju klienta
`client_email`	string	body	Nie	Adres e-mail klienta
`client_phone`	string	body	Nie	Numer telefonu klienta
`notes`	string	body	Nie	Notatki do rezerwacji
`internal_notes`	string	body	Nie	Notatka wewnętrzna do rezerwacji
`reservation_items_attributes`	array	body	Tak	Lista pozycji rezerwacji. Każdy element zawiera pola opisane poniżej (`[]`)
`reservation_items_attributes[].item_id`	string	body	Tak	Identyfikator przedmiotu
`reservation_items_attributes[].unit_price_net`	number	body	Tak	Kwota netto za każdy dzień/godzinę
`reservation_items_attributes[].billing_unit`	string	body	Nie	Jednostka rozliczeniowa `day` lub `hour`

Przykład żądania

curl -X POST --location "https://PREFIX.sprzeciarz.pl/reservations.json" \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -d '{
          "status_id": "019e4a0e-3c74-7caa-8537-e926bbb45998",
          "starts_at": "2026-06-01 10:00",
          "ends_at": "2026-06-08 10:00",
          "pickup_department_id": "019e4a0e-3c4a-7aeb-8c59-e24fa0fc415c",
          "return_department_id": "019e4a0e-3c4a-7aeb-8c59-e24fa0fc415c",
          "client_company": false,
          "client_first_name": "Jan",
          "client_last_name": "Kowalski",
          "client_street": "Topolowa 11",
          "client_city": "Kraków",
          "client_postal_code": "30-001",
          "client_country": "PL",
          "client_email": "jan@test.pl",
          "reservation_items_attributes": [
            {
              "item_id": "019e4a0e-3c53-7f35-8cc4-770fe749df4a",
              "billing_unit": "day",
              "unit_price_net": 100
            }
          ]
        }'

Przykład odpowiedzi 201 Created

{
  "id": "019e6a40-98e8-75d5-a4d9-9694ba545df0",
  "number": "REZ-2026-05-0004",
  "total_price_gross": "861.0",
  "total_price_net": "700.0",
  "deposit": "0.0",
  "tax_rate": "23.0",
  "pickup_location": null,
  "return_location": null,
  "notes": null,
  "internal_notes": null,
  "starts_at": "2026-06-01 10:00",
  "ends_at": "2026-06-08 10:00",
  "created_at": "2026-05-27 18:24",
  "updated_at": "2026-05-27 18:24",
  "status": {
    "id": "019e4a0e-3c74-7caa-8537-e926bbb45998",
    "name": "Nowa",
    "color": "#3B82F6",
    "blocking": false
  },
  "client": {
    "id": "019e6a38-b6f1-76a0-be1c-13bdb4baebe8",
    "first_name": "Jan",
    "last_name": "Kowalski",
    "email": "jan@test.pl",
    "phone": null,
    "company_name": null,
    "company": false,
    "nip": null,
    "street": "Topolowa 11",
    "city": "Kraków",
    "postal_code": "30-001",
    "country": "PL"
  },
  "pickup_department": {
    "id": "019e4a0e-3c4a-7aeb-8c59-e24fa0fc415c",
    "name": "Kraków"
  },
  "return_department": {
    "id": "019e4a0e-3c4a-7aeb-8c59-e24fa0fc415c",
    "name": "Kraków"
  },
  "reservation_items": [
    {
      "id": "019e6a40-98ee-73ad-92d0-61635c6f3921",
      "quantity": 1,
      "unit_price_gross": "123.0",
      "unit_price_net": "100.0",
      "total_price_gross": "861.0",
      "total_price_net": "700.0",
      "tax_rate": "23.0",
      "discount_kind": null,
      "discount_percent": "0.0",
      "item": {
        "id": "019e4a0e-3c53-7f35-8cc4-770fe749df4a",
        "name": "Audi A6 C5"
      }
    }
  ],
  "payments": []
}

PATCH


                /reservations/{reservation_id}.json

Edycja rezerwacji

Pozwala na edycję istniejącej rezerwacji w ramach Twojego konta W przypadku sukcesu zwraca pełne dane utworzonej rezerwacji. Przy błędach walidacji zwraca listę błędów.

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`reservation_id`	string	path	Tak	Identyfikator rezerwacji
`status_id`	string	body	Tak	Identyfikator statusu
`starts_at`	string	body	Tak	Data i godzina rozpoczęcia (YYYY-MM-DD HH:MM)
`ends_at`	string	body	Nie	Data i godzina zakończenia (YYYY-MM-DD HH:MM)
`pickup_department_id`	string	body	Nie	Identyfikator oddziału wydania
`return_department_id`	string	body	Nie	Identyfikator oddziału zwrotu
`client_company`	boolean	body	Nie	Informacja czy klient jest firmą
`client_first_name`	string	body	Nie	Imię klienta
`client_last_name`	string	body	Nie	Nazwisko klienta
`client_street`	string	body	Nie	Adres klienta
`client_city`	string	body	Nie	Miasto klienta
`client_postal_code`	string	body	Nie	Kod pocztowy klienta
`client_country`	string	body	Nie	Kod kraju klienta
`client_email`	string	body	Nie	Adres e-mail klienta
`client_phone`	string	body	Nie	Numer telefonu klienta
`notes`	string	body	Nie	Notatki do rezerwacji
`internal_notes`	string	body	Nie	Notatka wewnętrzna do rezerwacji
`reservation_items_attributes`	array	body	Tak	Lista pozycji rezerwacji. Każdy element zawiera pola opisane poniżej (`[]`)
`reservation_items_attributes[].item_id`	string	body	Tak	Identyfikator przedmiotu
`reservation_items_attributes[].unit_price_net`	number	body	Tak	Kwota netto za każdy dzień/godzinę
`reservation_items_attributes[].billing_unit`	string	body	Nie	Jednostka rozliczeniowa `day` lub `hour`
`reservation_items_attributes[].id`	string	body	Nie	Identyfikator pozycji
`reservation_items_attributes[]._destroy`	boolean	body	Nie	Przesyłany z wartością `tru` tylko jeśli usuwamy pozycję

Przykład żądania

curl -X PATCH --location "https://PREFIX.sprzeciarz.pl/reservations/019e6a47-be88-7864-ac31-6686ba3ee19e.json" \
    -H "Authorization: Bearer sk_DppSgqx8QVUyTrjEkW1JerdE3MaiW81W" \
    -H "Content-Type: application/json" \
    -d '{
          "starts_at": "2026-06-01 10:00",
          "ends_at": "2026-06-02 10:00",
          "client_company": false,
          "client_first_name": "Jan",
          "client_last_name": "Kowalski",
          "client_street": "Topolowa 11",
          "client_city": "Kraków",
          "client_postal_code": "30-001",
          "client_country": "PL",
          "client_email": "jan@test.pl",
          "reservation_items_attributes": [
            {
              "id": "019e6a4e-ce38-7db4-be03-3e3beaf8b699",
              "_destroy": true
            },
            {
              "item_id": "019e4a0e-3c53-7f94-9bc4-a3e52a190fc6",
              "unit_price_net": 100
            }
          ]
        }'

Przykład odpowiedzi 200 OK

{
  "id": "019e6a47-be88-7864-ac31-6686ba3ee19e",
  "number": "REZ-2026-05-0005",
  "total_price_gross": "123.0",
  "total_price_net": "100.0",
  "deposit": "0.0",
  "tax_rate": "23.0",
  "pickup_location": "",
  "return_location": "",
  "notes": null,
  "internal_notes": null,
  "starts_at": "2026-06-01 10:00",
  "ends_at": "2026-06-02 10:00",
  "created_at": "2026-05-27 18:32",
  "updated_at": "2026-05-27 18:40",
  "status": {
    "id": "019e4a0e-3c74-7caa-8537-e926bbb45998",
    "name": "Nowa",
    "color": "#3B82F6",
    "blocking": false
  },
  "client": {
    "id": "019e6a38-b6f1-76a0-be1c-13bdb4baebe8",
    "first_name": "Jan",
    "last_name": "Kowalski",
    "email": "jan@test.pl",
    "phone": null,
    "company_name": null,
    "company": false,
    "nip": null,
    "street": "Topolowa 11",
    "city": "Kraków",
    "postal_code": "30-001",
    "country": "PL"
  },
  "pickup_department": {
    "id": "019e4a0e-3c4a-7aeb-8c59-e24fa0fc415c",
    "name": "Kraków"
  },
  "return_department": {
    "id": "019e4a0e-3c4a-7aeb-8c59-e24fa0fc415c",
    "name": "Kraków"
  },
  "reservation_items": [
    {
      "id": "019e6a4f-51be-7aaa-b9a0-976538725972",
      "quantity": 1,
      "unit_price_gross": "123.0",
      "unit_price_net": "100.0",
      "total_price_gross": "123.0",
      "total_price_net": "100.0",
      "tax_rate": "23.0",
      "discount_kind": null,
      "discount_percent": "0.0",
      "item": {
        "id": "019e4a0e-3c53-7f94-9bc4-a3e52a190fc6",
        "name": "Volkswagen Tiguan"
      }
    }
  ],
  "payments": []
}

DELETE


                /reservations/{reservation_id}.json

Usuwanie rezerwacji

Pozwala na usuwanie istniejącej rezerwacji z systemu

Parametry

Nazwa	Typ	Lokalizacja	Wymagany	Opis
`reservation_id`	string	path	Tak	Identyfikator rezerwacji

Przykład żądania

curl -X DELETE --location "https://PREFIX.sprzeciarz.dev/reservations/019e6a47-be88-7864-ac31-6686ba3ee19e.json" \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json"

Przykład odpowiedzi 204 No Content

No Content

Dokumentacja API

Lista klientów

Parametry

Szczegóły klienta

Parametry

Tworzenie klienta

Parametry

Edycja klienta

Parametry

Usuwanie klienta

Parametry

Lista przedmiotów

Parametry

Dostępność przedmiotów

Parametry

Szczegóły przedmiotu

Parametry

Tworzenie przedmiotu

Parametry

Edycja przedmiotu

Parametry

Usuwanie przedmiotu

Parametry

Lista rezerwacji

Parametry

Szczegóły rezerwacji

Parametry

Tworzenie rezerwacji

Parametry

Edycja rezerwacji

Parametry

Usuwanie rezerwacji

Parametry

Masz pytania?

Email