easyVerein API (v2.0)

Quick start

• Base URL: - Auth header: Authorization: Bearer - Tokens expire after 30 days; refresh via GET /api/v2.0/refresh-token when tokenRefreshNeeded appears in response headers. - Rate limit: **100 requests/min**. ## Use the OpenAPI spec Read the full spec when you need endpoint details or schemas: - references/openapi-v2.json This file contains **all endpoints**, parameters, request bodies, responses, and tags. Use it to: - list endpoints by tag (e.g., member, contact-details, invoice) - inspect request body schemas - find actions and sub-endpoints ## Common patterns - Pagination: ?limit= (default 5, max 100) - Field selection: ?query={field,relation{subfield}} - Excluding fields: ?query={-field} - Bulk operations: bulk-create / bulk-update (supported by select endpoints) ## Example cURL (template) __CODE_BLOCK_0__ ## Member creation flow (important) 1) Create contact-details first. 2) Then create member with emailOrUserName and contactDetails reference. ## Notes - Files must be uploaded via **PATCH** with Content-Disposition header. - Use refresh-token` to rotate tokens; old token becomes invalid immediately.