Get a project

{
  "id": "string",
  "organization_id": "string",
  "name": "string",
  "slug": "string",
  "description": "string",
  "is_active": true,
  "uses_organization_default_routing": true,
  "routing_policy": {
    "id": "string",
    "name": "string",
    "description": "string",
    "strategy": "PRIORITY",
    "allowed_providers": [
      "string"
    ],
    "allowed_models": [
      "string"
    ],
    "priority_order": [
      {
        "model": "openai/gpt-5.5",
        "priority": 1
      }
    ],
    "created_at": "2024-01-15T09:30:00Z",
    "modified_at": "2024-01-15T09:30:00Z"
  },
  "budget_config": {
    "amount": 100,
    "period": "daily",
    "enforcement_mode": "hard_limit",
    "alert_thresholds": [
      1
    ]
  },
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z"
}

Authentication

AuthorizationBearer

A management key (prefixed mgmt_), created in the dashboard under Settings, API keys, Management keys. Distinct from a regular gateway API key, and never used to call models.

Path parameters

project_idstringRequiredformat: "uuid"

Response

The project.

idstringformat: "uuid"

organization_idstringformat: "uuid"

namestring

slugstring

Derived from name; unique within the organization.

descriptionstring

is_activeboolean

uses_organization_default_routingboolean

True when the project routes via the org default policy (no scoped policy).

routing_policyobject or null

The project’s scoped routing policy. The id is stable across updates (updates apply in place).

budget_configobject or null

Project spending limit. hard_limit rejects requests with HTTP 402 once reached; soft_limit alerts only.

created_atdatetime

updated_atdatetime

Errors

404

Not Found Error

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