Documentation

get_permit_history

Get permit history

Permit history brings together official D.C. permit families while keeping agency, record type, dates, status, and exact-versus-contextual property association explicit.

Start free

When to use it

Use for official building permit history, certificate of occupancy records, and DDOT public-space permit records associated with a resolved property. Record types and property-link scope stay explicit.

Use cursor pagination until has_more is false when a property has more records than one page. Interpret each permit in its issuing-agency context.

Input contract

These inputs and limits are pinned to the production v0.4.6 server contract. Omitted optional values use the documented defaults.

Input contract table
InputContract
ssloptional; string; min length 1; max length 32
addressoptional; string; min length 2; max length 160
cursoroptional; string; min length 1; max length 512
limitoptional; integer; minimum 1; maximum 50; default 20
{
  "ssl": "5140--0088",
  "limit": 20
}

Response and verification

Successful sourced responses preserve effective dates, typed null meaning, source references, quality flags, and exact-versus-contextual property-link scope.

Use the display-ready sources for a visible Source or Verify action. Responses return each field with a source reference that can be checked against the official portal. See Source citations and verification for the evidence format.

Limits

  • Permit issuance is not proof that work was completed or code compliant.
  • Public-space permits are not building permits.
  • Contextual links must not be restated as exact parcel facts.