# E-Parcel Dispatcher API

> Parcel shipping inside Finland through one synchronous REST call: send a
> parcel, get back the carrier's tracking number and a printable PDF label.
> JSON over HTTPS, authenticated with a bearer API key.

Develop and test against https://api-test.e-parcel.fi. Production,
https://api.e-parcel.fi, creates real, billable shipments — never run tests
against it. Read the integration guide before writing code: it holds the rules
an integration must follow (idempotency keys, units, contact details, error
handling).

## Docs

- [Integration guide for AI agents](https://api-test.e-parcel.fi/agents/integration-guide.md): golden rules, field mapping, outcome handling, idempotency, reference clients in Python and TypeScript, test plan, definition of done
- [API reference](https://api-test.e-parcel.fi/agents/api-reference.md): every endpoint, field, limit and error body
- [Everything in one file](https://api-test.e-parcel.fi/llms-full.txt): the guide and the reference concatenated

## Machine-readable

- [OpenAPI schema](https://api-test.e-parcel.fi/openapi.json): generate typed clients from it
- [Interactive docs](https://api-test.e-parcel.fi/docs): Swagger UI

## Optional

- [Claude skill](https://api-test.e-parcel.fi/agents/e-parcel-api.zip): the guide and reference packaged as a Claude skill — unzip into `.claude/skills/` for Claude Code, or upload in Claude's skill settings