Skip to content
KelkiDevelopers

Account

Plan, limits and usage of the partner account.

Base URL: https://kelki.ai/api/v1.

GET /account

Read the account, plan and limits

Authentication: API key (Authorization: Bearer kk_…) or OAuth 2.0 token (scope catalog.read).

Responses

CodeDescriptionContent
200

The account.

application/json Account
401

Missing, invalid, expired or revoked credentials.

application/problem+json Problem

Response example

{
  "id": "acc_01JC00000000000000000000CC",
  "name": "Conciergerie Exemple",
  "mode": "test",
  "plan": "standard",
  "live_enabled": false,
  "limits": {
    "requests_per_minute": 120,
    "requests_per_day": 20000,
    "live_requests_per_day": 50,
    "agent_messages_per_day": 500,
    "webhook_endpoints": 5
  },
  "credential": {
    "type": "api_key",
    "prefix": "kk_test_Ab12Cd34",
    "scopes": [
      "catalog.read",
      "requests.read",
      "requests.write",
      "agent"
    ]
  }
}

GET /account/usage

Daily usage

Authentication: API key (Authorization: Bearer kk_…) or OAuth 2.0 token (scope catalog.read).

Parameters

NameInRequiredTypeDescription
fromqueryyesstring (date)
toqueryyesstring (date)

Responses

CodeDescriptionContent
200

Counters per day (92 days at most).

application/json UsageList
400

Malformed request (invalid JSON, unknown parameter, body too large).

application/problem+json Problem
401

Missing, invalid, expired or revoked credentials.

application/problem+json Problem

Response example

{
  "object": "list",
  "has_more": false,
  "next_cursor": null,
  "data": [
    {
      "date": "2026-11-11",
      "calls": 412,
      "rate_limited": 0,
      "errors": 3,
      "drafts_created": 9,
      "requests_transmitted": 7,
      "requests_sold": 4,
      "callbacks_confirmed": 2,
      "agent_messages": 31
    }
  ]
}

Schemas

Account

FieldTypeRequiredDescription
idstringyes
namestringyes

Name displayed in the e-mails sent to people. Set by Kelki.

modestringyes

values: test, live

planstringyes
live_enabledbooleanyes
limitsobjectyes
credentialobjectyes

Problem

Problem details (RFC 9457), with extension members.

FieldTypeRequiredDescription
typestring (uri)yes

Stable URI of the problem type; it leads to its documentation.

titlestringyes
statusintegeryes

min. 400 · max. 599

detailstringno
instancestring (uri-reference)no
codestringyes

Stable, machine-readable code.

values: invalid_json, invalid_parameter, payload_too_large, unsupported_media_type, invalid_credentials, expired_token, insufficient_scope, live_not_enabled, account_suspended, country_not_available, trade_not_available, not_found, invalid_state, idempotency_in_progress, idempotency_key_reused, validation_failed, consent_missing, consent_version_outdated, contact_limit_reached, duplicate_request, rate_limited, quota_exceeded, agent_paused, live_creation_paused, service_unavailable, internal_error

request_idstringyes
errorsarray of FieldErrorno

UsageList

Type: ListMeta and object

FieldError

FieldTypeRequiredDescription
pointerstringyes

JSON Pointer (RFC 6901) of the field at fault.

detailstringyes
allowedarray of stringno

Accepted values, when the list is closed.

ListMeta

FieldTypeRequiredDescription
objectstringyes

value: list

has_morebooleanyes
next_cursorstring | nullyes