Organisations-Details abrufen

GET /api/organization

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X GET "$BASE_URL/api/organization" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Hinweise:

• Die Organisation wird automatisch aus deiner authentifizierten Session bzw. deinem API-Token abgeleitet.
• Die Legacy-Route GET /api/organizations/:organizationPublicId bleibt aus Kompatibilitätsgründen weiterhin verfügbar.
• Der plurale org-lose Alias GET /api/organizations wird ebenfalls unterstützt.
• Global Admins brauchen für die org-lose Route einen aktiven Organisationskontext in der Session.
• Abrechnungsfelder, darunter die quota*-Felder und pendingQuotaChange, sind nur für Organisations-Admins und Global Admins enthalten. Andere Mitglieder erhalten die Antwort ohne sie.

Antwort (Response)

{
  "id": 1,
  "name": "Meine Org",
  "companyName": "Meine Firma GmbH",
  "street": "Musterstr. 1",
  "postalCode": "12345",
  "city": "Berlin",
  "country": "DE",
  "vatId": "DE123456789",
  "billingEmail": "billing@deinkunde.com",
  "createdAt": "2023-01-01T00:00:00.000Z",
  "pendingQuotaChange": {
    "effectiveAt": "2026-08-01T00:00:00.000Z",
    "quotaWebsitesLimit": 25,
    "quotaSmsIncluded": 100,
    "quotaMonthlyPriceCents": 6900
  }
}

pendingQuotaChange beschreibt eine Kontingent-Reduzierung, die beauftragt wurde, aber erst zum Ende des laufenden Abrechnungszeitraums wirksam wird (AGB § 10.5). Ohne geplante Änderung ist das Feld null, der Normalfall.

Solange eine Änderung geplant ist, beschreiben die quota*-Felder der Organisation weiterhin den aktuellen, höheren Tarif, genau darum geht es in der Klausel, und abgerechnet wird die ganze Periode zu diesem Tarif. Zum Abbrechen dient Geplante Kontingent-Änderung abbrechen, zum Heraufsetzen Organisation aktualisieren.

Häufige Fehler

• 400 Organization ID is required in the authenticated session wenn aus Session/Token keine Organisation abgeleitet werden kann
• 401 Unauthorized wenn du nicht angemeldet bist
• 403 Forbidden wenn du keinen Zugriff auf die Organisation hast