Data dictionary

Every resource the API returns and every field on it — what it means, where the value came from, and how much of it there actually is. The point of publishing it is the last part: a field that exists and is null on ninety per cent of rows is a different product from one that is always populated, and you should be able to tell which you are buying before you integrate.

How to read it

Associations

The association directory spine: every community association we hold, keyed by a stable id, with its filed name, registration, location and size.

• A low-confidence unit_count is withheld rather than returned. Backtested 2026-08-09, one state registry's self-declared count ran at a median of 14x the true built-unit count; a number we would not defend does not go into a subscriber's spreadsheet.
• Records excluded from the public directory (demo tenants, unverified platform-created rows, privileged operator imports) are absent from every API surface, not merely hidden. A 404 on such a record is the same 404 as for an id that never existed.

Association officers

Who sits on the board, by name and title, as most recently filed with the state — the roster behind board-turnover detection.

• Names and titles only. Personal email and phone for a board member are barred from this surface entirely, whatever the source.
• A roster reflects the most recent filing, not a live board. States publish on their own cadence; an officer who resigned last week appears until the next filing.

Association management

The management relationship: which firm or licensed manager serves an association, and the licensed managers attached to a firm.

• A management link sourced from a filing is as current as the filing. Confirmed platform relationships carry a different source value; check `source` before treating a link as live.

Building safety

Structural and life-safety public record joined to the association: structural integrity reserve studies, milestone recertification, elevator certificates, pool inspections, building characteristics and FHA approval.

• Florida-weighted by construction: SIRS, elevator, pool and characteristics are Florida programs, and recertification is currently Miami-Dade and Broward. An association outside that footprint returns an empty record rather than a false negative.
• `milestone_status` and `pool_last_result` describe the most recent record, not the whole history. Filtering on them in bulk export means 'the current record is X'.

Association risk

Per-association risk signals: FEMA National Risk Index for the county, plus the aggregated report-card measures behind the association profile.

• County risk is a county-level measure applied to the association's county. It is not a property-level hazard score and must not be presented as one.

Change feed

What changed and when: board turnover, president changes, management-company moves, self-managed transitions, registration status and name changes, and license events.

• Plan sets both the row cap and the maximum lookback window, clamped server-side: an earlier `since` cannot widen a plan's window.
• History depth is still short. Detection began in 2026; a plan whose window is longer than the history returns the same rows as a shorter one. The window is a forward-looking contract, and no surface prices on lookback depth until the history exists.

Vendors

The verified vendor directory: identity, service scope, platform review summary, and an independently-sourced trust profile from public records.

• Only verified vendors are listed. This is a curated directory, not a scrape of every contractor in a state — its size is a deliberate quality bound.
• Self-asserted fields are labelled as such. The independently-sourced trust profile is on the detail endpoint and is the one to use for underwriting.

Professionals and licences

State-licensed professionals serving community associations — community association managers and related boards — with licence status and history.

• Board status vocabularies differ by state and are passed through rather than normalised. Filter on `expiry_date` when you need 'is this licence live today'.
• Licensee email and phone are never returned by this API at any plan, whatever a board publishes.

Statutes

The statute reference: chapters and sections governing community associations, with citation formatting, topics and source links.

• Reference material, not legal advice. Always check `source_url` against the official publication before relying on a section.

State aggregates

Counts by state: associations in the directory and licensed insurance professionals, for sizing a market without pulling the underlying rows.

Compliance scan

Scan governing-document text against the statute rule set for a state and get scored, cited findings.

• Analysis, not legal advice. A finding is a prompt to check a document with counsel, and the response carries the statute so that check is cheap.
• Submitted text is used to produce the response and is not retained as a document.

Get it as JSON

The same dictionary, machine-readable, with per-field fill rates and available_to_you resolved against your own plan. It does not consume quota.

curl "https://commonelements.com/api/v1/meta/dictionary?resource=associations" \
  -H "Authorization: Bearer ce_live_your_key_here"

For the API’s shape rather than its contents, import the OpenAPI document. To try any of it before buying a plan, use the sandbox.