---
title: "Organisations-Details abrufen"
description: "Gibt Details der Organisation aus deiner authentifizierten Session zurück."
---

`GET /api/organization`

## Beispiel (cURL)

```bash
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)

```json
{
  "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.

| Feld | Bedeutung |
| --- | --- |
| `effectiveAt` | Der erste Zeitpunkt, ab dem der neue Tarif gilt: bei monatlicher Abrechnung der nächste UTC-Monatsanfang, bei jährlicher das Ende der bezahlten Laufzeit. |
| `quotaWebsitesLimit` | Das Monitor-Limit, das ab dann gilt. `null` bedeutet kein Limit. |
| `quotaSmsIncluded` | Das inkludierte SMS-Kontingent, das ab dann gilt. |
| `quotaMonthlyPriceCents` | Der Monatspreis, der ab dann gilt, in Cent. |

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](/de/api/organization/cancel-pending-quota-change), zum Heraufsetzen [Organisation aktualisieren](/de/api/organization/update-organization).

## 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