Tax & Relax API

The API lets your platform's server create clients in your Tax & Relax account.

All requests go to:

https://app.taxnrelax.de/api

Every request carries your API key. Requests and responses are JSON.

Your first request

curl https://app.taxnrelax.de/api/v1/clients \
  -H "Authorization: Bearer $TAXNRELAX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7c2f4d1e-signup-4711" \
  -d '{"name": "Erika Mustermann", "email": "erika@example.com", "locale": "de"}'

The answer is 201 Created with the client as stored, including its id and Tax & Relax's own number for the client, internal_number.

What happens when you create a client

• The client is stored at once, and the answer carries it as stored.
• Creating a client sends the client nothing. Tax & Relax gets in touch with them separately.
• Every request creates a new client. Clients are not matched by name, email or client_number, so a repeated request creates a second client unless it carries the same Idempotency-Key.
• locale sets the language the client hears from Tax & Relax in: de German or en English, German if you leave it out.

Next

• Authentication: how to get and send a key.
• Idempotency: how to retry a request safely.
• Errors: what a refusal looks like.
• The Reference lists every endpoint and field. The machine-readable OpenAPI document is at /openapi.v1.json.