All endpoints and their cost
Every endpoint on the surface, with what it charges, in one table.
Generated from the same map the biller reads, so the cost stated here is the cost charged. The interactive reference at /docs/api/reference/ carries the full request and response schemas. The raw OpenAPI document is at https://api.boardwalkai.com/api/reference.json (also mirrored on the docs host as /api/reference.json).
Billable — 1 credit per project unlocked
| Method | Path | Cost | Notes |
|---|---|---|---|
| POST | /enrichments | 1 credit / project unlocked | County, State, and National: 1 credit per project the first time this account receives email or phone for it. Standalone API Only: included on records this pool has already purchased — unpurchased ids are skipped as notPurchased. A live free trial spends the separate 5-lookup grant (not the 50 record-export credits). Empty lookups cost nothing. Credits are charged when the job delivers contacts, not when it is queued. |
Free — 0 credits
| Method | Path | Cost | Notes |
|---|---|---|---|
| GET | /account/credits | Free | Free. Your balance, your plan, your rate limit and your enrichment allowance. |
| GET | /account/preferences | Free | Free. The account's saved search preferences (types, geography, website). |
| PATCH | /account/preferences | Free | Free. Update the account's saved search preferences. |
| GET | /alerts | Free | Free. Configuring alerts never costs credits; only delivered records do. |
| POST | /alerts | Free | Free. |
| GET | /alerts/{alertId} | Free | Free. |
| PATCH | /alerts/{alertId} | Free | Free. |
| DELETE | /alerts/{alertId} | Free | Free. |
| GET | /alerts/{alertId}/deliveries | Free | Free. The delivery history and what each run charged. |
| GET | /alerts/{alertId}/deliveries/{deliveryId} | Free | Free. |
| POST | /alerts/{alertId}/dismissals/{projectId} | Free | Free. Dismissing a match stops it being re-offered. |
| DELETE | /alerts/{alertId}/dismissals/{projectId} | Free | Free. |
| GET | /alerts/{alertId}/matches | Free | Free, every time. Omit deliveryId to read every match except dismissed (pending review included) — the same set the website table shows. Passing a deliveryId re-reads a past API run. Neither path charges. |
| POST, GET | /alerts/{alertId}/preview | Free | Free. Preview returns how many records a rule would deliver and what that would cost, not the records themselves. |
| POST | /alerts/{alertId}/run | Free | Free. A manual run delivers matching records at no credit cost. Finding contact info on those records is a separate enrichment. |
| POST | /analytics/aggregate | Free | Free. POST only (GET returns 404/405). Returns counts and group keys, never a project id, name, address, contact or document. |
| GET | /analytics/datasets | Free | Free. GET only. What the analytics plane can and cannot answer, self-described. |
| POST | /analytics/rankings | Free | Free. POST only (GET returns 405). Same small-group suppression floor as /aggregate. |
| GET | /documents/{id} | Free | County, State, and National: free. Standalone API Only and the free trial: 1 credit per source document the first time this pool receives it. |
| GET | /enrichments/{id} | Free | Free to poll. Progress counts for a submitted enrichment job. |
| POST | /exports | Free | Free to queue a product CSV. Pass alertId, listId, or projectIds to export a saved set (optional extra filters stay inside those ids). Omit all three and the body is a new search. Find Contact Info on those rows is 1 credit per project the first time this account receives email or phone for it. |
| GET | /exports | Free | Free. Lists export jobs for your team (including jobs queued with POST /exports or format=csv on search). |
| GET | /exports/{id} | Free | Free. Poll job status until ready. |
| GET | /exports/{id}/download | Free | Free re-download of a ready product-core CSV. Rows are free to queue. Find Contact Info on those rows, if you asked for it, was 1 credit per project unlocked. |
| GET | /health | Free | Free and unauthenticated. A liveness probe, not part of the record contract: its response shape carries no schema guarantee and can change without a schema-version bump, which is why it is deliberately absent from the OpenAPI document. Do not generate a client against it or parse its body. |
| GET | /lists | Free | Free. Every list your membership resolves — your own and the ones shared with you. |
| POST | /lists | Free | Free. Creates a named membership list (the "new list" option on save). |
| GET | /lists/{listId} | Free | Free. One list's configuration and share state, plus results.billable.credits — what a full /results pull would charge right now. This is the free preflight for /results. |
| POST | /lists/{listId}/projects | Free | Free. Adds project ids to a membership-backed list. Idempotent per id. |
| DELETE | /lists/{listId}/projects/{projectId} | Free | Free. Removes a project from a membership-backed list. |
| GET | /lists/{listId}/results | Free | County, State, and National: free. Standalone API Only and the free trial: 1 credit per delivered record that is new to this pool or changed since last delivery; unchanged owned records are free. Alert companions return the same match set as the alert (every match except dismissed, pending review included). Extra search filters apply only inside those existing ids. Filter and polygon lists return stored criteria plus a search link. |
| GET | /locations/cities/{id} | Free | Free. |
| GET | /locations/counties/{id} | Free | Free. |
| GET | /locations/states | Free | Free. Resolve the ids you filter with. |
| GET | /locations/states/{id} | Free | Free. |
| GET | /locations/states/{id}/counties | Free | Free. |
| GET | /locations/states/{stateId}/counties/{countyId}/cities | Free | Free. |
| POST | /projects/ai-search | Free | Not part of the public API — you cannot call this with an API key. Any bwk_live_/csk_ key is refused with 400 invalid_request (error.param: "endpoint", details.asyncEndpoint) before anything is parsed; use POST /projects/ai-search/jobs instead. On the session-authenticated web product this path is free, like structured search. |
| POST | /projects/ai-search/jobs | Free | County, State, and National: free. Standalone API Only and the free trial: credits are reserved at 1 per requested record and settled against confirmed matches. Finding contact info on those records is a separate enrichment job (included on API Only after the record is purchased). |
| GET | /projects/ai-search/jobs/{id} | Free | Polling is free. The records the job delivers were charged when the job settled, not when you read them. |
| DELETE | /projects/ai-search/jobs/{id} | Free | Cancelling is free and gives credits back, never takes them: a queued job refunds its full reservation immediately; a running job settles at the next batch boundary, charging only confirmed records and refunding the rest. |
| GET | /projects/count | Free | Free, always, including when your balance is zero. How many projects match. On API Only and the trial it also prices the set; on County, State, and National, search is free. |
| GET | /projects/search | Free | County, State, and National: free. Standalone API Only and the free trial: 1 credit per delivered record that is new to this pool or changed since last delivery; unchanged owned records are free. format=csv queues the full filter match and returns HTTP 202 with poll/download URLs. Find Contact Info is billed separately on County/State/National, and included on API Only records already purchased. |
| GET | /projects/sync | Free | County, State, and National: free. Standalone API Only and the free trial: 1 credit per new or changed record; unchanged owned records bill 0. |
| GET | /projects/{id} | Free | County, State, and National: free. Standalone API Only and the free trial: 1 credit the first time this pool receives the record. Email, phone, and LinkedIn stay withheld until Find Contact Info has unlocked the project (included on API Only after the record is purchased). |
| GET | /reference/decision-bodies | Free | Free. Canonical values accepted by the decisionBodies filter. |
| GET | /reference/owner-types | Free | Free. The owner-type vocabulary used by alert criteria and CSV output. Not accepted as a /projects/search filter — the ownerTypes filter was withdrawn on 2026-08-27. |
| GET | /reference/request-types | Free | Free. Canonical values accepted by the requestTypes filter. |
| GET | /reference/statuses | Free | Free. Canonical status filter tokens plus display aliases (e.g. scheduled). |
| GET | /taxonomy | Free | Free. The complete Building Type tree. |
| GET | /taxonomy/action-categories | Free | Free. |
| GET | /taxonomy/action-types | Free | Free. |
| GET | /taxonomy/asset-classes | Free | Free. |
| GET | /taxonomy/project-types | Free | Free. |
| GET | /taxonomy/subtypes | Free | Free. |
Ready to make a call?
A free Boardwalk trial includes API access, 50 record-export credits (search, CSV, MCP), and 5 Find Contact Info lookups. Counting, taxonomy, location lookups and the analytics plane cost nothing, so you can evaluate the data before you spend a credit.