Credits & Billing

Every metered call is charged against your workspace's credit balance. New accounts start at +25.0 credits.

What gets charged

The structural rule: only data reveals cost credits. Catalog and list_* reads, previews, sequencer sends, and ATS/CRM writes are free. Anything that returns a record you didn't have — an email, a mobile, a person or company profile, a scraped page, a job or funding signal — is charged.

See Pricing Tables for the full per-method rate card, and Pricing for how a method's price is set.

When a lookup finds nothing

A lookup that comes back empty charges 0 credits — on a waterfall, a bulk enrich, or a direct tools execute. The run still appears in your usage history, recorded as no_result with 0 credits.

Two things are charged even though they can look empty:

• A real answer that happens to be negative. An email verification returning invalid is a result — you asked whether an address was deliverable and got the answer. Only an inconclusive unknown is free.
• Methods charged per call. Where the vendor bills us for the request itself, an empty response is charged at the method's listed rate. Every enrichley, firecrawl, hyreflow_native, lusha and serper method works this way, as do most aiark, exa, icypeas and predictleads methods — their remaining methods are charged per returned record and are free on a miss. A lusha request bills a flat floor whatever it finds, so an empty one is charged 2.8 credits rather than the method's rate — a lookup that comes back with nothing costs the same whichever field it was after. hyreflow tools get <provider> <method> is the per-method answer, and dry_run shows would_charge_credits before you spend anything.

Provider reveals that run as a background job (start_* → the matching retrieval call) are charged once, on the retrieval that carries the record: starting the job is free, polling it again is free, and a job that finishes without a match costs nothing.

BYOK

Bring your own key and the call is free on Hyreflow — you pay the vendor directly, zero platform cost. Some providers (apify, apollo, atlas, builtwith, fathom, granola, heyreach, instantly, lemlist, loxo, recruit_crm, recruiterflow, sendkit, shovels, smartlead, spott, zoominfo) are BYOK-only and not resold on managed credits. Add a key with hyreflow byok set <provider> --api-key <key> — see BYOK in CLI Concepts for the full command surface. ZoomInfo uses OAuth client credentials instead of a single key, so it isn't self-serve yet — contact Hyreflow to get it enabled.

dry_run

Preview any call without charging. The response returns would_charge_credits, the function that would_call, and the resolved args/kwargs.

hyreflow tools execute prospeo email_finder --dry-run --payload '{"full_name":"Jane Doe","company_website":"acme.com"}'

Bulk enrich cost estimate

Before running enrich on a large CSV, check the worst-case cost:

hyreflow enrich --input leads.csv --estimate --with '{"alias":"email","tool":"email_enrichment"}'

The engine returns cost_estimate (max credits and USD) and can_run. Live bulk runs are blocked if the workspace balance is below the worst-case total; the response includes a Stripe checkout link so you can top up and retry.

Spending caps

Two independent caps, on different clocks and in different units:

• The 30-day workspace cap stops new charges once your rolling 30-day spend reaches a credit ceiling. Set it on the dashboard billing page or with hyreflow billing limit [--set CREDITS | --clear].
• The per-session cap pauses a single session once its own spend reaches a dollar ceiling. Set the workspace's default on the dashboard billing page's per-session cap tile, or with hyreflow billing session-limit [--set USD | --clear] — every session created afterward inherits that default as its starting cap. A running session can override its own cap up or down (hyreflow session limit --dollars N, the Playground's Session Spending Limit modal, or clearing it to remove the cap entirely) without touching the account default or any other session. Changing the account default only affects sessions created after the change.

Topping up

Purchase credits from the dashboard. Successful top-ups land in your balance and are available immediately for the next call.

Checking your balance

hyreflow billing balance

curl https://recruit.hyreflow.ai/billing/balance -H "Authorization: Bearer hf_live_xxx"

Returns the current balance plus your recent charges.