EuroPlaybook
Overview
EuroPlaybook public API 1.0.0
Section titled “EuroPlaybook public API 1.0.0”The EuroPlaybook public API: products and their packaging, sales, obligations, reporting periods and filing packs of ONE account, for your own tools, integrations and AI agents.
Authentication. Create an API key under Instellingen > API-sleutels and send it as
Authorization: Bearer ep_<prefix>_<secret>. The key belongs to one account; its scopes are limited by
its creator’s current role.
Conventions. Masses are integer milligrams. Lists use cursor pagination (?cursor=, next_cursor).
Send Idempotency-Key on POST/PUT to retry safely. Every response has X-Request-Id. Errors are
{"detail", "code", "params"?}; branch on code. Too many requests: 429 with Retry-After.
Gate 1 stays human. The API can propose packaging but never confirm it.
Partners (accountants, bookkeepers). A partner key epp_<prefix>_<secret> (Partner > API-sleutels)
manages the partner’s clients under /partner/.... For a client’s data send the header
EuroPlaybook-Account: <account id> on the normal endpoints (403 not_a_client unless that account is a
live client of the partner; 400 account_required without it). Per client the key is limited by the
partner’s role there (member: writes allowed, packaging stays a proposal).
Authentication
Section titled “Authentication”BearerTokenAuth
Section titled “BearerTokenAuth”Security scheme type: http
Bearer format: ep_<prefix>_<secret>