Getting Started

Copy page

Calcs.com API

The Calcs.com API provides structural engineering calculations and geospatial data through a simple REST interface.

What You Can Do

Structural Calculations

Run engineering calculations programmatically:

• Wood Beam Analysis - US timber beams per NDS 2018 (ASD)
• Create projects to organize your calculations
• Get pass/fail results with utilization ratios

Geospatial Data (GIS)

Access location-based design parameters:

• Wind Speeds - ASCE 7-16 (US), Eurocode (EU)
• Elevation - Global terrain data
• Terrain Classification - Roughness categories
• Design Regions - Code-specific zones

Quick Example

Calculate a wood beam using the multi-step workflow:

Code
 
# Step 1: Create sheet
curl -X POST "https://api.calcs.com/v1/timber-beam/sheets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "your-project-id",
    "preset": "floorJoist",
    "name": "Living Room Joist"
  }'
# Returns: {"sheetId": "abc123...", "status": "unsolved"}

# Step 2: Set attributes
curl -X PATCH "https://api.calcs.com/v1/timber-beam/sheets/abc123..." \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "Database",
    "L_X": 14,
    "member": "2x10 DF-L No.2",
    "supports": [
      ["Pinned", 0, 1.5],
      ["Pinned", 14, 1.5]
    ],
    "loadsDist": [
      ["Distributed Load", 0, 14, {"D": [15], "L": [40]}]
    ]
  }'

# Step 3: Solve
curl -X POST "https://api.calcs.com/v1/timber-beam/sheets/abc123.../solve" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

Code
 
{
  "sheetId": "abc123...",
  "status": "solved",
  "results": {
    "passed": true,
    "utilizationRatio": 0.76
  }
}

API Structure

Endpoint Group	Purpose
/v1/projects	Create and manage projects
/v1/timber-beam/*	Wood beam calculations
/gis/*	Geospatial data queries

Next Steps

• Authentication - Set up your API key
• Quick Start - Create your first calculation
• API Reference - Full endpoint documentation

Support

• Email: [email protected]
• Website: calcs.com/support