surfpoland API v0 · unstable

A public, read-only API over federation data — organisations, affiliations, events, governance bodies, national teams, documents, statutes, meetings and published task boards. No key, no sign-up, no write endpoints.

v0 is a promise that there is no promise yet. The platform is on 0.x.x and under active development. Fields may be removed or renamed while the version reads v0. Every such change is recorded in the contract below rather than left to be discovered — but pin nothing, and expect to adjust.

Start here

Interactive reference

Every endpoint and field, browsable. Try a request in the page.

OpenAPI schema

The machine-readable contract. Generate a client from it.

The written contract

Why each field is there, and what is deliberately absent.

One request

curl https://api.surfpoland.com/api/v0/public/orgs/polski-zwiazek-surfingu

Then follow the same slug into /affiliates, /events, /bodies, /national-teams, /documents, /statute, /meetings and /tasks. List every organisation to find a slug.

Things worth knowing before you build

Every response is { data, error, meta }. error is a stable machine-readable code; the human message is in meta and may be reworded.
Organisations are addressed by slug, and a slug is permanent. Renaming one leaves the old address redirecting (301), so a link you publish keeps working.
Send back the ETag as If-None-Match and an unchanged response costs you a 304 with no body. Cross-origin calls can read it — the header is exposed.
Ask for a language with ?lang=pl or ?lang=en. meta.locale says which you actually got, which is not always the one you asked for.
Personal data is deliberately thin. People appear only inside a named governance body or team roster, never as a list of their own; there is no date of birth, no contact details and no stable per-person id. Photographs require the person's consent, and minors are shown with an abbreviated surname and no photograph at all.
Be gentle. 60 requests a minute per address, 20 on the endpoints that carry people. A 429 tells you when to come back in Retry-After.