API Reference

Settings

View and update your restaurant configuration including business details, tax identifiers, address, and TSE information. All endpoints require admin privileges.

Get Settings

Retrieve the full restaurant configuration, including business details, legal information, address, contact data, and TSE configuration.

GET/api/settingsAdmin Only

Returns the full restaurant configuration.

bash

curl https://api.possfer.com/api/settings \
  -H "Authorization: Bearer <token>"

json

{
  __PH0__: "550e8400-e29b-41d4-a716-446655440000",
  __PH2__: "Mein Restaurant",
  __PH4__: "Mein Restaurant GmbH",
  __PH6__: "123/456/78901",
  __PH8__: "DE123456789",
  __PH10__: "Hauptstrasse",
  __PH12__: "42",
  __PH14__: "10115",
  __PH16__: "Berlin",
  __PH18__: "+49 30 12345678",
  __PH20__: "info@mein-restaurant.de",
  __PH22__: "EUR",
  __PH24__: "Europe/Berlin",
  __PH26__: "tse-abc123",
  __PH28__: "e8a12b...",
  __PH30__: "production",
  __PH32__: "2026-03-15T12:00:00Z"
}

Update Settings

Partially update restaurant settings. Only provided fields will be modified — omitted fields remain unchanged. TSE fields, currency, and timezone cannot be updated through this endpoint.

PUT/api/settingsAdmin Only

Partial update of restaurant settings.

Request Body

Name	Type	Required	Description
`name`	`string`	Optional	Display name of the restaurant.
`legal_name`	`string`	Optional	Legal business name (for receipts and tax documents).
`tax_id`	`string`	Optional	German Steuernummer (tax identification number).
`street`	`string`	Optional	Street name of the business address.
`house_number`	`string`	Optional	House number of the business address.
`postal_code`	`string`	Optional	Postal code (PLZ).
`city`	`string`	Optional	City name.
`phone`	`string`	Optional	Business phone number.
`email`	`string`	Optional	Business email address.

bash

curl -X PUT https://api.possfer.com/api/settings \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Gasthaus zum Adler",
    "phone": "+49 30 98765432",
    "street": "Berliner Strasse",
    "house_number": "15"
  }'

json

{
  __PH0__: "550e8400-e29b-41d4-a716-446655440000",
  __PH2__: "Gasthaus zum Adler",
  __PH4__: "Mein Restaurant GmbH",
  __PH6__: "123/456/78901",
  __PH8__: "DE123456789",
  __PH10__: "Berliner Strasse",
  __PH12__: "15",
  __PH14__: "10115",
  __PH16__: "Berlin",
  __PH18__: "+49 30 98765432",
  __PH20__: "info@mein-restaurant.de",
  __PH22__: "EUR",
  __PH24__: "Europe/Berlin",
  __PH26__: "tse-abc123",
  __PH28__: "e8a12b...",
  __PH30__: "production",
  __PH32__: "2026-03-20T16:45:00Z"
}