CraneCheckCraneCheck
Developer API

Build with CraneCheck

Integrate crane inspection data directly into your ERP, safety management, or project management systems. RESTful API with JSON responses, webhook events, and comprehensive documentation.

Request API AccessView Endpoints
🔑

API Key Auth

Simple Bearer token authentication. Generate and manage API keys from your CraneCheck dashboard.

📦

JSON REST API

Standard RESTful endpoints returning JSON. Consistent pagination, filtering, and error handling across all resources.

⚡

Webhooks

Real-time event notifications for inspections, deficiencies, lockouts, and certification expiry. Never poll again.

Authentication

All API requests require a Bearer token in the Authorization header. Generate API keys from your CraneCheck dashboard under Settings → API Keys. Keys are scoped to your organization and inherit the permissions of the user who created them.

Authorization: Bearer ck_live_a1b2c3d4e5f6...

⚠️ Keep your API keys secure. Never expose them in client-side code or public repositories. Rotate keys immediately if compromised via the dashboard.

Rate Limits

PlanRequests / MinuteRequests / DayWebhooks
Standard6010,0005 endpoints
Enterprise300100,000Unlimited

Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response.

API Endpoints

📋

Inspections

Create, retrieve, and manage crane inspection records

GET/api/v1/inspections
GET/api/v1/inspections/:id
POST/api/v1/inspections
PATCH/api/v1/inspections/:id
GET/api/v1/inspections/:id/pdf
🏗️

Equipment Registry

Manage crane and equipment inventory

GET/api/v1/equipment
POST/api/v1/equipment
GET/api/v1/equipment/:id/history
PATCH/api/v1/equipment/:id
⚠️

Deficiencies

Track and resolve inspection deficiencies

GET/api/v1/deficiencies
POST/api/v1/deficiencies/:id/resolve
GET/api/v1/deficiencies/stats
📊

Compliance & Reports

Generate audit-ready compliance documentation

GET/api/v1/reports/compliance
GET/api/v1/reports/fleet
GET/api/v1/certifications
🔔

Webhooks

Real-time event notifications

POST/api/v1/webhooks
GET/api/v1/webhooks
DELETE/api/v1/webhooks/:id

Code Examples

List completed inspections

curl -X GET "https://api.cranecheck.co/v1/inspections?status=completed&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "data": [
    {
      "id": "insp_8xK2mP9q",
      "equipment_id": "eq_3nR7vL",
      "type": "pre_shift",
      "status": "completed",
      "result": "pass",
      "inspector": {
        "name": "Mike Rodriguez",
        "certification": "CCO-2847"
      },
      "location": {
        "lat": 40.7128,
        "lng": -74.0060,
        "job_site": "Hudson Yards Tower 4"
      },
      "checklist_items": 42,
      "deficiencies": 0,
      "completed_at": "2026-03-30T07:15:00Z",
      "pdf_url": "/v1/inspections/insp_8xK2mP9q/pdf"
    }
  ],
  "pagination": {
    "total": 1247,
    "page": 1,
    "per_page": 10,
    "has_more": true
  }
}

Create a new inspection

curl -X POST "https://api.cranecheck.co/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "equipment_id": "eq_3nR7vL",
    "type": "pre_shift",
    "inspector_id": "usr_mR2x9p",
    "checklist": "osha_1926_1412",
    "job_site": "Hudson Yards Tower 4"
  }'

Webhook Events

Subscribe to real-time events to keep your systems in sync. Webhook payloads are signed with HMAC-SHA256 for verification. Failed deliveries are retried with exponential backoff (3 attempts).

inspection.completedFired when an operator submits a completed inspection
inspection.failedFired when an inspection contains critical deficiencies
deficiency.createdFired when a new deficiency is logged
deficiency.resolvedFired when a deficiency is marked resolved
equipment.lockoutFired when a crane is locked out due to failed inspection
certification.expiringFired 30 days before an operator certification expires

SDKs & Libraries

Node.js / TypeScript

npm install @cranecheck/sdkComing Soon

Python

pip install cranecheckComing Soon

C# / .NET

dotnet add package CraneCheck.SDKComing Soon

Ready to integrate?

API access is available on all paid plans. Request your API key and start building today.

Request API AccessTalk to Engineering