Contacts and enrichment
Who is behind a project, what we will and will not tell you about them, and why enrichment does not cost extra.
Every record carries the parties named on the filing itself, split into two arrays that are governed by different rules.
| Array | Who is in it | What ships |
|---|---|---|
contacts | External parties — developers, applicants, architects, consultants. | Name, title, role, company. On a paid plan, also email, phone and LinkedIn where we have them, each with its own confidence and source. |
publicOfficials | Government staff — planners, clerks, commissioners. | Name, title, organisation. Never a contact channel, on any tier. |
contactSummary counts both, plus how many contacts were withheld and why — so a record with no contact channels is distinguishable from a record where we withheld them.
Enrichment
Add include=contacts to an asynchronous request. Enrichment calls out to third-party sources and cannot complete inside a synchronous request, so a synchronous route returns 400 enrichment_requires_async and names the endpoint to use.
The same search, with contact enrichment switched on
curl -X POST 'https://api.boardwalkai.com/api/v1/projects/ai-search/jobs' \
-H 'Authorization: Bearer bwk_live_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{
"query": "multifamily projects that were continued for parking concerns",
"states": [
"UT"
],
"limit": 50,
"include": "contacts",
"contactOptions": {
"minConfidence": "high"
}
}'Response · HTTP 202
{
"requestId": 918509,
"status": "pending",
"pollUrl": "/api/v1/projects/ai-search/jobs/918509",
"meta": {
"creditsReserved": 50,
"limit": 50,
"trialTruncation": null
}
}The response shape on this page is the one the endpoint builds — the keys, their nesting and their types are asserted against the shipping code by a test. The numbers inside it are the scenario being walked through, not a measurement of the corpus.
The full option list and the status enum are on the contact enrichment recipe.
The limits we will not paper over
Opting out
If your contact details appear in Boardwalk and you want us to stop distributing them, tell us. Suppression applies everywhere, immediately, for every customer.
Ready to make a call?
A free Boardwalk trial includes API access and a sandbox key. Counting, filtering, the location tree and the analytics plane cost nothing, so you can evaluate the data before you spend a credit.