Credit usage history for your account | KINETK Graph Service API

Newest-first ledger entries (top-ups, settlements, refunds) for the account the key belongs to. Paginate with limit + cursor; scope to a single key with keyId.

Authentication

x-api-keystring

Customer secret key, required on every request. Validated natively by API Gateway; missing / invalid / revoked → 403.

Response headers

X-Kinetk-Credits-Useddouble

Credits consumed by this call (reserved estimate on a 202; actual once settled).

X-Kinetk-Credits-Remainingdouble

Account credit balance remaining after this call.

Response

Successful response

accountIdstring

usagelist of objects

keyIdstring

nextCursorstring

1	{
2	"accountId": "acc_9f8b7c6d5e4a3b2c1d0e",
3	"usage": [
4	{
5	"credits": 50,
6	"occurredAt": "2024-06-15T15:30:00Z",
7	"txnId": "txn_01F8Z2LZ9X7Y8Z3A4B5C6D7E",
8	"type": "topup",
9	"balanceAfter": 245.75,
10	"jobId": "job_9876543210fedcba",
11	"keyId": "key_1234567890abcdef",
12	"kind": "insights",
13	"reason": "Monthly subscription top-up",
14	"stripeDisputeId": "",
15	"stripePaymentIntentId": "pi_1GqIC8Lz0qyl6XeW3aX9b2cD",
16	"stripeRefundId": "",
17	"window": ""
18	}
19	],
20	"keyId": "key_1234567890abcdef",
21	"nextCursor": "cursor_20240615T153000Z_abcdef123456"
22	}

$	curl https://api.kinetk.ai/graph/usage \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json"