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.
- Authentication: header
Authorization: Bearer rv_live_...(API keys and scopes) - Required scope:
read:pricing
openapi.json).Parameters
| Field | In | Type | Required | Description |
|---|---|---|---|---|
country | path | "UA" | "PL" | "LT" | "GE" | "DE" | yes | Destination country (uppercase): UA, PL, LT, GE, DE. |
date | query | string | no | Rules effective on this date (yyyy-mm-dd). Default: today. |
Responses
200
Rule parameters.
application/json · Schema: RulesResponse
| Field | Type | Required | Description |
|---|---|---|---|
country | "UA" | "PL" | "LT" | "GE" | "DE" | yes | |
version | string | yes | Version id of the rule set, e.g. "PL@2026-07-01". |
currency | string | yes | |
summary | string | yes | |
as_of | string | yes | |
unverified_params | integer | yes | How many parameters have verified:false (indicative only, not confirmed by an official source). |
rows | object[] | yes | |
rows[].path | string | no | |
rows[].value | any | no | |
rows[].verified | boolean | no | |
rows[].effectiveFrom | string | null | no | |
rows[].checkedAt | string | no | |
rows[].sources | object[] | no | |
rows[].note | string | no |
400
Invalid request parameters or body (code validation_error).
application/problem+json · Schema: Problem
401
Missing, malformed, unknown, revoked or expired API key (code unauthorized).
application/problem+json · Schema: Problem
403
The API key lacks the scope required by this endpoint (code insufficient_scope).
application/problem+json · Schema: Problem
422
No rules for that country on that date.
application/problem+json · Schema: Problem
429
Rate limit exceeded for the tenant plan (code rate_limited). Wait Retry-After seconds.
application/problem+json · Schema: Problem
Example
curl -s "https://api.importos.app/v1/rules/PL" \
-H "Authorization: Bearer $IMPORTOS_API_KEY"