Account

Who this key belongs to

GET/v1/me

The first call to make. Confirms the key works, which mode it is in, and what it is allowed to do. Needs no permission beyond a valid key.

Permission: none beyond a valid key

Response

{
  "object": "account",
  "id": "e1b9c4e2-1f4e-4b0b-9f5a-2c1d0f7a41c8",
  "slug": "acme-dialer",
  "name": "Acme Dialer",
  "status": "test",
  "mode": "test",
  "country": "BE",
  "onboarding": {
    "kyb_status": "submitted",
    "agreement_signed": false,
    "agreement_version": null
  },
  "key": {
    "id": "b0a1…",
    "label": "Production backend",
    "prefix": "kls_test_",
    "last_four": "9f2c",
    "scopes": [
      "customers:read",
      "customers:write"
    ],
    "expires_at": null
  },
  "limits": {
    "requests_per_minute": 120,
    "burst": 240,
    "concurrent_calls": 3,
    "max_customers": null
  },
  "customers": {
    "count": 4
  }
}

Where you can sell

GET/v1/coverage

Every country Kleos opens, and whether it is open TODAY. Ask this before you quote, not after: two of the live-gate blockers are otherwise only discovered at the first dial, by which point you have already promised somebody a date. Needs no permission beyond a valid key.

Permission: none beyond a valid key

Parameters

Response

{
  "object": "list",
  "data": [
    {
      "object": "coverage",
      "country": "BE",
      "status": "not_yet",
      "sellable": false,
      "calling_language": "nl-BE",
      "number_route": "carrier",
      "numbers_available": 2,
      "waiting_on": "kleos",
      "summary": "BE is not open yet. Kleos has work to finish first.",
      "blockers": [
        {
          "code": "calling_rules_not_cleared",
          "message": "The calling rules for BE are still under legal review and have not been cleared for live traffic.",
          "waiting_on": "kleos"
        },
        {
          "code": "human_speech_gate_closed",
          "message": "Kleos has not yet certified that its own delivery is good enough to put in front of a stranger in this country's calling language.",
          "waiting_on": "kleos"
        }
      ]
    }
  ],
  "summary": {
    "total": 17,
    "live": 0,
    "not_yet": 17,
    "blocked": 0,
    "unknown": 0,
    "live_countries": []
  },
  "version": "coverage-2026-08-05.2"
}