API dla Centralnej ewidencji pojazdów i kierowców (API do CEPiK)

Centralna Ewidencja Pojazdów i Kierowców (CEPiK) gromadzi dane o pojazdach zarejestrowanych w Polsce oraz o osobach uprawnionych do kierowania pojazdami. Skorzystaj z interfejsu programistycznego aplikacji (API), dzięki któremu uzyskasz bezpłatny dostęp do wybranych danych zgromadzonych w CEPiK.

Osoby niezaawansowane mogą korzystać z API poprzez interaktywne strony opisujące API lub poprzez różne aplikacje tworzone przez użytkowników (możesz je znaleźć m.in. na portalu dane.gov.pl). Budowa interfejsu API do CEPiK została zrealizowana w ramach projektu „Otwarte Dane – Dostęp, Standard, Edukacja” w ramach programu operacyjnego Polska Cyfrowa na lata 2014 - 2020r.

Dane z CEPiK można wykorzystywać do celów komercyjnych i niekomercyjnych.
W obu przypadkach musisz poinformować o źródle wytworzenia i pozyskania informacji.

Skorzystaj z API

Aby uzyskać dane pojazdów z bazy CEPiK wystarczy skorzystać z usługi "/pojazdy", która przyjmuje co najmniej dwa następujące parametry:

• województwo - kod teryt województwa, w którym zarejestrowany jest pojazd lub w przypadku pojazdów wyrejestrowanych był ostatnio zarejestrowany.
• data-od - data w formacie YYYYMMDD. Parametr określa datę początkową okresu pierwszej lub ostatniej rejestracji w kraju (domyślnie pierwszej), dla którego zostaną udostępnione informacje o pojazdach. Datę końca okresu możemy określić za pomocą parametru data-do.

Przykład: Jak skorzystać z usługi aby uzyskać informację o pojazdach z województwa Mazowieckiego zarejestrowanych w Polsce po raz pierwszy po 1 stycznia 2018r.: https://api.cepik.gov.pl/pojazdy?wojewodztwo=14&data-od=20180101

Wszystkie możliwe parametry usług znajdziesz w naszej dokumentacji.

Pliki: Możesz też pobrać gotowe pliki zawierające dane pojazdów w formacie CSV. Są one generowane dla każdego województwa i dostępne pod adresem: https://api.cepik.gov.pl/pliki.

• Limit wywołań:
  API ma pewne ograniczenia związane z limitem wywołań. Obecna wartość limitu to 20 wywołań na 1 sekundę, jednak nie więcej niż 100 na minutę. Jeśli przekroczysz tę ilość zostanie zwrócony błąd - w takiej sytuacji należy chwilę odczekać i zmniejszyć częstotliwość zapytań.
• Czarna lista:
  W przypadku podejrzenia ataku DDOS Twój adres IP może trafić na "czarną listę" czyli listę adresów, które są ignorowane przez API.
  Uwaga: Jeżeli potrzebujesz większych limitów lub uważasz, że niesłusznie trafiłeś na czarną listę napisz do nas. Dane kontaktowe znajdziesz niżej.

• Dokumentacja:
  Dokumentacja wraz z opisami wszystkich pól, modeli i parametrów jest dostępna pod adresem: https://api.cepik.gov.pl/doc.
• Aktualizacja danych
  Przez API udostępniana jest kopia danych CEPiK. Udostępniane dane są aktualizowane co tydzień.
  Żeby sprawdzić, z którego dnia pochodzą dane, zobacz pole dateModified w sekcji meta zwracanego komunikatu. W polu updateBase znajdziesz przewidywaną datę kolejnej aktualizacji. Możesz sprawdzić te daty przykładowo w liście pojazdów z województwa małopolskiego.

Jeśli potrzebujesz więcej informacji, masz pomysł na dalszy rozwój API lub chcesz zgłosić błąd, proszę skontaktuj się z nami pod adresem: apicepik@cyfra.gov.pl.