Get local remodeling cost estimates and turn one into a job.

The typical flow:

  1. Find a scope (a type of work) with GET /scopes or POST /search.
  2. Create an estimate for a zip code.
  3. Create a job from the estimate.

Basics

Base URL: https://api.clearestimates.com/cepia

Authentication. Send your API key in the x-api-key header on every request. Keys come from your Clear Estimates rep. You can only read and change the estimates and jobs your own key created.

Format. Requests and responses are JSON. Send Content-Type: application/json.

Errors. A failed request returns a 4xx or 5xx status with a JSON body that explains the problem, such as { "status": "fail", "message": "..." } or { "error": "..." }.

Check your key

curl -X POST "https://api.clearestimates.com/cepia/" -H "x-api-key: $API_KEY"

{ "status": "success", "api_key_valid": true }

Estimate levels

Every estimate is created at a level. Higher levels include more detail and are priced higher under your contract.

type Name What you get
1 Range A low–high price range per scope
2 Summary Range plus material, labor and total per cost category
3 Detail Summary plus every line item

Each new estimate counts as one estimate unit (EU). Re-fetching an existing estimate is free. You can upgrade an estimate to a higher level later.