Public API

Authentication

Every request must include your API key in the Authorization header. Keys are scoped to a single organization and can be revoked anytime.

Authorization: Bearer at_live_abc123...

List assets

GET /api/public/v1/assets — returns up to 200 assets per page.

curl https://salescollabassettrack.co.za/api/public/v1/assets \
  -H "Authorization: Bearer at_live_abc123..."

Query parameters: limit (1–200, default 50), offset (default 0), archived (true / false).

Get one asset

GET /api/public/v1/assets/:id

curl https://salescollabassettrack.co.za/api/public/v1/assets/<uuid> \
  -H "Authorization: Bearer at_live_abc123..."

Response shape

{
  "id": "uuid",
  "name": "MacBook Pro 14\"",
  "asset_tag": "LAP-0142",
  "serial_number": "C02XYZ...",
  "location": "Cape Town · Floor 2",
  "purchase_date": "2024-03-15",
  "purchase_cost": 38500,
  "replacement_value": 42000,
  "warranty_expires_on": "2027-03-15",
  "lifecycle_status": "in_service",
  "is_archived": false
}

Errors

• 401 — missing or invalid bearer token
• 403 — token revoked
• 404 — asset not found in this organization
• 429 — rate limited (60 requests / minute / key)