API: Waivers & Locations

These endpoints let you read your organization details, list locations, and retrieve waivers and their versions. All require a valid Bearer token. See API Authentication for how to get one.

GET /v1/org

Returns basic info about the authenticated organization.

Required scope: any valid token

Example request:

curl https://waiverchaser.com/api/v1/org \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Example response:

{
  "id": "org_abc123",
  "name": "Apex Martial Arts",
  "createdAt": "2025-01-10T14:00:00.000Z",
  "updatedAt": "2026-02-01T09:00:00.000Z"
}

---

GET /v1/locations

Returns all active locations for your organization.

Required scope: waivers:read

Example request:

curl https://waiverchaser.com/api/v1/locations \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Example response:

{
  "data": [
    {
      "id": "loc_xyz789",
      "name": "Main Street",
      "createdAt": "2025-03-01T00:00:00.000Z"
    },
    {
      "id": "loc_def456",
      "name": "Downtown",
      "createdAt": "2025-06-15T00:00:00.000Z"
    }
  ],
  "total": 2
}

---

GET /v1/waivers

Returns all published waivers for your organization. Drafts and archived waivers are excluded.

Required scope: waivers:read

Example request:

curl https://waiverchaser.com/api/v1/waivers \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Example response:

{
  "data": [
    {
      "id": "waiver_111",
      "name": "Liability Waiver",
      "status": "active",
      "isDefault": true,
      "createdAt": "2025-01-15T00:00:00.000Z",
      "updatedAt": "2025-11-01T00:00:00.000Z",
      "latestVersion": {
        "id": "wv_001",
        "version": 3,
        "title": "Liability Waiver"
      }
    }
  ],
  "total": 1
}

---

GET /v1/waivers/:id

Returns a single waiver with all its published versions.

Required scope: waivers:read

Path parameter: id (the waiver ID)

Example request:

curl https://waiverchaser.com/api/v1/waivers/waiver_111 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Example response:

{
  "id": "waiver_111",
  "name": "Liability Waiver",
  "status": "active",
  "isDefault": true,
  "createdAt": "2025-01-15T00:00:00.000Z",
  "updatedAt": "2025-11-01T00:00:00.000Z",
  "versions": [
    {
      "id": "wv_001",
      "version": 3,
      "title": "Liability Waiver",
      "createdAt": "2025-11-01T00:00:00.000Z"
    },
    {
      "id": "wv_000",
      "version": 2,
      "title": "Liability Waiver",
      "createdAt": "2025-06-01T00:00:00.000Z"
    }
  ]
}

Returns 404 if the waiver doesn't exist or doesn't belong to your organization.