Organisation

2 Endpunkte

Organisation abrufen

get/v1/organization

Einstellungen der Organisation dieses API-Schlüssels: Name, Subdomain der Instanz, MWST, Branding, Testmodus.

Antwort 200Organization

Name	Typ	Beschreibung
`id`Pflicht	string	ID mit Präfix «org_»
`object`Pflicht	"organization"
`name`Pflicht	string
`slug`Pflicht	string	Subdomain der Instanz
`instance_url`Pflicht	string
`test_mode`Pflicht	boolean	Testmodus mit simulierten Ladepunkten und Testzahlungen
`vat_registered`Pflicht	boolean
`vat_number`Pflicht	string \| null
`vat_rate_bps`Pflicht	integer	MWST-Satz in Basispunkten (810 = 8.1 %)
`accent_color`Pflicht	string \| null

Mögliche Fehler

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Beispiel

curl -X GET https://api.ladehase.com/v1/organization \n  -H "Authorization: Bearer lh_test_…"

Antwort 200

{
  "id": "org_9c1f0b7a2e3d4c5b",
  "object": "organization",
  "name": "Hof Meier",
  "slug": "hof-meier",
  "instance_url": "https://hof-meier.ladehase.com",
  "test_mode": true,
  "vat_registered": true,
  "vat_number": "string",
  "vat_rate_bps": 0,
  "accent_color": "string"
}

Organisation ändern

patch/v1/organization

Ändert Name, Subdomain (alte Subdomain bleibt als Weiterleitung), Adresse, MWST, Akzentfarbe, Bedingungen für Fahrende oder Sichtbarkeit der Instanzseite.

Anfrage

Name	Typ	Beschreibung
`name`optional	string
`slug`optional	string
`legal_name`optional	string \| null
`street`optional	string \| null
`postal_code`optional	string \| null
`city`optional	string \| null
`country`optional	string
`contact_email`optional	string \| null
`contact_phone`optional	string \| null
`website`optional	string \| null
`vat_registered`optional	boolean
`vat_number`optional	string \| null
`vat_rate_bps`optional	integer
`accent_color`optional	string \| null
`logo_url`optional	string \| null
`welcome_text`optional	object \| null
`driver_terms`optional	object \| null
`public_page`optional	object
`test_mode`optional	boolean

Antwort 200Organization

Name	Typ	Beschreibung
`id`Pflicht	string	ID mit Präfix «org_»
`object`Pflicht	"organization"
`name`Pflicht	string
`slug`Pflicht	string	Subdomain der Instanz
`instance_url`Pflicht	string
`test_mode`Pflicht	boolean	Testmodus mit simulierten Ladepunkten und Testzahlungen
`vat_registered`Pflicht	boolean
`vat_number`Pflicht	string \| null
`vat_rate_bps`Pflicht	integer	MWST-Satz in Basispunkten (810 = 8.1 %)
`accent_color`Pflicht	string \| null

Mögliche Fehler

400 Anfrage ungültig
401 Nicht angemeldet
403 Berechtigung fehlt
404 Nicht gefunden
409 Zustand passt nicht
429 Zu viele Anfragen

Beispiel

curl -X PATCH https://api.ladehase.com/v1/organization \n  -H "Authorization: Bearer lh_test_…" \n  -H "Content-Type: application/json" \n  -d '{"name":"string","slug":"string","legal_name":"string","street":"string","postal_code":"string","city":"string","country":"string","contact_email":"person@example.ch","contact_phone":"string","website":"https://example.ch/webhooks/ladehase","vat_registered":true,"vat_number":"string","vat_rate_bps":0,"accent_color":"string","logo_url":"https://example.ch/webhooks/ladehase","welcome_text":{"de":"string","fr":"string","it":"string","en":"string"},"driver_terms":{"de":"string","fr":"string","it":"string","en":"string"},"public_page":{"showLocations":true,"showTariffs":true,"showMap":true,"showContact":true,"showOpeningHours":true},"test_mode":true}'

Antwort 200

{
  "id": "org_9c1f0b7a2e3d4c5b",
  "object": "organization",
  "name": "Hof Meier",
  "slug": "hof-meier",
  "instance_url": "https://hof-meier.ladehase.com",
  "test_mode": true,
  "vat_registered": true,
  "vat_number": "string",
  "vat_rate_bps": 0,
  "accent_color": "string"
}