Credit Costs

A call costs the entity base rate per record returned, plus the rate of any premium, indicator or enrichment field you explicitly ask for. Standard fields add nothing.

How it works

Every call deducts (base rate for the entity + the rate of each premium / indicator / enrichment field you requested) × the number of records returned. Standard fields are covered by the base rate.
`fields` shrinks the payload, not the bill — dropping standard fields changes nothing. It only lowers cost when the field you drop is a premium / indicator / enrichment one. Omit `fields` entirely and you pay the base rate alone.
Aggregated endpoints (stats, trend, delta, top-by, pivot, points, market-report), search and reports are billed per CALL at a flat rate, not per record. The exact amount is echoed in `meta.creditCost` on every response.
Contacts and owners are Enterprise-only: parcel contacts (and expand=contacts), contact requests, contact enrichment, the owners entity and its aggregations are refused on other plans with a 403 whose details.code is TIER_REQUIRED. Everything else is open to every plan, billed at the credit cost below; your monthly credit allowance is what differs between plans.
Premium fields (AI descriptions, AVM valuation, enrichment) typically cost more than standard fields.
Contact enrichment (POST /v1/enrichment/contacts) is billed the contacts_enriched price only when it unlocks someone your organization did not already hold — a no-match or a repeat lookup costs 0. Contact requests (POST /v1/contacts/requests) are billed the contacts price per newly unlocked contact.

How it works

Every call deducts (base rate for the entity + the rate of each premium / indicator / enrichment field you requested) × the number of records returned. Standard fields are covered by the base rate.

`fields` shrinks the payload, not the bill — dropping standard fields changes nothing. It only lowers cost when the field you drop is a premium / indicator / enrichment one. Omit `fields` entirely and you pay the base rate alone.

Aggregated endpoints (stats, trend, delta, top-by, pivot, points, market-report), search and reports are billed per CALL at a flat rate, not per record. The exact amount is echoed in `meta.creditCost` on every response.

Contacts and owners are Enterprise-only: parcel contacts (and expand=contacts), contact requests, contact enrichment, the owners entity and its aggregations are refused on other plans with a 403 whose details.code is TIER_REQUIRED. Everything else is open to every plan, billed at the credit cost below; your monthly credit allowance is what differs between plans.

Premium fields (AI descriptions, AVM valuation, enrichment) typically cost more than standard fields.

Contact enrichment (POST /v1/enrichment/contacts) is billed the contacts_enriched price only when it unlocks someone your organization did not already hold — a no-match or a repeat lookup costs 0. Contact requests (POST /v1/contacts/requests) are billed the contacts price per newly unlocked contact.