> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Nutzungskonfiguration abrufen

> Nutzerbezogene Konfiguration der Nutzungslimits für Add-on-Credits abrufen, abgefragt nach Team-, Gruppen- oder individueller Benutzerebene für das Enterprise-Billing-Management.

<div id="overview">
  ## Überblick
</div>

Rufen Sie die aktuelle Konfiguration des Add-on-Guthabenlimits pro Benutzer:in für Ihre Organisation ab. Limits sind immer pro Benutzer:in. Wenn Sie Konfigurationen auf Team- oder Gruppenebene abfragen, gibt die Antwort das pro Benutzer:in geltende Limit zurück, das auf Benutzer:innen innerhalb dieses Teams oder dieser Gruppe angewendet wurde.

<div id="request">
  ## Anfrage
</div>

<ParamField body="service_key" type="string" required>
  Ihr Service Key mit „Billing Read“-Berechtigungen
</ParamField>

<div id="scope-configuration-choose-one">
  ### Bereichskonfiguration (eine Option auswählen)
</div>

<ParamField body="team_level" type="boolean">
  Auf `true` setzen, um das pro Benutzer geltende Limit abzurufen, das auf alle Benutzer im Team angewendet wird
</ParamField>

<ParamField body="group_id" type="string">
  Das pro Benutzer geltende Limit für alle Benutzer in einer bestimmten Gruppe abrufen, indem Sie die Gruppen-ID angeben
</ParamField>

<ParamField body="user_email" type="string">
  Die Konfiguration für einen bestimmten Benutzer abrufen, indem Sie dessen E-Mail-Adresse angeben
</ParamField>

<Info>
  Sie müssen eines von `team_level`, `group_id` oder `user_email` angeben, um den Bereich zu definieren.
</Info>

<div id="example-request-get-per-user-cap-for-all-users-on-team">
  ### Beispielanfrage – Benutzerspezifische Obergrenze für alle Teammitglieder abrufen
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "team_level": true
}' \
https://server.codeium.com/api/v1/GetUsageConfig
```

<div id="example-request-get-per-user-cap-for-all-users-in-a-group">
  ### Beispielanfrage – Limit pro Benutzer für alle Benutzer in einer Gruppe abrufen
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "group_id": "engineering_team"
}' \
https://server.codeium.com/api/v1/GetUsageConfig
```

<div id="example-request-get-user-configuration">
  ### Beispielanfrage – Benutzerkonfiguration abfragen
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "user_email": "user@example.com"
}' \
https://server.codeium.com/api/v1/GetUsageConfig
```

<div id="response">
  ## Antwort
</div>

<ResponseField name="addOnCreditCap" type="integer">
  Die konfigurierte Obergrenze für Add-on-Guthaben. Wenn dieses Feld in der Antwort nicht vorhanden ist, ist im angeforderten Geltungsbereich keine Obergrenze konfiguriert.
</ResponseField>

<div id="example-response-with-cap-configured">
  ### Beispielantwort – mit konfiguriertem Cap
</div>

```json theme={null}
{
  "addOnCreditCap": 10000
}
```

<div id="example-response-no-cap-configured">
  ### Beispielantwort – Kein Limit konfiguriert
</div>

```json theme={null}
{}
```

<div id="error-responses">
  ## Fehlerantworten
</div>

Häufige Fehlerszenarien:

* Ungültiger Service Key oder unzureichende Berechtigungen
* Mehrere Scope-Parameter angegeben
* Kein Scope-Parameter angegeben
* Ungültige Gruppen-ID oder Benutzer-E-Mail-Adresse
* Rate Limit überschritten