Snow load calculations per ASCE 7-16 and ASCE 7-22. Calculate balanced and unbalanced snow loads, drift loads, and rain-on-snow surcharge.
Calculate Snow Load (ASCE 7-16)
Calculate balanced and unbalanced snow loads per ASCE 7-16 Chapter 7.
Returns:
- Flat roof snow load (p_f)
- Sloped roof snow load (p_s)
- Design roof snow load
- Computed factors (Ce, Cs, Ct, Is)
- Rain-on-snow surcharge (where applicable)
- Snow drift loads for lower roofs and projections
Design Standard: ASCE 7-16, Chapter 7
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
projectIdstring · requiredClearCalcs project ID
attributesobject · requiredSnow load calculation attributes for ASCE 7-16
namestringOptional name for the calculation sheet
Responses
Calculation completed successfully
sheetIdstringUnique identifier for the calculation sheet
namestringName of the calculation sheet
standardstring · enumEnum values:ASCE 7-16statusstring · enumEnum values:solvedresultsobjectCalculated snow load results. Note: Additional output fields may be available beyond those documented here.
inputsobjectSummary of input parameters
Calculate Snow Load (ASCE 7-22)
Calculate balanced and unbalanced snow loads per ASCE 7-22 Chapter 7.
ASCE 7-22 includes updated thermal factor calculations based on roof R-value.
Returns:
- Flat roof snow load (p_f)
- Sloped roof snow load (p_s)
- Design roof snow load
- Computed factors (Ce, Cs, Ct)
- Rain-on-snow surcharge (where applicable)
- Snow drift loads for lower roofs and projections
Design Standard: ASCE 7-22, Chapter 7
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
projectIdstring · requiredClearCalcs project ID
attributesobject · requiredSnow load calculation attributes for ASCE 7-22
namestringOptional name for the calculation sheet
Responses
Calculation completed successfully
sheetIdstringUnique identifier for the calculation sheet
namestringName of the calculation sheet
standardstring · enumEnum values:ASCE 7-22statusstring · enumEnum values:solvedresultsobjectCalculated snow load results. Note: Additional output fields may be available beyond those documented here.
inputsobjectSummary of input parameters
Create Snow Load Sheet (ASCE 7-16)
Create a new ASCE 7-16 snow load calculation sheet without solving.
Use PATCH to update attributes and POST to /solve to calculate.
This is part of the multi-step workflow for iterative design.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
projectIdstring · requiredClearCalcs project ID
namestringOptional name for the calculation sheet
Responses
Sheet created successfully
sheetIdstring · uuid · requiredUnique identifier for the sheet
statusstring · enum · requiredCalculation status
Enum values:solvedunsolvederror
namestringName of the sheet
standardstring · enumDesign standard used
Enum values:ASCE 7-16ASCE 7-22createdAtstring · date-timeSheet creation timestamp
attributesobjectCurrent attribute values on the sheet
resultsobjectCalculated snow load results. Note: Additional output fields may be available beyond those documented here.
Create Snow Load Sheet (ASCE 7-22)
Create a new ASCE 7-22 snow load calculation sheet without solving.
Use PATCH to update attributes and POST to /solve to calculate.
This is part of the multi-step workflow for iterative design.
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
projectIdstring · requiredClearCalcs project ID
namestringOptional name for the calculation sheet
Responses
Sheet created successfully
sheetIdstring · uuid · requiredUnique identifier for the sheet
statusstring · enum · requiredCalculation status
Enum values:solvedunsolvederror
namestringName of the sheet
standardstring · enumDesign standard used
Enum values:ASCE 7-16ASCE 7-22createdAtstring · date-timeSheet creation timestamp
attributesobjectCurrent attribute values on the sheet
resultsobjectCalculated snow load results. Note: Additional output fields may be available beyond those documented here.
Get Snow Load Sheet
Retrieve a snow load sheet with its attributes and results (if solved).
Works with both ASCE 7-16 and ASCE 7-22 sheets - the sheet knows its standard.
path Parameters
sheetIdstring · requiredSheet UUID
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Snow load sheet details
sheetIdstring · uuid · requiredUnique identifier for the sheet
statusstring · enum · requiredCalculation status
Enum values:solvedunsolvederror
namestringName of the sheet
standardstring · enumDesign standard used
Enum values:ASCE 7-16ASCE 7-22createdAtstring · date-timeSheet creation timestamp
attributesobjectCurrent attribute values on the sheet
resultsobjectCalculated snow load results. Note: Additional output fields may be available beyond those documented here.
Update Snow Load Sheet
Update snow load attributes on an existing sheet.
Sheet must be re-solved after updates using POST /solve.
Accepts attributes for both ASCE 7-16 and 7-22 - the sheet will use the appropriate fields based on its template.
path Parameters
sheetIdstring · requiredSheet UUID
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Request Body
eaveToRidgeDistancenumber · min: 0Horizontal distance from eave to ridge (ft)
roofSlopenumber · min: 0 · max: 12Roof slope ratio (rise per 12 inches)
exposurestring · enumRoof exposure condition
Enum values:Fully ExposedPartially ExposedShelteredthermalConditionThermal condition (format depends on sheet's standard)
overrideDefaultsbooleanSet to true to override project defaults
riskCategorystring · enumBuilding risk category
Enum values:IIIIIIIVgroundSnowLoadnumber · min: 0Ground snow load (psf)
roughnessCategorystring · enumGround surface roughness
Enum values:BCDAbove tree lineAlaska no treesroofSurfacestring · enumRoof surface type
Enum values:Slippery surfacesObstructed or non-slippery surfacesroofInsulationRValuenumber · min: 0Roof insulation R-value (ASCE 7-22 only)
widthFactornumber · min: 0 · max: 1Width factor W2 (ASCE 7-22 only)
lowerRoofDriftsarray[]Lower roof drift configurations
projectionDriftsarray[]Projection drift configurations
commentsstringOptional notes or comments
Responses
Sheet updated successfully
sheetIdstringSheet UUID
statusstring · enumStatus after update (always unsolved until re-solved)
Enum values:unsolvedupdatedAttributesstring[]List of attribute names that were updated
Solve Snow Load Sheet
Trigger calculation for a snow load sheet and return results.
The sheet must have all required attributes set before solving.
path Parameters
sheetIdstring · requiredSheet UUID
Headers
Authorizationstring · requiredThe
Authorizationheader is used to authenticate with the API using your API key. Value is of the formatBearer YOUR_KEY_HERE.
Responses
Calculation completed successfully
sheetIdstringSheet UUID
statusstring · enumCalculation status
Enum values:solvederrorresultsobjectCalculated snow load results. Note: Additional output fields may be available beyond those documented here.