Common Elements Statutes API

The Statutes API from Common Elements — 3 operation(s) for statutes.

GitHub OpenAPI

Operations 3

GET /api/v1/statutes/search Full-text search across the community-association statute corpus, ranked by… #
GET /api/v1/statutes/by-state Browse/enumerate every statute section on file for a state, grouped by chapter… #
GET /api/v1/statutes/sections/{id} The full text and metadata for one statute section, including its parent… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/commonelements-com:commonelements-com-statutes-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

commonelements-com-statutes-api-openapi.yml Raw ↑
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