Rejestry API → KRS API

KRS API

GET /v1/krs/{identifier}

Odpis z Krajowego Rejestru Sądowego (Ministerstwo Sprawiedliwości).

Parametr Gdzie Opis
identifier ścieżka NIP, KRS albo REGON. Most NIP→KRS robimy po swojej stronie (przez GUS, bez zużywania limitu MF).
scope query aktualny (domyślnie) albo pelny — odpis pełny zawiera historię wpisów.
fresh query true pomija cache. Koszt ×3.
certificate query true wystawia certyfikat zapytania.

Zawartość data: krs, nip, regon, name, legalForm, register, address, contact, pkd, shareCapital, representation, flags, registrationDate, lastEntryDate, lastFinancialStatement.

Przykład: podmiotu nie ma w rejestrze

{
  "status": "not_found",
  "subject": { "nip": null, "regon": null, "krs": "1132998955",
               "countryCode": "PL", "resolvedVia": "direct" },
  "data": null,
  "meta": { "cache": { "hit": false }, "stale": false, "billed": 1 },
  "timestamps": { "validAsOf": null },
  "warnings": []
}

Uwaga na krótkie numery KRS. Numer KRS ma 10 cyfr z wiodącymi zerami. /v1/krs/123 zostanie uzupełnione do 0000000123 i zwróci istniejącą spółkę — to poprawne zachowanie rejestru, nie błąd. Jeśli przekazujesz dane od użytkownika, waliduj po swojej stronie, czym one są.

Limity: MS nie publikuje limitów ani SLA dla API KRS. Przyjęliśmy własny ostrożny sufit 2000 zapytań na dobę i go mierzymy.

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 →