REST API · v1

Dokumentacja API

Sprawdzaj status sankcyjny kodu CN bezpośrednio w swoim systemie TMS, ERP lub aplikacji compliance. JSON over HTTPS, OpenAPI 3.1. Jeden endpoint, GET /api/v1/cn, zwraca verdict oraz pełny kontekst prawny: reżim, załącznik, artykuł, wyłączenia i link do EUR-Lex. Wyższy limit z kluczem API i webhooki ustawiamy indywidualnie, po rozmowie.

Pobierz openapi.json Plany i API

Base URL

https://restrikt.eu/api/v1
GET/cn?q=&lang=pl

Sprawdź kod CN lub nazwę towaru

Zwraca verdict (restricted albo no_match) oraz listę dopasowań. Dla kodu CN działa zasada prefiksu: wpisanie 7304 znajdzie też 7304 11 00, a pełny kod trafi w pozycję nadrzędną. Wynik no_match nie oznacza, że obrót jest dozwolony.

Parametry zapytania

ParametrWymaganyOpis
qtakKod CN (np. 7304 11 00 lub 73041100) albo fragment nazwy towaru. Spacje w kodzie są ignorowane.
langnieJęzyk nazw i etykiet: 'pl' (domyślnie) lub 'en'.

Przykład zapytania

curl "https://restrikt.eu/api/v1/cn?q=7304%2011%2000&lang=pl"

Przykład odpowiedzi

{
  "query": "7304 11 00",
  "matched_as": "cn_code",
  "verdict": "restricted",
  "has_prohibition": true,
  "results": [
    {
      "cn_code": "7304 11 00",
      "name": "Rury, przewody rurowe i profile drążone, bez szwu, z żeliwa (innego niż żeliwo odlewnicze) lub stali",
      "restriction": {
        "type": "export_ban",
        "label": "Zakaz eksportu",
        "direction": "export"
      },
      "annex": "XXIII",
      "article": "3k(1b)",
      "has_exemptions": false,
      "exemption": null,
      "valid_from": null,
      "valid_to": null,
      "regime": {
        "code": "RU_833_2014",
        "name_en": "EU sanctions against Russia",
        "name_pl": "Sankcje UE wobec Rosji",
        "legal_act": "Rozporządzenie Rady (UE) nr 833/2014",
        "eur_lex_url": "https://eur-lex.europa.eu/eli/reg/2014/833/2026-07-24/pol",
        "eur_lex_url_en": "https://eur-lex.europa.eu/eli/reg/2014/833/2026-07-24/eng",
        "eur_lex_url_pl": "https://eur-lex.europa.eu/eli/reg/2014/833/2026-07-24/pol",
        "target_country_code": "RU",
        "consolidated_version": "2026-07-24"
      },
      "source": "EUR-Lex 02014R0833-20260724",
      "source_version": "2026-07-24",
      "data_quality": "verified",
      "partial_entry": false
    }
  ],
  "cn_exists": true,
  "cn_name": "Rury przewodowe, w rodzaju stosowanych do rurociągów ropy naftowej lub gazu, bez szwu, ze stali nierdzewnej",
  "disclaimer": "Wynik ma charakter informacyjny i nie stanowi porady prawnej ani celnej. Wiążąca jest treść rozporządzenia UE oraz decyzja organów celnych. Sprawdź źródło i datę wersji.",
  "meta": {
    "returned": 1,
    "source": "sankcje-check-api/v1"
  }
}

Skrócone do jednego wyniku. Pełna odpowiedź ma też pola scope (zakres sprawdzenia), winddowns (okresy przejściowe) i derogations (podstawy odstępstw).

Limity i odpowiedzi błędów

Zapytania bez klucza są limitowane po adresie IP. Przekroczenie limitu zwraca status 429. Brak parametru q zwraca 400, błąd bazy danych zwraca 500. CORS jest włączony. Klucz API z wyższym limitem wydajemy indywidualnie, po uzgodnieniu zakresu. Nie udostępniaj klucza osobom trzecim.

API dla firm

Dziś: klucz API z wyższym limitem zapytań, webhooki o zmianach i pomoc przy wdrożeniu, ustawiane indywidualnie. W przygotowaniu: konta zespołowe i audit log. Cena indywidualna, dopasowana do skali integracji.

Zapytaj o API