# Mitglieder

> Ihre Artists und Labels: auflisten und neue einladen.

<!-- Generated from openapi/hills-v1.json by scripts/api-reference.mjs. Edit the operation in hills-music (server/lib/ops), not this page. -->

Ihre Artists und Labels: auflisten und neue einladen.

Basis-URL `https://api.hillsmusic.com/v1`. Jede Anfrage sendet einen API-Schlüssel: `Authorization: Bearer hm_live_…`.

- Artists und Labels auflisten
- Artist oder Label einladen

<a id="list-artists-and-labels"></a>

## Artists und Labels auflisten

`GET /v1/members` · Scope: `members:read`

Alle Artists und Labels unter Ihrem Konto, die neuesten zuerst, jeweils mit der Anzahl ihrer Releases.

### Parameter

| Parameter | Ort | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- | --- |
| `kind` | query | `artist` \| `label` | Nein | Nur Artists oder nur Labels. |

### Beispielanfrage

```bash
curl "https://api.hillsmusic.com/v1/members?kind=artist" \
  -H "Authorization: Bearer $HILLS_API_KEY"
```

### Antwort `200`

```json
{
  "data": [
    {
      "id": 41,
      "email": "luna@example.com",
      "name": "Luna",
      "kind": "artist",
      "status": "active",
      "created_at": "2026-08-02T10:11:00Z",
      "last_login_at": null,
      "releases": 4
    }
  ]
}
```

### Fehler

| Status | Wann |
| --- | --- |
| 400 | invalid: Ein Parameter ist fehlerhaft; field nennt ihn. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired oder test_keys_retired. |
| 403 | insufficient_scope: Dem Schlüssel fehlt der Scope; scope nennt ihn. account_inactive oder api_not_in_plan. |
| 429 | rate_limited: Retry-After Sekunden warten. |

<a id="invite-an-artist-or-label"></a>

## Artist oder Label einladen

`POST /v1/members/invite` · Scope: `members:write`

Legt das Konto unter Ihrem an und sendet per E-Mail einen Link (7 Tage gültig) zum Festlegen des Passworts. 409, wenn es für die E-Mail-Adresse bereits ein Konto gibt.

### Request-Body

JSON.

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `email` | string | Ja | Die E-Mail-Adresse. |
| `fname` | string | Ja | Vorname oder Name des Labels. |
| `lname` | string | Nein | Nachname. |
| `kind` | `artist` \| `label` | Ja | Artist oder Label. |

### Beispielanfrage

```bash
curl -X POST "https://api.hillsmusic.com/v1/members/invite" \
  -H "Authorization: Bearer $HILLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"luna@example.com","fname":"Luna","kind":"artist"}'
```

### Antwort `201`

```json
{
  "ok": true,
  "id": 57
}
```

### Fehler

| Status | Wann |
| --- | --- |
| 400 | invalid: Ein Parameter ist fehlerhaft; field nennt ihn. |
| 401 | unauthenticated, invalid_key, key_revoked, key_expired oder test_keys_retired. |
| 403 | insufficient_scope: Dem Schlüssel fehlt der Scope; scope nennt ihn. account_inactive oder api_not_in_plan. |
| 409 | exists: Für diese E-Mail-Adresse gibt es bereits ein Konto. |
| 429 | rate_limited: Retry-After Sekunden warten. |

Quelle: https://developer.hillsmusic.com/de/reference/members/