ImportOS · Документація
Довідник API

GET /v1/rules/{country}

Customs and registration rules in force

Customs and registration rules in force

Flat list of rule parameters (duty, VAT, excise, fees ...) effective on a date, each with sources, effective date and a verified flag. verified:false means indicative only. Requires scope read:pricing.

  • Автентифікація: заголовок Authorization: Bearer rv_live_... (API-ключі та scopes)
  • Потрібний scope: read:pricing
Опис операції, параметрів і полів походить зі специфікації OpenAPI (openapi.json) і подається англійською, як у самому API.

Параметри

ПолеДеТипОбов’язк.Опис
countrypath"UA" | "PL" | "LT" | "GE" | "DE"такDestination country (uppercase): UA, PL, LT, GE, DE.
datequerystringніRules effective on this date (yyyy-mm-dd). Default: today.

Відповіді

200

Rule parameters.

application/json · Схема: RulesResponse

ПолеТипОбов’язк.Опис
country"UA" | "PL" | "LT" | "GE" | "DE"так
versionstringтакVersion id of the rule set, e.g. "PL@2026-07-01".
currencystringтак
summarystringтак
as_ofstringтак
unverified_paramsintegerтакHow many parameters have verified:false (indicative only, not confirmed by an official source).
rowsobject[]так
rows[].pathstringні
rows[].valueanyні
rows[].verifiedbooleanні
rows[].effectiveFromstring | nullні
rows[].checkedAtstringні
rows[].sourcesobject[]ні
rows[].notestringні

400

Invalid request parameters or body (code validation_error).

application/problem+json · Схема: Problem

401

Missing, malformed, unknown, revoked or expired API key (code unauthorized).

application/problem+json · Схема: Problem

403

The API key lacks the scope required by this endpoint (code insufficient_scope).

application/problem+json · Схема: Problem

422

No rules for that country on that date.

application/problem+json · Схема: Problem

429

Rate limit exceeded for the tenant plan (code rate_limited). Wait Retry-After seconds.

application/problem+json · Схема: Problem

Приклад

curl -s "https://api.importos.app/v1/rules/PL" \
  -H "Authorization: Bearer $IMPORTOS_API_KEY"

На цій сторінці