API Documentation

Overview

The Siteline API provides read-only access to production regulation data across all 50 US states and 14 regulation categories. Data includes fire codes, building codes, structural requirements, tent permits, PE stamps, rigging, pyrotechnics, electrical, noise, food/bev, crowd management, signage, weather safety, and insurance requirements.

Base URL: https://siteline.events/api/v1

Authentication

All API requests require a valid API key. Include it in the Authorization header as a Bearer token.

curl https://siteline.events/api/v1/states \
  -H "Authorization: Bearer sk_live_your_key_here"

API keys are available to Pro subscribers. Generate keys from your Dashboard.

Rate Limits

API requests are rate-limited to 100 requests per hour per API key. If you exceed this limit, you will receive a 429 response.

{
  "error": "Rate limit exceeded. Maximum 100 requests per hour."
}

GET /api/v1/states

List all states or retrieve details for a specific state.

Query Parameters

List all states

curl https://siteline.events/api/v1/states \
  -H "Authorization: Bearer sk_live_your_key_here"

# Response
{
  "states": [
    {
      "id": 1,
      "name": "Alabama",
      "abbr": "AL",
      "ibc_edition": "2021",
      "fire_code_basis": "IFC",
      "has_statewide_code": true,
      "regulatory_climate": "Moderate"
    },
    ...
  ],
  "count": 50
}

Get a single state

curl "https://siteline.events/api/v1/states?abbr=TX" \
  -H "Authorization: Bearer sk_live_your_key_here"

# Response
{
  "state": {
    "id": 43,
    "name": "Texas",
    "abbr": "TX",
    "ibc_edition": "2021",
    "ifc_edition": "2021",
    "fire_code_basis": "IFC",
    "has_statewide_code": true,
    "home_rule": true,
    "dillon_rule": false,
    "regulatory_climate": "Business-friendly",
    "fire_marshal_name": "Texas State Fire Marshal",
    "fire_marshal_url": "https://www.tdi.texas.gov/fire/",
    "fire_marshal_phone": null,
    "key_differences": [...],
    "notes": null,
    "last_verified": "2026-03-15"
  }
}

GET /api/v1/regulations

Query regulations by state and optional category. Returns regulation details including confidence levels, last-verified dates, amendments, and threshold data.

Query Parameters

Get all regulations for a state

curl "https://siteline.events/api/v1/regulations?state=TX" \
  -H "Authorization: Bearer sk_live_your_key_here"

# Response
{
  "regulations": [
    {
      "id": 123,
      "state": "TX",
      "state_name": "Texas",
      "category": "fire_occupancy",
      "follows_base_code": false,
      "confidence": "high",
      "last_verified": "2026-03-15",
      "headline": "Texas uses IFC with local amendments",
      "summary": "Texas adopts the IFC with...",
      "amendments": ["Amendment 1", "Amendment 2"],
      "thresholds": { ... },
      "code_ref": "IFC §3103"
    },
    ...
  ],
  "count": 14,
  "states_queried": ["TX"]
}

Filter by category

curl "https://siteline.events/api/v1/regulations?state=TX&category=tents" \
  -H "Authorization: Bearer sk_live_your_key_here"

Multiple states

curl "https://siteline.events/api/v1/regulations?state=TX,CA,NY&category=pyro" \
  -H "Authorization: Bearer sk_live_your_key_here"

Error Handling

All errors return a JSON object with an error field.