Account
Plan, limits and usage of the partner account.
Base URL: https://kelki.ai/api/v1.
GET /account— Read the account, plan and limitsGET /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: |
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: |
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: |
has_more | boolean | yes | |
next_cursor | string | null | yes |