API version 2026-08-06

Physical work,
as an API call.

The BotBoots API accepts real equipment-verification requests, persists their status and routes them into the launch operations workflow. Fulfilment is currently limited to approved private-beta partners.

BASE URLhttps://getbotboots.com/api/v1

Authentication

Bearer API key

Job endpoints require an API key. Pass it in the Authorization header. Keys are issued manually to launch partners; request one at [email protected].

Authorization: Bearer $BOTBOOTS_API_KEY

Required on every job

Assurance levels

Assurance determines who may execute the task. Jurisdiction is evaluated separately; a credential must be valid for the requested scope and location.

verified_operatorL1

Protocol-based evidence capture without technical opinion.

qualified_technicianL2

Trade-qualified or OEM-experienced functional and condition checks.

authorised_expertL3

Formal opinion or attestation by a locally authorised professional.

GET

/capabilities

Public

Returns the currently accepted action types, assurance levels and launch regions.

curl https://getbotboots.com/api/v1/capabilities

POST

/jobs

API key

Creates a real private-beta job request. Send an Idempotency-Key header when retrying the same request.

curl -X POST https://getbotboots.com/api/v1/jobs \
  -H "Authorization: Bearer $BOTBOOTS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lender-ref-1048" \
  -d '{
    "action": "equipment.verify",
    "asset": {
      "type": "excavator",
      "manufacturer": "Caterpillar",
      "model": "320",
      "serial_number": "known-or-null"
    },
    "location": {
      "country": "CH",
      "postal_code": "4051",
      "city": "Basel"
    },
    "assurance": {
      "level": "qualified_technician",
      "jurisdiction": "CH"
    },
    "sla_hours": 48,
    "customer_reference": "asset-1048"
  }'

201 response

{
  "job_id": "job_01J...",
  "status": "requested",
  "created_at": "2026-08-06T13:45:00.000Z",
  "action": "equipment.verify",
  "assurance": {
    "level": "qualified_technician",
    "jurisdiction": "CH"
  },
  "links": {
    "self": "https://getbotboots.com/api/v1/jobs/job_01J..."
  }
}

GET

/jobs/{job_id}

API key

Returns the current job state and, once available, its evidence and action receipt links.

curl https://getbotboots.com/api/v1/jobs/job_01J... \
  -H "Authorization: Bearer $BOTBOOTS_API_KEY"

Errors

Predictable failure modes

400

Invalid JSON, action, asset, location or assurance input.

401

Missing or invalid API key.

404

Job does not exist.

409

Idempotency key was reused with incompatible input.

503

Private-beta intake is temporarily unavailable.

Physical work,as an API call.