API Documentation

Integrate U.S. building code data into your applications, virtual agents, and compliance tools.

Quick Start

Add the token to your request headers:

curl -H "Authorization: Bearer YOUR_TOKEN" \
https://usbuildcodes-9xjbduqe.manus.space/api/v1/states

That's it! All endpoints return JSON. See examples below.

Bearer Token Auth

All API requests require a valid Bearer token in the Authorization header.

JSON Responses

All endpoints return JSON with a consistent structure: data, count, and error fields.

Rate Limited

Default 1,000 requests/day per token. Contact us for higher limits.

Integration Examples

# Get Florida building codes
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://usbuildcodes-9xjbduqe.manus.space/api/v1/states/FL

# Search for fire codes
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://usbuildcodes-9xjbduqe.manus.space/api/v1/search?q=fire"

# Export all data as JSON
curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://usbuildcodes-9xjbduqe.manus.space/api/v1/export

API Endpoints

GET/api/v1/statesList all states and territories

List all states and territories

{
  "data": [
    {
      "id": 1,
      "name": "Alabama",
      "stateCode": "AL",
      "type": "state",
      "population": 5024279,
      "website": "https://www.alabama.gov/",
      "buildingDeptUrl": "https://bc.alabama.gov/",
      "permitPortalUrl": "https://bc.alabama.gov/"
    },
    ...
  ],
  "count": 51
}

GET/api/v1/states/:codeGet state details with adopted codes and cities

Get state details with adopted codes and cities

{
  "data": {
    "id": 5,
    "name": "California",
    "stateCode": "CA",
    "adoptions": [
      {
        "codeNumber": "IBC",
        "codeName": "International Building Code",
        "editionYear": 2024,
        "enforcementLevel": "mandatory",
        "hasAmendments": true,
        "notes": "Modified as California Building Code"
      }
    ],
    "cities": [...]
  }
}

GET/api/v1/codesList all codes. Filters: ?q=&organizationId=&categoryId=

List all codes. Filters: ?q=&organizationId=&categoryId=

{
  "data": [
    {
      "id": 1,
      "codeNumber": "IBC",
      "fullName": "International Building Code",
      "orgAcronym": "ICC",
      "categoryName": "Building"
    },
    ...
  ],
  "count": 43
}

GET/api/v1/codes/:idGet code details with all editions

Get code details with all editions

{
  "data": {
    "id": 17,
    "codeNumber": "NFPA 70",
    "fullName": "National Electrical Code",
    "acronym": "NEC",
    "editions": [
      { "year": 2026, "status": "current" },
      { "year": 2023, "status": "superseded" }
    ]
  }
}

GET/api/v1/organizationsList all standards organizations

List all standards organizations

{
  "data": [
    { "id": 1, "name": "International Code Council", "acronym": "ICC" },
    { "id": 2, "name": "National Fire Protection Association", "acronym": "NFPA" },
    ...
  ]
}

GET/api/v1/categoriesList all code categories

List all code categories

{
  "data": [
    { "id": 1, "name": "Building", "icon": "building-2" },
    { "id": 2, "name": "Electrical", "icon": "zap" },
    ...
  ]
}

GET/api/v1/search?q=Full-text search across all codes

Full-text search across all codes

{
  "data": [...],
  "count": 5,
  "query": "fire sprinkler"
}

GET/api/v1/export?state=Export full database or state-specific data as JSON

Export full database or state-specific data as JSON

{
  "metadata": {
    "exportedAt": "2026-02-26T...",
    "version": "1.0"
  },
  "organizations": [...],
  "codes": [...],
  "states": [...]
}

GET/api/v1/statsGet platform statistics

Get platform statistics

{
  "data": {
    "states": 51,
    "codes": 43,
    "organizations": 10,
    "adoptions": 110
  }
}