Skip to main content
GET
Get enrichment credit balance
Returns the enrichment credit balance of the team that owns the API key. These are the credits that email and phone lookups spend, whether you call the endpoints directly or through the MCP server.
  • Each completed lookup that finds something costs 1 credit. A not-found lookup is free.
  • A lookup is refused with 402 Payment Required when the balance is 0. The balance never goes below 0.
  • It is one balance for the whole team. It is separate from the SmartEnrich credits each member spends on dialer contact lists, which this endpoint does not report. See credits.
Call it before a bulk run so you can stop before you hit 402.

Response (200)

Authorizations

x-api-key
string
header
required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Response

The team's current balance.

balance
integer
required

Team enrichment credits remaining. Never below 0.

Required range: x >= 0
Example:

250