Skip to main content
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 typeCovers
MaxLookalikeSearchesLookalike search runs
MaxCompanyExportsCompany list exports
MaxKeyAccountsUnlockedKey account unlocks
MaxCompanyEnrichmentsPeople search results, company enrichment criteria
MaxPeopleEnrichmentsEmail and phone enrichment
Read-only endpoints (list personas, get contacts, workflow runs, search companies) do not consume credits.

​
Cost per endpoint

EndpointCostCredit type
Search lookalikes1 credit per searchMaxLookalikeSearches
Search people1 credit per result returnedMaxCompanyEnrichments
Search companiesFree—
Enrich — emails1 credit per contactMaxPeopleEnrichments
Enrich — phones10 credits per contactMaxPeopleEnrichments
List personasFree—
Get contactsFree—
Workflow runsFree—

​
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: 
{
  "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.