Rejestry API → API REGON / GUS

API REGON / GUS

GET /v1/regon/{identifier}

Tożsamość, adres i PKD z rejestru REGON (GUS BIR). Dla jednoosobowych działalności, których BIR nie zwraca w komplecie, przewidziany jest fallback na CEIDG.

data: regon, nip, krs, name, entityType, active, address, pkd, endDate, provider (gus_bir albo ceidg).

Stan faktyczny: fallback CEIDG jest zaimplementowany, ale na produkcji nieaktywny — brakuje klucza do API CEIDG. Do czasu jego uzyskania provider zawsze wynosi gus_bir. Piszemy o tym wprost, bo obietnica źródła, którego nie ma, jest gorsza niż jego brak.

Kody PKD normalizujemy do jednego formatu (19.20.Z) niezależnie od tego, że GUS oddaje je jako 1920Z, a KRS z kropkami. To jeden z powodów, dla których warto brać dane przez jedno API zamiast z siedmiu.

Zanim wyślesz pierwsze zapytanie

Zasady wspólne dla wszystkich źródeł opisuje strona przeglądowa: uwierzytelnianie kluczem, koperta odpowiedzi, różnica między not_found a unavailable, rozliczenie zapytań i limity. Pełny kontrakt: /v1/openapi.json.

Uzyskaj dostęp do API →