Skip to content
Numes

API reference · List keys

Keys

List keys

List the account's inference keys with a management key, 100 per page.

GEThttps://api.numes.ai/api/v1/keys

Returns inference keys only. Page with offset; add include_disabled=true to include disabled keys. A management key sees the keys its creator may manage: organization members see keys they created, owners and administrators see all. Guide: Management keys.

Authorization

AuthorizationheaderRequired

Bearer management key. Management keys manage inference keys and cannot run inference. Authorization: Bearer $NUMES_MANAGEMENT_KEY

Headers

X-Request-Idstring

Correlation ID, not an idempotency key. Inference request IDs recorded with a generation are unique per account. A traffic-admitted request reusing a recorded ID returns 400 invalid_request. Traffic admission rejection takes precedence over this conflict, including for reused IDs; it performs no generation lookup and writes no generation, result or attempt. Rate-limit rejection returns 429 rate_limited with Retry-After; an inference limiter outage retains 500 server.

Length1–128

Query parameters

include_disabledboolean
Defaultfalse
offsetinteger
Default0
Range≥ 0

Responses

200API keysapplication/json

Headers

X-Request-Idstring

Correlation identifier assigned or accepted by the service.

BodyKeyListResponseapplication/json

dataarray<object>Required
Show15 child attributes
hashstringRequired
labelstringRequired
namestringRequired
disabledbooleanRequired
limitnumber | nullRequired
limit_remainingnumber | nullRequired
limit_resetenum<string> | nullRequired
One ofdailyweeklymonthly
usagenumberRequired
usage_dailynumberRequired
usage_weeklynumberRequired
usage_monthlynumberRequired
created_atstring<date-time>Required
updated_atstring<date-time> | nullRequired
expires_atstring<date-time> | nullRequired
billing_currencyenum<string>

Immutable settlement currency; omitted for management keys.

One ofUSDBTC
ErrorCompatible error envelopeapplication/json

Headers

X-Request-Idstring

Correlation identifier assigned or accepted by the service.

Retry-Afterinteger

Optional delay in seconds for retryable rate or availability errors.

Range≥ 1

BodyErrorResponseapplication/json

errorobjectRequired
Show3 child attributes
codeintegerRequired
messagestringRequired
metadataobject
openrouter_metadataobject