Get one building permit
get_permitOne building permit by permitId. representation="standard" (the default) has every party named on the permit with the phones and emails it printed, the inspections summary, value, size, and building type. "compact" is the short card. "full" adds the history, every inspection, fees, property owners, and plannedProjectId when the permit is linked to a planned project. includeSourceText=true also returns the text the permit was read from (it implies full; long text is cut and the response says so). Counts as one export record on County, State, and National, or 1 credit on API Only and the trial, the first time this account receives this permit's current content. The source text counts with the permit record: 1 export record (or credit) per new or changed permit across both, and nothing more if the account already has it. A permit with no source text on file returns without it, with a note, and nothing extra is charged. Re-reading an unchanged permit does not use credits. detailLevel "summary" means Boardwalk has only the city's list entry for this permit, so the contractor or value may be on the city's own page (sourceUrl). A private individual's phone or email can be withheld (contactWithheld). withheld "upgrade" means homeowner phones and emails need a paid plan, and the user's plan does not include them; "acknowledge" means the user has to accept the homeowner contact rules once in the Boardwalk web app, and then they show. hasPhone and hasEmail say which exists. When anything on a permit is withheld, every phone and email in its source text and its written text (descriptions, summaries, titles, notes, inspections, history; counted in textContactWithheld) shows as "[phone withheld]" or "[email withheld]", business lines included; quote business phones and emails from the permit's parties instead. Name every party the result returns; mention withholding only for a party that carries contactWithheld. The contact exists: never call it missing or not on the permit, and never guess a number. get_credit_balance returns the remaining balance.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"permitId": "<permitId>"
},
"name": "get_permit"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| permitId | Yes | A permit id (permitId on a permit record). | |
| representation | No | standard (default): every party with printed phones and emails. full adds history, inspections, fees, owners. compact is the short card. | |
| includeSourceText | No | Also return the permit's source text. Implies full. One permit at a time; never in a loop. |