List Projects

GET

https://api-gateway.merge.dev/v1/projects

GET

/v1/projects

curl https://api-gateway.merge.dev/v1/projects \
     -H "Authorization: Bearer <token>"

{
  "next": null,
  "previous": null,
  "results": [
    {
      "budget_config": {
        "amount": 500,
        "enforcement_mode": "hard_limit",
        "period": "monthly",
        "alert_thresholds": [
          50,
          80,
          90
        ],
        "notification_emails": [
          "finance@acme.com"
        ],
        "notify_org_admins": true
      },
      "created_at": "2026-06-02T17:04:00Z",
      "description": "Customer support assistant.",
      "id": "8b6f2d4a-1c3e-4b5a-9f7d-2e0c6a8b4d91",
      "is_active": true,
      "name": "support-bot",
      "organization_id": "3f2b8c1e-6a4d-4e7f-9b21-5c8d0e7a4f13",
      "routing_policy": {
        "allowed_models": null,
        "allowed_providers": null,
        "axis": null,
        "created_at": "2026-06-02T17:04:00Z",
        "description": "Claude first, GPT-5.5 as the fallback.",
        "id": "c4e1a7b2-9d3f-4a6e-8b5c-1f2d3e4a5b6c",
        "model": null,
        "modified_at": "2026-06-02T17:04:00Z",
        "name": "support-bot routing policy",
        "priority_order": [
          {
            "model": "anthropic/claude-sonnet-4-6",
            "priority": 1
          },
          {
            "model": "openai/gpt-5.5",
            "priority": 2
          }
        ],
        "slug": null,
        "strategy": "PRIORITY"
      },
      "slug": "support-bot",
      "updated_at": "2026-09-14T09:30:00Z",
      "uses_organization_default_routing": false
    }
  ]
}

List the organization’s projects, oldest first, each with its routing policy and budget. Pass next as cursor to read the next page.

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

cursorstring or nullOptional

The next value from the previous page. Omit it for the first page.

limitintegerOptional1-100Defaults to 20

Maximum number of results to return, at most 100. Defaults to 20.

Response

The list of projects

nextstring or null

Cursor for the next page: pass it as cursor. Null on the last page.

previousstring or null

Always null: paging only goes forward.

resultslist of objects

The projects on this page.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

503

Service Unavailable Error