Developer portal

Build with the BuildSafe API.

Run Scouts Contractor Investigation™ programmatically. REST endpoints, webhook callbacks, snapshot diff feeds, and all 13 forensic modules — same engine that powers BuildSafe.app.

Read the docs Sign in to get API keys

REST + JSON

POST /v1/investigations, poll or webhook for results. Idempotent and rate-limited.

Webhooks

Completion and snapshot-diff events delivered to your endpoint with HMAC signing.

13 modules

License boards, court records, OSHA, DOL, permits, BBB, Yelp, Google, subcontractor network.

Quickstart

Three steps to your first investigation.

Full API reference →

1
Get an API key
API keys live in your dashboard and require an active Pro or API subscription.
Sign in to view keys

Create an investigation

POST contractor details. Scout returns a report_id and status_url.

cURL

curl -X POST https://www.getbuildsafe.com/api/public/v1/investigations \
  -H "Authorization: Bearer $BUILDSAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contractor_name": "Acme Construction LLC",
    "city": "Austin",
    "state": "TX",
    "license_number": "TX-123456"
  }'

Node.js

const res = await fetch(
  "https://www.getbuildsafe.com/api/public/v1/investigations",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BUILDSAFE_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      contractor_name: "Acme Construction LLC",
      city: "Austin",
      state: "TX",
    }),
  },
);
const { report_id, status_url } = await res.json();

Fetch the finished report

Poll the status URL or subscribe to a webhook for completion + snapshot-diff events.

cURL

curl https://www.getbuildsafe.com/api/public/v1/investigations/rpt_8f3a \
  -H "Authorization: Bearer $BUILDSAFE_API_KEY"

API plans

Pricing tiers for developers and platforms.

Starter

$299/mo

50 investigations / mo

Growth

$799/mo

200 investigations / mo

Scale

$2,499/mo

1,000 investigations / mo

API reference Talk to sales

Not a developer? Go back to BuildSafe