REST API · v1

API-Dokumentation

Prüfen Sie den Sanktionsstatus eines KN-Codes direkt in Ihrem TMS, ERP oder Ihrer Compliance-Anwendung. JSON über HTTPS, OpenAPI 3.1. Ein einziger Endpunkt, GET /api/v1/cn, liefert das Ergebnis (verdict) und den vollständigen rechtlichen Kontext: Sanktionsregime, Anhang, Artikel, Ausnahmen und einen Link zu EUR-Lex. Ein höheres Limit mit API-Schlüssel und Webhooks richten wir individuell ein, nach Absprache.

openapi.json herunterladen Pläne und API

Base URL

https://sankcje.exportsy.pl/api/v1
GET/cn?q=&lang=pl

KN-Code oder Warenbezeichnung prüfen

Liefert das Ergebnis (restricted oder no_match) und eine Liste der Treffer. Für KN-Codes gilt eine Präfixregel: Die Eingabe 7304 findet auch 7304 11 00, und ein vollständiger Code trifft die übergeordnete Position. Das Ergebnis no_match bedeutet nicht, dass der Handel zulässig ist.

Abfrageparameter

ParameterPflichtfeldBeschreibung
qjaKN-Code (z. B. 7304 11 00 oder 73041100) oder ein Teil der Warenbezeichnung. Leerzeichen im Code werden ignoriert.
langneinSprache der Bezeichnungen und Beschriftungen: 'pl' (Standard), 'en' oder 'de'.

Beispielanfrage

curl "https://sankcje.exportsy.pl/api/v1/cn?q=7304%2011%2000&lang=de"

Beispielantwort

{
  "query": "7304 11 00",
  "matched_as": "cn_code",
  "verdict": "restricted",
  "has_prohibition": true,
  "results": [
    {
      "cn_code": "7304 11 00",
      "name": "Tubes, pipes and hollow profiles, seamless, of iron (other than cast iron) or steel",
      "restriction": {
        "type": "export_ban",
        "label": "Export ban",
        "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": "Council Regulation (EU) No 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": null,
  "disclaimer": "This result is informational only and is not legal or customs advice. The binding source is the EU regulation and the decision of customs authorities. Check the source and version date.",
  "meta": {
    "returned": 1,
    "source": "sankcje-check-api/v1"
  }
}

Auf ein Ergebnis gekürzt. Die vollständige Antwort enthält außerdem die Felder scope (was geprüft wurde), winddowns (Abwicklungsfristen) und derogations (Gründe für Ausnahmen).

Limits und Fehlerantworten

Anfragen ohne Schlüssel werden pro IP-Adresse begrenzt. Bei Überschreitung des Limits wird Status 429 zurückgegeben. Fehlt der Parameter q, lautet die Antwort 400, ein Datenbankfehler liefert 500. CORS ist aktiviert. Einen API-Schlüssel mit höherem Limit vergeben wir individuell, nach Abstimmung des Umfangs. Geben Sie den Schlüssel nicht an Dritte weiter.

API für Unternehmen

Heute: ein API-Schlüssel mit höherem Anfragelimit, Webhooks zu Änderungen und Hilfe bei der Einführung, individuell eingerichtet. In Vorbereitung: Team-Konten und ein Audit-Log. Preis nach Vereinbarung, passend zum Umfang der Integration.

API anfragen