Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Commonelements Com Statutes API
version: 1.4.0
contact:
name: Common Elements API support
url: https://commonelements.com/contact
license:
name: Commercial data licence
url: https://commonelements.com/developers/pricing/builder
termsOfService: https://commonelements.com/terms
description: 'Operations tagged Statutes across 2 of this provider''s published API definitions: commonelements-com-openapi.json, commonelements-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://commonelements.com/api/v1
description: Production
- url: https://commonelements.com/api/v1/meta/sandbox
description: Sandbox — fixed dataset, published test key, not metered
security:
- bearerAuth: []
tags:
- name: Statutes
description: ''
paths:
/api/v1/statutes/search:
get:
operationId: statutesSearch
summary: Full-text search across the community-association statute corpus, ranked by…
description: 'Full-text search across the community-association statute corpus, ranked by relevance. The endpoint behind the statute search on commonelements.com, available programmatically.
**Plan:** Free keys: up to 50 rows per request; paid tiers raise the cap.'
tags:
- Statutes
security:
- bearerAuth: []
x-ce-scope: statutes or associations
x-ce-docs-url: https://commonelements.com/developers/docs#statutes-search
x-ce-example-request: "curl \"https://commonelements.com/api/v1/statutes/search?q=reserve+study&state=FL\" \\\n -H \"Authorization: Bearer ce_live_your_key_here\""
responses:
'200':
description: Success.
content:
application/json:
schema:
type: object
required:
- ok
- data
properties:
ok:
type: boolean
const: true
data:
type: array
items:
type: object
properties:
section_id:
type: string
format: uuid
description: Statute section id, for use with /v1/statutes/sections/{id}.
chapter_slug:
type: string
description: The chapter this section belongs to.
chapter_short_title:
type: string
description: The chapter this section belongs to.
chapter_jurisdiction:
type: string
description: The chapter this section belongs to.
chapter_number:
type: string
description: The chapter this section belongs to.
section_number:
type:
- string
- 'null'
description: Section numbering as published.
subsection:
type:
- string
- 'null'
description: Section numbering as published.
section_slug:
type: string
description: Slug for the public statute page.
title:
type:
- string
- 'null'
description: Section title and plain-language summary.
summary:
type:
- string
- 'null'
description: Section title and plain-language summary.
snippet:
type:
- string
- 'null'
description: Search-result highlight from the matched text.
rank:
type: number
description: Relevance score. Results are pre-sorted by this, highest first.
additionalProperties: true
additionalProperties: true
examples:
default:
value:
ok: true
query: reserve study
state: FL
data:
- section_id: 8a3f0c1e-2b4d-4e9a-9f0c-1e2b4d4e9a9f
chapter_id: chp_...
chapter_slug: florida-718
chapter_short_title: Condominium Act
chapter_jurisdiction: FL
chapter_number: '718'
section_number: '718.112'
subsection: '2'
section_slug: 718-112-bylaws
title: Bylaws; reserve accounts
summary: Requires reserve accounts for capital expenditures and deferred maintenance...
snippet: '...the association shall include reserve accounts for capital expenditures and deferred maintenance...'
rank: 0.87
count: 1
'400':
description: '`validation_error` — A query parameter or body field is missing, malformed, or outside its allowed range. The message names the first parameter that failed. Next: Fix the named parameter and re-send. Every parameter and its accepted values are in the OpenAPI document at /api/v1/openapi; retrying an unchanged request will fail the same way.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: '`invalid_api_key` — No Authorization header, a header that is not `Bearer <key>`, or a key that does not resolve to an active record. Next: Send `Authorization: Bearer ce_live_...`. If the header is correct, the key has been revoked or expired — mint a new one at /settings/api-keys. Keys are shown once at creation and stored only as a hash, so a lost key cannot be recovered.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: '`scope_not_allowed` — The key is valid but was created without the scope this endpoint requires. Scopes are set at key creation and are not widened at request time. Next: Create a key carrying the scope named in the message, or use the `all` scope. Each endpoint''s required scope is on its OpenAPI operation as `x-ce-scope`.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: '`quota_exceeded` — The key has spent every request included in the current calendar month. There is no overage charge and no automatic top-up. Next: Call /api/v1/meta/usage to see the reset date and how the quota was spent, then either wait for the reset at the start of the next calendar month or upgrade the plan. /api/v1/meta/usage does not itself consume quota.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: '`internal_error` — The request was accepted and failed on our side. Next: Retry with exponential backoff (1s, 2s, 4s, up to about 30s). If it persists past a few minutes, check /api/v1/meta/status and contact support with the time of the request.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
- name: q
in: query
required: true
description: Search text, minimum 2 characters.
schema:
type: string
- name: state
in: query
required: false
description: Two-letter state code to scope results to one jurisdiction. Omit to search every jurisdiction.
schema:
type: string
- name: limit
in: query
required: false
description: Max results, 1 to 25 (default 10).
schema:
type: number
- name: offset
in: query
required: false
description: Pagination offset (default 0).
schema:
type: number
x-ce-plan-note: 'Free keys: up to 50 rows per request; paid tiers raise the cap.'
servers:
- url: https://commonelements.com/api/v1
description: Production
- url: https://commonelements.com/api/v1/meta/sandbox
description: Sandbox — fixed dataset, published test key, not metered
/api/v1/statutes/by-state:
get:
operationId: statutesByState
summary: Browse/enumerate every statute section on file for a state, grouped by chapter…
description: 'Browse/enumerate every statute section on file for a state, grouped by chapter — the companion to statutes/search for "show me everything" rather than a keyword match. Filter to one chapter or a tagged topic.
**Plan:** Free keys: up to 50 rows per request; paid tiers raise the cap.'
tags:
- Statutes
security:
- bearerAuth: []
x-ce-scope: statutes or associations
x-ce-docs-url: https://commonelements.com/developers/docs#statutes-by-state
x-ce-example-request: "curl \"https://commonelements.com/api/v1/statutes/by-state?state=FL&chapter=718\" \\\n -H \"Authorization: Bearer ce_live_your_key_here\""
responses:
'200':
description: Success.
content:
application/json:
schema:
type: object
required:
- ok
- data
properties:
ok:
type: boolean
const: true
data:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
description: Statute section id.
chapter_number:
type:
- string
- 'null'
description: The chapter this section belongs to.
chapter_title:
type:
- string
- 'null'
description: The chapter this section belongs to.
section_number:
type:
- string
- 'null'
description: Section numbering as published.
subsection:
type:
- string
- 'null'
description: Section numbering as published.
slug:
type: string
description: Slug for the public statute page.
title:
type:
- string
- 'null'
description: Section title and plain-language summary.
summary:
type:
- string
- 'null'
description: Section title and plain-language summary.
topics:
type: array
items:
type: string
description: Tagged topics for this section.
citation:
type:
- string
- 'null'
description: Formatted legal citation, e.g. "Fla. Stat. § 718.112".
effective_date:
type:
- string
- 'null'
format: date
description: When this version took effect.
source_url:
type:
- string
- 'null'
description: Link to the official published text.
additionalProperties: true
additionalProperties: true
examples:
default:
value:
ok: true
data:
- id: 8a3f0c1e-2b4d-4e9a-9f0c-1e2b4d4e9a9f
chapter_number: '718'
chapter_title: Condominium Act
section_number: '718.112'
subsection: '2'
slug: 718-112-bylaws
title: Bylaws; reserve accounts
summary: Requires reserve accounts for capital expenditures and deferred maintenance...
topics:
- reserves
- bylaws
citation: Fla. Stat. § 718.112
effective_date: '2026-07-01'
source_url: https://www.leg.state.fl.us/...
state: FL
pagination:
total: 214
limit: 100
offset: 0
'400':
description: '`validation_error` — A query parameter or body field is missing, malformed, or outside its allowed range. The message names the first parameter that failed. Next: Fix the named parameter and re-send. Every parameter and its accepted values are in the OpenAPI document at /api/v1/openapi; retrying an unchanged request will fail the same way.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: '`invalid_api_key` — No Authorization header, a header that is not `Bearer <key>`, or a key that does not resolve to an active record. Next: Send `Authorization: Bearer ce_live_...`. If the header is correct, the key has been revoked or expired — mint a new one at /settings/api-keys. Keys are shown once at creation and stored only as a hash, so a lost key cannot be recovered.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: '`scope_not_allowed` — The key is valid but was created without the scope this endpoint requires. Scopes are set at key creation and are not widened at request time. Next: Create a key carrying the scope named in the message, or use the `all` scope. Each endpoint''s required scope is on its OpenAPI operation as `x-ce-scope`.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: '`quota_exceeded` — The key has spent every request included in the current calendar month. There is no overage charge and no automatic top-up. Next: Call /api/v1/meta/usage to see the reset date and how the quota was spent, then either wait for the reset at the start of the next calendar month or upgrade the plan. /api/v1/meta/usage does not itself consume quota.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: '`internal_error` — The request was accepted and failed on our side. Next: Retry with exponential backoff (1s, 2s, 4s, up to about 30s). If it persists past a few minutes, check /api/v1/meta/status and contact support with the time of the request.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
- name: state
in: query
required: true
description: Two-letter state code.
schema:
type: string
- name: chapter
in: query
required: false
description: Limit to one chapter number.
schema:
type: string
- name: topic
in: query
required: false
description: Limit to sections tagged with this topic.
schema:
type: string
- name: limit
in: query
required: false
description: Max results, 1 to 200 (default 100).
schema:
type: number
- name: offset
in: query
required: false
description: Pagination offset (default 0).
schema:
type: number
x-ce-plan-note: 'Free keys: up to 50 rows per request; paid tiers raise the cap.'
servers:
- url: https://commonelements.com/api/v1
description: Production
- url: https://commonelements.com/api/v1/meta/sandbox
description: Sandbox — fixed dataset, published test key, not metered
/api/v1/statutes/sections/{id}:
get:
operationId: statutesSectionDetail
summary: The full text and metadata for one statute section, including its parent…
description: The full text and metadata for one statute section, including its parent chapter and formatted citation. Follow-up call after search or by-state to read the section in full.
tags:
- Statutes
security:
- bearerAuth: []
x-ce-scope: statutes or associations
x-ce-docs-url: https://commonelements.com/developers/docs#statutes-section-detail
x-ce-example-request: "curl \"https://commonelements.com/api/v1/statutes/sections/8a3f0c1e-2b4d-4e9a-9f0c-1e2b4d4e9a9f\" \\\n -H \"Authorization: Bearer ce_live_your_key_here\""
responses:
'200':
description: Success.
content:
application/json:
schema:
type: object
required:
- ok
- data
properties:
ok:
type: boolean
const: true
data:
type: object
properties:
section_id:
type: string
format: uuid
description: Statute section id.
section_number:
type:
- string
- 'null'
description: Section numbering as published.
subsection:
type:
- string
- 'null'
description: Section numbering as published.
title:
type:
- string
- 'null'
description: Section title and plain-language summary.
summary:
type:
- string
- 'null'
description: Section title and plain-language summary.
body_text:
type: string
description: Full text of the section.
topics:
type: array
items:
type: string
description: Tagged topics for this section.
effective_date:
type:
- string
- 'null'
format: date
description: Effective date and link to the official published text.
source_url:
type:
- string
- 'null'
format: date
description: Effective date and link to the official published text.
chapter:
type: object
additionalProperties: true
description: id, slug, jurisdiction, chapter_number, short_title, citation_format for the parent chapter.
citation:
type: string
description: Formatted legal citation for this exact section.
additionalProperties: true
additionalProperties: true
examples:
default:
value:
ok: true
data:
section_id: 8a3f0c1e-2b4d-4e9a-9f0c-1e2b4d4e9a9f
section_number: '718.112'
subsection: '2'
title: Bylaws; reserve accounts
summary: Requires reserve accounts for capital expenditures and deferred maintenance...
body_text: (2) BYLAWS. (a) The original bylaws of the association...
topics:
- reserves
- bylaws
effective_date: '2026-07-01'
source_url: https://www.leg.state.fl.us/...
chapter:
id: chp_...
slug: florida-718
jurisdiction: FL
chapter_number: '718'
short_title: Condominium Act
citation_format: Fla. Stat. § {section}
citation: Fla. Stat. § 718.112(2)
'400':
description: '`validation_error` — A query parameter or body field is missing, malformed, or outside its allowed range. The message names the first parameter that failed. Next: Fix the named parameter and re-send. Every parameter and its accepted values are in the OpenAPI document at /api/v1/openapi; retrying an unchanged request will fail the same way.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: '`invalid_api_key` — No Authorization header, a header that is not `Bearer <key>`, or a key that does not resolve to an active record. Next: Send `Authorization: Bearer ce_live_...`. If the header is correct, the key has been revoked or expired — mint a new one at /settings/api-keys. Keys are shown once at creation and stored only as a hash, so a lost key cannot be recovered.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: '`scope_not_allowed` — The key is valid but was created without the scope this endpoint requires. Scopes are set at key creation and are not widened at request time. Next: Create a key carrying the scope named in the message, or use the `all` scope. Each endpoint''s required scope is on its OpenAPI operation as `x-ce-scope`.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: '`not_found` — The identifier is well-formed but matches nothing this key may see. Records excluded from the public directory read as absent rather than forbidden, deliberately — a 403 would confirm the row exists. Next: Confirm the identifier against a list or search endpoint before fetching it by id. A record that appears in the product but not here is outside the licensed dataset.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: '`quota_exceeded` — The key has spent every request included in the current calendar month. There is no overage charge and no automatic top-up. Next: Call /api/v1/meta/usage to see the reset date and how the quota was spent, then either wait for the reset at the start of the next calendar month or upgrade the plan. /api/v1/meta/usage does not itself consume quota.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: '`internal_error` — The request was accepted and failed on our side. Next: Retry with exponential backoff (1s, 2s, 4s, up to about 30s). If it persists past a few minutes, check /api/v1/meta/status and contact support with the time of the request.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
- name: id
in: path
required: true
description: Section id from search or by-state.
schema:
type: string
format: uuid
servers:
- url: https://commonelements.com/api/v1
description: Production
- url: https://commonelements.com/api/v1/meta/sandbox
description: Sandbox — fixed dataset, published test key, not metered
components:
schemas:
Error:
type: object
required:
- ok
- error
- message
properties:
ok:
type: boolean
const: false
error:
type: string
description: Stable machine-readable code. Switch on this, not on the message.
enum:
- validation_error
- invalid_api_key
- scope_not_allowed
- tier_not_allowed
- not_found
- quota_exceeded
- public_record_allowance_exceeded
- not_implemented
- search_timeout
- internal_error
- service_unavailable
message:
type: string
description: Human-readable detail. Wording may change; the code will not.
docs_url:
type: string
format: uri
description: Where this code is explained in full. Present on the meta namespace.
next_steps:
type: string
description: What to do about it. Present on the meta namespace.
additionalProperties: true
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'An API key from /settings/api-keys, sent as `Authorization: Bearer ce_live_...`. Sandbox requests use the published test key documented at /api/v1/meta/sandbox.'
x-refined-from:
- commonelements-com-openapi.json
- commonelements-com-openapi.yml
x-ce-api-version: v1
x-ce-versions:
- version: v1
status: current
released_on: '2026-06-15'
sunset_on: null
note: The only version. No successor is announced, so no sunset date exists to publish; when one does, it appears here and in the Sunset header before anything is removed.
x-ce-compatibility:
- kind: additive
rule: Adding a new endpoint, a new optional query parameter, or a new field to a response object. Parse responses tolerantly; a client that errors on an unrecognised field will break on a change this policy permits.
- kind: additive
rule: Adding a new value to an open enumeration such as `change_kind`, a county-published milestone status, or a vendor category. Handle an unknown value as a passthrough string rather than a parse failure.
- kind: additive
rule: Raising a plan's row cap or quota, or widening a lookback window.
- kind: breaking
rule: Removing or renaming a field, changing a field's type, or changing the meaning of an existing value. Never done inside v1.
- kind: breaking
rule: Removing an endpoint, adding a required parameter to an existing endpoint, or tightening an existing parameter's accepted values.
- kind: breaking
rule: Moving an endpoint behind a higher plan than the one it shipped under. A new endpoint may launch on any plan; an existing one does not move up.
x-ce-deprecation-policy:
- label: 12 months minimum notice
detail: A version is supported for at least 12 months after its successor is generally available. No endpoint inside a supported version is removed during that window.
- label: Announced in three machine-readable places
detail: 'A deprecated operation carries `deprecated: true` in the OpenAPI document, a `Deprecation` and a `Sunset` HTTP header (RFC 8594) on every response, and an entry in the changelog on /developers/status. Poll any one of them; you do not have to read an email to find out.'
- label: Successor named before removal
detail: Nothing is deprecated without a documented replacement that returns the same information. The replacement ships first, and both run concurrently for the whole notice period.
- label: Emergency exception, narrowly scoped
detail: The only change that can ship without notice is one required to stop unlawful or unlicensed disclosure of data — a field withdrawn because a source's terms changed, or a privacy obligation. Affected customers are contacted directly, and the reason is stated in the changelog.
x-ce-changelog:
- date: '2026-08-16'
kind: additive
summary: 'Added the meta namespace: /api/v1/openapi (machine-readable spec), /api/v1/meta/status, /api/v1/meta/dictionary, /api/v1/meta/usage, and a sandbox at /api/v1/meta/sandbox. Error responses on the new endpoints carry `docs_url` and `next_steps` alongside the existing `error` and `message`.'
- date: '2026-08-16'
kind: additive
summary: '`display_name` added to the association record: the canonical rendering of the filed name. `name` is unchanged and still the verbatim registry string.'
- date: '2026-08-11'
kind: additive
summary: Bulk export gained `format=json` alongside CSV, and `columns=` for selecting a subset of a resource's column spec.
- date: '2026-08-10'
kind: additive
summary: Bulk export resources `building-safety` and `report-card` added.
- date: '2026-08-03'
kind: additive
summary: Change feed endpoints /api/v1/changes and /api/v1/changes/summary released.
- date: '2026-06-15'
kind: additive
summary: v1 generally available.
x-ce-quota-policy:
window: calendar month, UTC
reset: First request on or after the first day of the next calendar month resets the counter.
overage: None. A key that reaches its included requests returns 429 until the reset or an upgrade; there is no automatic overage charge.
meteringUnit: One HTTP request against a /api/v1 endpoint, counted whatever the status code. Meta endpoints (/api/v1/meta/*, /api/v1/openapi) and the sandbox are not metered.
x-ce-plan-quotas:
free: 250
builder: 10000
growth: 50000
scale: 250000
enterprise: unmetered