Getting started

Approve Public API access, generate an organization key, and make the first request.

Public API access has two steps: an admin approves access, then the organization owner generates the secret key.

1. Ask support or an admin to approve access

An internal admin opens Dashboard Settings -> Admin -> Public API key and approves Public API access for the organization.

Approval does not create a secret yet. It only allows the owner to generate one.

2. Generate the key as the owner

The organization owner opens Settings -> Organization and finds the Public API key section.

If access is approved, the owner can generate the first key. The full key is shown only once. Save it immediately in a secure secret manager.

The key starts with a recognizable prefix such as:

klu_live_...

3. Test the key

Call GET /me first:

curl https://api.klupos.com/public-api/v1/me \
  -H "Authorization: Bearer klu_live_replace_me"

Expected result:

{
  "data": {
    "key": {
      "id": "key-id",
      "prefix": "klu_live_...",
      "last4": "WXYZ"
    },
    "organization": {
      "id": "organization-id",
      "name": "Example Dispensary",
      "stores": 2
    }
  }
}

4. Query business data

Start with these requests:

curl https://api.klupos.com/public-api/v1/stores \
  -H "Authorization: Bearer klu_live_replace_me"

curl "https://api.klupos.com/public-api/v1/sales?limit=10&status=PAID" \
  -H "Authorization: Bearer klu_live_replace_me"

curl "https://api.klupos.com/public-api/v1/analytics/revenue?from=2026-06-01T00:00:00.000Z&to=2026-06-24T23:59:59.999Z" \
  -H "Authorization: Bearer klu_live_replace_me"

5. Rotate if needed

If the key is lost or exposed, the owner can rotate it from Settings -> Organization. The old key stops working immediately and the new key is shown once.