← SweKit API

Documentation

Base URL: https://swekit-api.erikssonanton2001.workers.dev · JSON only · CORS enabled · GET (and POST with JSON body for the same parameters).

Conventions

Access & limits

Anonymous demo: 20 requests/min/IP. Higher limits: send X-API-Key: <license key> (600 req/min). Marketplace subscribers use the marketplace's own key and quota. A "Pro" listing is being set up; until it is live, contact the operator via the repository issues.

MCP server

Remote MCP endpoint https://swekit-api.erikssonanton2001.workers.dev/mcp (POST JSON-RPC 2.0: initialize, tools/list, tools/call). Tools: validate_personnummer, validate_orgnr, validate_bankgiro, validate_plusgiro, validate_ocr, generate_ocr, swedish_account_to_iban, validate_iban, lookup_clearing_number, swedish_holidays, swedish_date_info, add_business_days, count_business_days.

Semantics worth knowing

Endpoints

GET /v1/personnummer

Validate & parse a Swedish personnummer / samordningsnummer

valuestringPersonnummer in any common format (YYMMDD-NNNC, YYYYMMDDNNNC, with + for 100+). Prefer POST JSON {"value": "..."} so the number never appears in a URL.
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/personnummer?value=811218-9876&at=2026-10-16"

GET /v1/orgnr

Validate organisationsnummer, derive legal form and Swedish VAT number (SE#########01)

valuestringOrg no. like 556036-0793, 5560360793, SE556036079301
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/orgnr?value=556036-0793"

GET /v1/bankgiro

Validate bankgiro number (Luhn) and format it

valuestring7-8 digits, with or without dash
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/bankgiro?value=5402-9681"

GET /v1/plusgiro

Validate plusgiro number

valuestring2-8 digits
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/plusgiro?value=4-8"

GET /v1/ocr/validate

Validate an OCR / payment reference (Luhn check digit, optional length digit)

valuestringOCR digits
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/ocr/validate?value=12351"

GET /v1/ocr/generate

Generate an OCR reference from a base number

basestringDigits, e.g. invoice number
length_digitbooleanAdd length digit (default false)
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/ocr/generate?base=123&length_digit=true"

GET /v1/account

Validate a Swedish bank account (clearing + account, per Bankgirot rules) and convert to IBAN

numberstringFull account digits (clearing first), OR
clearingstringClearing number (4 digits; 5 for Swedbank 8xxx)
accountstringAccount number without clearing
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/account?clearing=7507&account=1211203"

GET /v1/iban

Validate any IBAN (ISO 13616 mod-97, country length) and identify Swedish banks

valuestringIBAN, spaces allowed
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/iban?value=SE45 5000 0000 0583 9825 7466"

GET /v1/bic

Validate BIC/SWIFT format

valuestring8 or 11 characters
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/bic?value=ESSESESS"

GET /v1/clearing

Look up bank, BIC, IBAN id and account type for a clearing number

valuestringFirst 4 digits of the account number
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/clearing?value=8327"

GET /v1/holidays

Swedish public holidays and eves for a year

yearinteger1900-2200 (default: current year)
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/holidays?year=2026"

GET /v1/date

Info about a date: weekday (sv/en), ISO week, holiday names, business-day status

datestringYYYY-MM-DD
modestring"bank" (default; midsommarafton, julafton, nyårsafton also excluded) or "work"
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/date?date=2026-12-24"

GET /v1/business-days/add

Add (or subtract) N business days to a date

datestringYYYY-MM-DD
daysintegerPositive or negative, |n| <= 3650
modestringbank (default) or work
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/business-days/add?date=2026-12-22&days=2"

GET /v1/business-days/between

Count business days between two dates

fromstringYYYY-MM-DD
tostringYYYY-MM-DD
modestringbank (default) or work
curl "https://swekit-api.erikssonanton2001.workers.dev/v1/business-days/between?from=2026-10-16&to=2026-11-16"

Data sources