Developer Documentation

API Reference

Integrate engineering criteria data directly into your tools. RESTful API with JSON responses and comprehensive documentation.

Fast Response

<200ms avg latency

Secure

API key authentication

RESTful

JSON responses

Quick Start

curl -X GET "https://api.engineeringcriteria.com/v1/lookup?lat=34.0522&lng=-118.2437" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Sample Response

{
  "location": {
    "latitude": 34.0522,
    "longitude": -118.2437,
    "elevation_ft": 285,
    "jurisdiction": "Los Angeles County"
  },
  "wind": {
    "ultimate_wind_speed_mph": 95,
    "exposure_category": "C",
    "kd": 0.85,
    "kzt": 1.0,
    "source": "ASCE 7-22"
  },
  "seismic": {
    "sds": 1.15,
    "sd1": 0.52,
    "seismic_design_category": "D",
    "risk_category": "II",
    "site_class": "D",
    "source": "USGS"
  },
  "climate": {
    "ground_snow_load_psf": 0,
    "frost_depth_inches": 0,
    "climate_zone": "3B",
    "design_temp_heating_f": 43,
    "design_temp_cooling_f": 91
  },
  "hazards": {
    "flood_zone": "X",
    "fire_hazard_severity": "Moderate",
    "tsunami_zone": false
  }
}

Endpoints

GET/api/v1/lookup

Retrieve all engineering criteria for a location

Parameters

latnumberrequiredLatitude coordinate
lngnumberrequiredLongitude coordinate
risk_categorystringBuilding risk category (I, II, III, IV). Defaults to II
GET/api/v1/wind

Get wind design parameters only

Parameters

latnumberrequiredLatitude coordinate
lngnumberrequiredLongitude coordinate
exposurestringExposure category (B, C, D). Auto-detected if omitted
GET/api/v1/seismic

Get seismic design parameters only

Parameters

latnumberrequiredLatitude coordinate
lngnumberrequiredLongitude coordinate
site_classstringSite class (A-F). Uses default D if omitted
risk_categorystringRisk category (I-IV). Defaults to II
GET/api/v1/climate

Get climate and environmental data

Parameters

latnumberrequiredLatitude coordinate
lngnumberrequiredLongitude coordinate
GET/api/v1/hazards

Get hazard zone information (flood, fire, tsunami)

Parameters

latnumberrequiredLatitude coordinate
lngnumberrequiredLongitude coordinate
POST/api/v1/batch

Process multiple locations in a single request

Parameters

locationsarrayrequiredArray of {lat, lng} objects (max 100)
fieldsarraySpecific fields to return. Returns all if omitted

Authentication

All API requests require authentication using an API key. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API keys are available with Professional and Team plans.View pricing

Rate Limits

Free

10

requests/day

Professional

500

requests/month

Team

Unlimited

requests

Ready to integrate?

Get your API key and start making requests in minutes. Full documentation and SDKs available.