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

# Ärzte

> Ärzte auflisten und Rezeptstatistiken über die Management API anzeigen

# Ärzte

Rufen Sie eine Liste der Ärzte in Ihrer Organisation ab und sehen Sie deren Rezeptstatistiken über einen bestimmten Zeitraum ein.

## Ärzte auflisten

```bash theme={null}
GET /v1/management/doctors
```

<ParamField query="page" type="integer" default="0">
  Seitennummer (0-indexiert)
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Anzahl der Ärzte pro Seite
</ParamField>

**Erforderliche Berechtigung:** `doctor:read`

### Beispielanfrage

```bash theme={null}
curl -X GET "https://api.rxscale.com/v1/management/doctors?page=0&limit=25" \
  -H "X-API-Key: your-api-key-here"
```

### Antwort

```json theme={null}
{
  "doctors": [
    {
      "uid": "doc-abc123",
      "display_name": "Dr. Schmidt"
    },
    {
      "uid": "doc-def456",
      "display_name": "Dr. Meier"
    }
  ],
  "total": 15,
  "totalPages": 1
}
```

## Arztstatistiken abrufen

Rufen Sie Rezeptstatistiken für einen bestimmten Arzt über einen Zeitraum ab.

```bash theme={null}
GET /v1/management/doctors/{doctor_uid}/statistics
```

<ParamField path="doctor_uid" type="string" required>
  Die Arzt-UID
</ParamField>

<ParamField query="from" type="integer" required>
  Beginn des Zeitraums (Unix-Zeitstempel in Sekunden)
</ParamField>

<ParamField query="to" type="integer" required>
  Ende des Zeitraums (Unix-Zeitstempel in Sekunden)
</ParamField>

**Erforderliche Berechtigung:** `doctor_statistics:read`

### Beispielanfrage

```bash theme={null}
curl -X GET "https://api.rxscale.com/v1/management/doctors/doc-abc123/statistics?from=1709251200&to=1711929600" \
  -H "X-API-Key: your-api-key-here"
```

### Antwort

```json theme={null}
{
  "uid": "doc-abc123",
  "display_name": "Dr. Schmidt",
  "prescription_statistics": {
    "signed": 42,
    "waiting_for_doctor": 3,
    "rejected": 1
  }
}
```

### Antwortfelder

| Feld                      | Typ    | Beschreibung                         |
| ------------------------- | ------ | ------------------------------------ |
| `uid`                     | string | Arzt-UID                             |
| `display_name`            | string | Anzeigename des Arztes               |
| `prescription_statistics` | object | Rezeptanzahlen gruppiert nach Status |

### Fehlerantworten

| Statuscode | Beschreibung                                                  |
| ---------- | ------------------------------------------------------------- |
| `400`      | Fehlende oder ungültige `from`-/`to`-Parameter                |
| `404`      | Arzt nicht gefunden oder gehört zu einer anderen Organisation |