Credits and billing
Prepaid credits, billed per answered request. What counts as billable, and how to control spend.
Verify is paid for with prepaid credits. There are no plans, seats or minimums, and every new account starts with free credits. Rates for each endpoint are on the pricing page.
What's billed
Every answered request is billed; errors and refused requests are free. Concretely, a request is billed when the API answers with HTTP 200:
| Answer | Billed |
|---|---|
Parse 200, including a parse with warnings or an empty line | Yes |
Lookup 200 with any status: matched, matched_building, ambiguous, no_situs_parcel, not_found | Yes |
Lookup by ID 200 (active or superseded) | Yes |
Lookup by ID 404 not_found | No |
Any 4xx or 5xx error, including 402 and 403 refusals | No |
Requests from the portal's Verify page (the Playground) are billed the same way as API requests.
To spend less per address, store the fieldgeist_id from a lookup and refresh the parcel later with Look up by ID, which costs less than a new lookup.
Credits
- One balance per team. Everyone on a team draws from the same credits. Owners and Admins manage billing.
- Add credits by card in the portal's Billing page, $5 to $5,000 at a time. Payments are processed by Stripe.
- Credits don't expire while your team exists. Purchased credits aren't refundable except as the refund policy describes.
- The sign-up credits are given once per person.
Auto recharge
Optional. When the balance falls below a threshold you set, the team's saved card is charged the amount you set. The threshold is at least $5, and the amount is at least the threshold and at most $5,000. If a charge is declined, auto recharge pauses until you update the card.
Budgets and alerts
- Monthly budget: caps a calendar month's spend (UTC). When the month's spend reaches it, requests are refused with
402 budget_exceededuntil you raise or remove it. - Spend alert: an email to the team's Owners and Admins when the month's spend reaches an amount you choose, below the budget.
When the balance runs out
At zero, requests are refused with 402 insufficient_credit instead of running up a balance. Add credits and they resume within minutes. Refused requests show in Logs and aren't billed.
Track spend
- Usage shows requests and spend by hour and day, kept for 13 months.
- Logs shows each request for 30 days, with its status, outcome and request ID.
- Billing shows the balance, payments and the month's spend.