Get routing policy

GET

https://api-gateway.merge.dev/v1/customers/:customer_id/routing-policies/:policy_id

GET

/v1/customers/:customer_id/routing-policies/:policy_id

$ curl https://api-gateway.merge.dev/v1/customers/customer_id/routing-policies/policy_id \
>      -H "Authorization: Bearer <token>"

200Retrieved

1 {
2   "id": "2a1b3c4d-5e6f-4708-9a0b-1c2d3e4f5a6b",
3   "name": "workflow-a",
4   "description": "Primary workflow routing",
5   "strategy": "PRIORITY",
6   "is_default": true,
7   "allowed_providers": [
8     "openai",
9     "anthropic"
10   ],
11   "allowed_models": [
12     "openai/gpt-5.5",
13     "anthropic/claude-opus-4-8"
14   ],
15   "priority_order": [
16     {
17       "model": "openai/gpt-5.5",
18       "priority": 1
19     },
20     {
21       "model": "anthropic/claude-opus-4-8",
22       "priority": 2
23     }
24   ],
25   "axis": "COST",
26   "created_at": "2026-07-01T12:00:00Z",
27   "modified_at": "2026-07-01T12:00:00Z"
28 }

Authentication

AuthorizationBearer

Your production key sent as a bearer token.

Path parameters

customer_idstringRequired

policy_idstringRequired

Response

Successful Response

idstringOptional

namestringOptional

descriptionstring or nullOptional

Optional free-text description

strategyenumOptional

is_defaultbooleanOptional

Used when a request names no explicit policy.

allowed_providerslist of strings or nullOptional

allowed_modelslist of strings or nullOptional

priority_orderlist of objects or nullOptional

axisenum or nullOptional

Optimization axis the router optimizes for. Set for INTELLIGENT policies; null for PRIORITY.

created_atdatetimeOptional

modified_atdatetimeOptional