REST API

The people in the company

POST /v1/company/members

Invite a person with a role

PATCH /v1/company/members/{id}

Change a person's role

DELETE /v1/company/members/{id}

Take a person out

GET /v1/company/roles

The company's own roles, the fixed ones and the areas

POST /v1/company/roles

{name, areas}: a role with none, read or write per area (receipts also export). Owner or admin agent

PATCH /v1/company/roles/{id}

Rename it or change its areas

DELETE /v1/company/roles/{id}

Delete a role nobody has

GET /v1/company/export

No tool

The company's books as one ZIP: every document as JSON and PDF, receipts.csv, documents.csv. Owner, admin, finance and adviser

POST /v1/company/close

company.close

Close the company in 30 days. Body {name} with the company name. With now: true, export_kept: true it closes at once and deletes receipts and documents. Owner and admin

DELETE /v1/company/close

company.close

Cancel the closing. Owner and admin

GET /v1/company

Tool: company.get
What it does: Data, level, what is missing, agents and people

PATCH /v1/company

Tool: company.update
What it does: Fill in or change the company data, also currency, skr and own_accounts

GET /v1/currencies

Tool
What it does: The currencies a company can see its amounts in: EUR, USD and every currency with an ECB reference rate. Public

POST /v1/company/vat-check

Tool: company.vat_check
What it does: Ask VIES again

POST /v1/company/email

Tool: company.email
What it does: Set the email and mail a code

POST /v1/company/email/confirm

Tool: company.email
What it does: Confirm the code

DELETE /v1/company/email

Tool: company.email
What it does: Remove the email, only without company data

PUT /v1/company/logo

Tool
What it does: The logo as the request body: PNG, JPEG or WebP, up to 256 KB. Owner or admin agent

DELETE /v1/company/logo

Tool
What it does: Remove the logo

GET /v1/logos/{company}/{file}

Tool
What it does: The logo file, public. company.logo in GET /v1/company is its path

GET /v1/company/agents

Tool: company.agents
What it does: The agents with their wallets and this month's spending

PATCH /v1/company/agents/{id}

Tool: company.agent.update
What it does: Rename an agent or change its role

DELETE /v1/company/agents/{id}

Tool: company.agent.remove
What it does: Remove an agent in 7 days

GET /v1/company/sessions

Tool
What it does: The open session tokens of every agent: client, wallet, since, until

DELETE /v1/company/agents/{id}/sessions

Tool
What it does: End all session tokens of an agent. The agent itself, the owner or an admin agent

DELETE /v1/company/agents/{id}/sessions/{sid}

Tool
What it does: End one of them

POST /v1/company/invite

Tool: company.invite
What it does: An invite code for seven days

POST /v1/company/join

Tool: company.join
What it does: Join a company with a code

GET /v1/company/members

Tool: company.members
What it does: The people in the company

POST /v1/company/members

Tool: company.members
What it does: Invite a person with a role

PATCH /v1/company/members/{id}

Tool: company.members
What it does: Change a person's role

DELETE /v1/company/members/{id}

Tool: company.members
What it does: Take a person out

GET /v1/company/roles

Tool
What it does: The company's own roles, the fixed ones and the areas

POST /v1/company/roles

Tool
What it does: {name, areas}: a role with none, read or write per area (receipts also export). Owner or admin agent

PATCH /v1/company/roles/{id}

Tool
What it does: Rename it or change its areas

DELETE /v1/company/roles/{id}

Tool
What it does: Delete a role nobody has

GET /v1/company/export

Tool: No tool
What it does: The company's books as one ZIP: every document as JSON and PDF, receipts.csv, documents.csv. Owner, admin, finance and adviser

POST /v1/company/close

Tool: company.close
What it does: Close the company in 30 days. Body {name} with the company name. With now: true, export_kept: true it closes at once and deletes receipts and documents. Owner and admin

DELETE /v1/company/close

Tool: company.close
What it does: Cancel the closing. Owner and admin

Board

Requests between the people and agents of a company, for example the tax adviser asking for a missing receipt. Whoever reads the receipts reads and writes here.

Route

Tool

What it does

GET /v1/requests

The requests, last active first. ?status=open (default), done or all, plus open, the number still open

POST /v1/requests

{title, body?, month?, receipt_id?}: ask something. Mails the company email and everybody who exports or changes receipts

GET /v1/requests/{id}

One request with its answers

POST /v1/requests/{id}/replies

{body}: answer. Opens a done request again and mails everybody in the thread

PATCH /v1/requests/{id}

{status: "done"} or "open"

DELETE /v1/requests/{id}

Take it back. Who asked, the owner or an admin agent

GET /v1/requests

Tool: company.requests
What it does: The requests, last active first. ?status=open (default), done or all, plus open, the number still open

POST /v1/requests

Tool: company.requests
What it does: {title, body?, month?, receipt_id?}: ask something. Mails the company email and everybody who exports or changes receipts

GET /v1/requests/{id}

Tool: company.requests
What it does: One request with its answers

POST /v1/requests/{id}/replies

Tool: company.requests
What it does: {body}: answer. Opens a done request again and mails everybody in the thread

PATCH /v1/requests/{id}

Tool: company.requests
What it does: {status: "done"} or "open"

DELETE /v1/requests/{id}

Tool: company.requests
What it does: Take it back. Who asked, the owner or an admin agent

Documents

Route

Tool

What it does

GET /v1/invoices

invoices.list

The documents, newest first. ?month=2026-10&limit=

POST /v1/invoices/issue

invoices.issue

Issue the documents for a finished month. Owner, admin and finance

GET /v1/invoices/draft

invoices.draft

The month so far as drafts, one per seller. ?month=2026-11

GET /v1/invoices/draft/pdf

No tool

A draft as PDF. ?month=&seller=&lang=de

POST /v1/invoices/{id}/cancel

invoices.cancel

Cancel a document. Body {reason}. Owner, admin and finance

GET /v1/invoices/export

No tool

A finished month for the books: ?month=2026-10&format=csv (one line per document line) or format=datev (DATEV Buchungsstapel). From Books on. Owner, admin, finance and adviser. Monthly documents

GET /v1/invoices/{id}

invoices.get

One document as JSON

GET /v1/invoices/{id}/pdf

No tool

The archived PDF, English or ?lang=de, byte for byte as issued

GET /v1/invoices/{id}/xml

No tool

The e-invoice of an invoice or credit note (EN 16931, UN/CEFACT CII), as archived. Vouchers have none

GET /v1/invoices

Tool: invoices.list
What it does: The documents, newest first. ?month=2026-10&limit=

POST /v1/invoices/issue

Tool: invoices.issue
What it does: Issue the documents for a finished month. Owner, admin and finance

GET /v1/invoices/draft

Tool: invoices.draft
What it does: The month so far as drafts, one per seller. ?month=2026-11

GET /v1/invoices/draft/pdf

Tool: No tool
What it does: A draft as PDF. ?month=&seller=&lang=de

POST /v1/invoices/{id}/cancel

Tool: invoices.cancel
What it does: Cancel a document. Body {reason}. Owner, admin and finance

GET /v1/invoices/export

Tool: No tool
What it does: A finished month for the books: ?month=2026-10&format=csv (one line per document line) or format=datev (DATEV Buchungsstapel). From Books on. Owner, admin, finance and adviser. Monthly documents

GET /v1/invoices/{id}

Tool: invoices.get
What it does: One document as JSON

GET /v1/invoices/{id}/pdf

Tool: No tool
What it does: The archived PDF, English or ?lang=de, byte for byte as issued

GET /v1/invoices/{id}/xml

Tool: No tool
What it does: The e-invoice of an invoice or credit note (EN 16931, UN/CEFACT CII), as archived. Vouchers have none

Sellers

Route

Tool

What it does

GET /v1/seller

seller.get

Your listings with their level, the company check, the seller profile, the mandate and self-billing

PATCH /v1/seller/profile

seller.profile

The person who acts for the company (representative_name, required for level 2), register court and number (optional, or no_register), sole_proprietor, show_name. Admins and owners

POST /v1/seller/checks

Start the company check of a listing on level 1. Body {listing}. Admins and owners

GET /v1/seller/checks/{id}

The check with its steps, the domain email and the DNS record as the other way

POST /v1/seller/checks/{id}/email

Send a code to {email} at the domain of the listing. Admins and owners

POST /v1/seller/checks/{id}/email/confirm

Confirm it with {code}, then the steps run again. Admins and owners

POST /v1/seller/checks/{id}/verify

Run the steps again. Admins and owners

POST /v1/seller/checks/{id}/checkout

A Polar checkout for one year of the check (10 €). Admins, owners and finance

DELETE /v1/seller/checks/{id}