# Credits (https://webmetic.de/docs/api/datenmodell/credits)

`GET /contacts/credits` gibt dieses Objekt zurück. Ein Beispiel: Bevor Ihr Workflow die E-Mail-Adresse der Vertriebsleitung von Bergquell Mineralbrunnen freischaltet, prüft er hier, ob Ihre Credits reichen.

Die Zahl `balance` gilt für Ihr ganzes Konto, und das Dashboard zeigt sie im Fenster **Credits** unter **Verfügbare Credits**.

[Credits in der API](https://webmetic.de/docs/api/credits) beschreibt, welche Aufrufe Credits kosten. Woher Credits stammen und wie Sie weitere kaufen, steht unter [Credits](https://webmetic.de/docs/credits).

## Abruf [#abruf]

Der Abruf ist kostenlos, ändert Ihre Credits nicht und braucht weder einen bestimmten Plan noch eingerichtete Ansprechpartner.

Sie brauchen den Schlüssel **Visitor Intelligence**, den Admins unter [**Menü** > **Integrationen** > **API**](https://app.webmetic.de/?menu=api_details) finden. Die Schlüssel für Enrichment und Data Layer funktionieren hier nicht.

```bash tab="cURL" tab-group="lang"
curl "https://hub.webmetic.de/contacts/credits" \
  -H "Authorization: wmtc_IHR_API_SCHLUESSEL"
```

```js tab="JavaScript" tab-group="lang"
const res = await fetch('https://hub.webmetic.de/contacts/credits', {
  headers: { Authorization: 'wmtc_IHR_API_SCHLUESSEL' },
});
const credits = await res.json();
```

```python tab="Python" tab-group="lang"
import requests

res = requests.get(
    "https://hub.webmetic.de/contacts/credits",
    headers={"Authorization": "wmtc_IHR_API_SCHLUESSEL"},
)
credits = res.json()
```

## Felder [#felder]

Beide Felder sind immer vorhanden und nie `null`, und `costs` enthält immer dieselben vier Felder.

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `balance` | `integer` | Wie viele Credits Ihr Konto gerade hat |
| `costs` | `object` | Kosten je Aktion in Credits, für alle Konten gleich |
| `costs.search` | `integer` | Suche nach Ansprechpartnern. Die Suche ist derzeit kostenlos |
| `costs.email` | `integer` | Freischalten der E-Mail-Adresse, mit dem LinkedIn-Profil, wenn eines vorliegt |
| `costs.phone` | `integer` | Freischalten der Rufnummern |
| `costs.email_phone` | `integer` | Freischalten von E-Mail und Telefon in einem Aufruf. Die Summe aus `costs.email` und `costs.phone` |

## Regeln [#regeln]

Für die Werte gelten diese Regeln:

- **Ganze Zahl**: `balance` ist immer eine ganze Zahl und nie negativ.
- **Keine Credits**: Wenn Ihr Konto noch nie Credits erhalten oder alle verbraucht hat, ist `balance` gleich `0`, und das ist kein Fehler. Ihr Konto erhält den Willkommensbonus erst, wenn Sie die Ansprechpartner einrichten.
- **Kein Verfall**: Credits verfallen nicht, und Webmetic setzt sie nicht monatlich zurück. Die monatlichen Credits von Starter und Growth kommen zu den vorhandenen hinzu.
- **Ein Wert**: `balance` trennt nicht nach Herkunft wie Willkommensbonus, Plan oder Kauf. Die API gibt keinen Verlauf der verbrauchten Credits aus.
- **Listenwerte**: `costs` zeigt, was ein neues Freischalten kostet. Schon freigeschaltete Daten und Datenarten, die Webmetic nicht liefert, kosten nichts. Was ein Aufruf abgebucht hat, steht in `credits_used` seiner Antwort, wie unter [Contact](https://webmetic.de/docs/api/datenmodell/contact) beschrieben.
- **Zu wenig Credits**: Wenn Ihre Credits nicht reichen, antworten `/contacts/reveal` und `/contacts/find` mit Status `402` und dem Code `INSUFFICIENT_CREDITS`. `detail.available` im Fehler hat denselben Wert wie `balance`, und `detail.required` nennt die Credits für die Aktion. Mehr dazu unter [Fehler](https://webmetic.de/docs/api/fehler).

## Verwendet von [#verwendet-von]

- **Endpunkt**: [`GET /contacts/credits`](https://webmetic.de/docs/api/referenz/contacts/credits)
- **Antworten**: `credits_remaining` in [`/contacts/search`](https://webmetic.de/docs/api/referenz/contacts/search), [`/contacts/reveal`](https://webmetic.de/docs/api/referenz/contacts/reveal) und [`/contacts/find`](https://webmetic.de/docs/api/referenz/contacts/find), derselbe Wert wie `balance` nach dem Aufruf
- **KI-Assistent**: Auch der [KI-Assistent](https://webmetic.de/docs/ki-assistent/tools-und-prompts) nutzt mit dem Tool `reveal_contact` dieselben Credits