Merge API Documentation

{
  "data": [
    {
      "byok_usage": 4.1,
      "byok_usage_daily": 0.3,
      "byok_usage_monthly": 4.1,
      "byok_usage_weekly": 1.05,
      "creator_user_id": null,
      "disabled": false,
      "hash": "5f3c8a1e9b2d4f6a7c0e1b3d5f7a9c2e4b6d8f0a1c3e5b7d9f2a4c6e8b0d1f3a",
      "label": "mg_8Kx2pQr",
      "usage": 12.4,
      "usage_daily": 0.82,
      "usage_monthly": 12.4,
      "usage_weekly": 3.15,
      "allowed_models": [
        "anthropic/claude-sonnet-4-6",
        "openai/*"
      ],
      "budget_group_id": null,
      "created_at": "2026-06-02T17:04:00Z",
      "expires_at": null,
      "limit": 50,
      "limit_remaining": 37.6,
      "limit_reset": "monthly",
      "name": "customer-acme",
      "project_id": "8b6f2d4a-1c3e-4b5a-9f7d-2e0c6a8b4d91",
      "routing_policy_id": null,
      "updated_at": "2026-09-14T09:30:00Z"
    }
  ],
  "has_more": false,
  "object": "list"
}

Return the organization’s API keys, newest first, with their current usage. The management key’s organization is implied by the key itself. A page holds at most 100 keys; while has_more is true, advance offset to read the rest. Filter with project_id or disabled.

Authentication

AuthorizationBearer

A management key (mgmt_...), sent as Authorization: Bearer <key>. Reading /v1/routing-policies also accepts the organization’s gateway API keys; writing there needs a management key.

Query parameters

offsetintegerOptional>=0Defaults to 0

Number of keys to skip.

limitintegerOptional1-100Defaults to 100

Maximum number of keys to return (at most 100).

project_idstring or nullOptionalformat: "uuid"

Only keys scoped to this project.

disabledboolean or nullOptional

Only disabled keys (true) or only enabled keys (false).

Response

The list of API keys

datalist of objects

The keys on this page, newest first.

has_morebooleanOptionalDefaults to false

True when more keys remain beyond this page. Advance offset until it’s false.

object"list"OptionalDefaults to list

Always list.

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

503

Service Unavailable Error