# Account Plan, limits and usage of the partner account. Base URL: `https://kelki.ai/api/v1`. - GET /account — Read the account, plan and limits - GET /account/usage — Daily usage ## GET `/account` Read the account, plan and limits Authentication: API key (`Authorization: Bearer kk_…`) or OAuth 2.0 token (scope `catalog.read`). ### Responses | Code | Description | Content | | `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 | Name | In | Required | Type | Description | | `from` | query | yes | string (date) | | | `to` | query | yes | string (date) | | ### Responses | Code | Description | Content | | `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` | Field | Type | Required | Description | | `id` | string | yes | | | `name` | string | yes | Name displayed in the e-mails sent to people. Set by Kelki. | | `mode` | string | yes | values: `test`, `live` | | `plan` | string | yes | | | `live_enabled` | boolean | yes | | | `limits` | object | yes | | | `credential` | object | yes | | ### `Problem` Problem details (RFC 9457), with extension members. | Field | Type | Required | Description | | `type` | string (uri) | yes | Stable URI of the problem type; it leads to its documentation. | | `title` | string | yes | | | `status` | integer | yes | min. 400 · max. 599 | | `detail` | string | no | | | `instance` | string (uri-reference) | no | | | `code` | string | yes | 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_id` | string | yes | | | `errors` | array of FieldError | no | | ### `UsageList` Type: ListMeta and object ### `FieldError` | Field | Type | Required | Description | | `pointer` | string | yes | JSON Pointer (RFC 6901) of the field at fault. | | `detail` | string | yes | | | `allowed` | array of string | no | Accepted values, when the list is closed. | ### `ListMeta` | Field | Type | Required | Description | | `object` | string | yes | value: `list` | | `has_more` | boolean | yes | | | `next_cursor` | string | null | yes | | ## About this page - URL : https://kelki.ai/developers/en/reference/account/ - Language : en - fr : https://kelki.ai/developers/fr/reference/account/ - en : https://kelki.ai/developers/en/reference/account/ - x-default : https://kelki.ai/developers/ - Portal : https://kelki.ai/developers/llms.txt