Get Credit Balance - OpenFunnel

GET

/

api

/

v1

/

credits

/

balance

Get credit balance

curl -sS "https://api.openfunnel.dev/api/v1/credits/balance" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "total_credits": 200,
  "credits_used": 37.5,
  "credits_left": 162.5
}

Headers

X-API-Key

string

required

Response

200 - application/json

Successful Response

Your account's credit balance

total_credits

number

required

The credit allowance for your billing account.

credits_used

number

required

Credits consumed

credits_left

number

required

Remaining credits

Tech Intent Search ResultsPoll a tech intent-search job and page through its results. Submit a job first via **`POST /api/v2/tech/companies/intent-search`** ("Search Companies by Tech Stack with Intent", under Company Search), which returns a `job_id`. <Info>**No API key yet?** [Sign up via Agent Auth](/agent-primitives/authentication) to get your `X-API-Key` - the only required header for this endpoint.</Info> This single endpoint returns both the job `status` (`pending` → `running` → `completed` / `failed`), a `manifest` summary once complete, **and** one page of result `rows`. Walk pages by passing the returned `next_cursor` as `?cursor=`. **Check `status` for completion - not `next_cursor`.** A still-running job can return a null `next_cursor` simply because later pages haven't been written yet; only `status: "completed"` means the full result set is available. Each row is a company hit (same shape as Search Companies By Tech Stack, with firmographics when enrichment ran) plus an `intent` block: the verified `activity`, an LLM `reason` quoting the exact posting phrases that support the verdict, and the `qualified_job` itself. The manifest also reports `companies_scanned` vs `companies_qualified` so you can see how selective your activity was. No credits are charged for polling - the job's credits are billed once, when it completes.

⌘I

Get credit balance

curl -sS "https://api.openfunnel.dev/api/v1/credits/balance" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "total_credits": 200,
  "credits_used": 37.5,
  "credits_left": 162.5
}