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

# Credits

> How TAMTAM API calls consume credits.

Most TAMTAM API endpoints consume **credits** from your account balance. Your account has separate credit lines depending on your subscription plan — each credit line covers a specific category of actions.

## Credit lines

Depending on your plan, credits are organized into the following credit types:

| Credit type              | Covers                                             |
| ------------------------ | -------------------------------------------------- |
| `MaxLookalikeSearches`   | Lookalike search runs                              |
| `MaxCompanyExports`      | Company list exports                               |
| `MaxKeyAccountsUnlocked` | Key account unlocks                                |
| `MaxCompanyEnrichments`  | People search results, company enrichment criteria |
| `MaxPeopleEnrichments`   | Email and phone enrichment                         |

Read-only endpoints (list personas, get contacts, workflow runs, search companies) do not consume credits.

## Cost per endpoint

| Endpoint          | Cost                         | Credit type             |
| ----------------- | ---------------------------- | ----------------------- |
| Search lookalikes | 1 credit per search          | `MaxLookalikeSearches`  |
| Search people     | 1 credit per result returned | `MaxCompanyEnrichments` |
| Search companies  | Free                         | —                       |
| Enrich — emails   | 1 credit per contact         | `MaxPeopleEnrichments`  |
| Enrich — phones   | 10 credits per contact       | `MaxPeopleEnrichments`  |
| List personas     | Free                         | —                       |
| Get contacts      | Free                         | —                       |
| Workflow runs     | Free                         | —                       |

## How credits are consumed

For **search endpoints**, credits are deducted after the results are returned — you are charged per result, not per request.

For **enrichment endpoints**, credits are **reserved** when you submit the request and **confirmed** once enrichment completes. If enrichment fails for a contact, the reserved credits are released back to your balance.

## Checking your balance

Use the `GET /api/v2/credits` endpoint to check your remaining credits across all active credit lines:

```json theme={null}
{
  "credits": [
    {
      "credit_type": "MaxLookalikeSearches",
      "used_credits": 105,
      "total_credits": 100000,
      "remaining_credits": 99895
    },
    {
      "credit_type": "MaxCompanyEnrichments",
      "used_credits": 30390,
      "total_credits": 229000,
      "remaining_credits": 198610
    },
    {
      "credit_type": "MaxPeopleEnrichments",
      "used_credits": 1036,
      "total_credits": 20500,
      "remaining_credits": 19464
    }
  ]
}
```

## Running out of credits

When a credit line is exhausted, requests to endpoints consuming that credit type will return a **402** response. Contact your TAMTAM account manager to top up your credits.