The credit model

What that covers

Every endpoint, and what it costs

The free plane is not a teaser

Counting, the location tree, project types, alert configuration, and the entire analytics surface are free permanently, on paid and trial keys alike, and GET /projects/count answers even when your balance is zero. You can always see how many projects match before you page them or spend a Find Contact Info credit.

Allowances

County, State, and National each include 100,000 export records a month. The plan tier does not change that number. It changes the Find Contact Info allowance: 50 a month on a county, 200 on a state, 1,000 on National. Unused contact credits do not roll over. The export counter resets on the billing anniversary, not the calendar month. API Only includes 500 record credits per month and is not on the export cap. See plans and pricing for prices; this page is about what each counter buys.

Worked examples

A Utah county search returns 40 projects. Twelve were already delivered and have not changed. The page uses 28 export records and 0 Find Contact Info credits. Downloading that same CSV again, with nothing changed, still returns the file and uses 0 export records. GET /projects/count on the same filter uses 0 of either.

You then ask for contacts on 10 of those projects. Seven come back with an email, a phone, or a LinkedIn profile. That uses 7 Find Contact Info credits and 0 additional export records, because the projects were already delivered. The same request on 10 projects where nothing is found uses 0 contact credits.

A one-county plan and National share the same 100,000 export records. They do not share the contact allowance: the county plan has 50 Find Contact Info credits a month, the state plan 200, National 1,000. Past the export cap, the next new record is refused. Past the contact allowance, records still download; only the contact lookup is refused.

{
  "error": "export_limit_reached",
  "limit": 100000,
  "resetsAt": "2026-11-08T06:00:00Z",
  "contact": "https://boardwalkai.com/contact",
  "message": "You've used this month's 100,000 export records. They reset on November 8, 2026. For higher volume, contact us about Enterprise."
}

Reading your balance

curl 'https://api.boardwalkai.com/api/v1/account/credits' \
  -H 'Authorization: Bearer bwk_live_YOUR_KEY'

{
  "data": {
    "plan": "single_state",
    "planDisplayName": "State",
    "creditsLimit": 500,
    "creditsUsed": 200,
    "creditsRemaining": 300,
    "periodStart": "2026-08-01",
    "periodEnd": "2026-08-31",
    "resetsAt": "2026-09-01T00:00:00+00:00",
    "rateLimit": 60,
    "rateLimitPer": "minute",
    "isTeamPool": true,
    "poolUserId": 8814
  },
  "meta": {
    "requestId": "req_01K1QF3M0000EXAMPLE0001"
  }
}

Metered responses also carry X-Credits-Remaining, and meta.creditsUsed / meta.creditsRemaining on the body. Read one of those rather than keeping a local counter. The pool is shared, and someone else may be spending it.