---
title: "Get model config"
method: GET
path: "/api/governance/model-configs/{mc_id}"
tags: ["Governance"]
---

# Get model config

`GET /api/governance/model-configs/{mc_id}`

Returns a specific model configuration by ID.

## Path parameters

- `mc_id` string, required

## Response `200`

Successful response

- object
  - `model_config` ModelConfig — Model configuration with budget and rate limit settings
    - `id` string — Unique identifier for the model config
    - `model_name` string — Name of the model. Use `*` to match all models.
    - `provider` string — Provider name (optional - applies to all providers if not specified)
    - `scope` 'global' | 'virtual_key' | 'user' — Scope where this limit applies. `global` covers all traffic; `virtual_key` scopes to a single virtual key; `user` scopes to a single user (Enterprise only).
    - `scope_id` string, nullable — ID of the scope target (e.g. virtual key ID or user ID). Required when scope is not `global`.
    - `scope_name` string, nullable — Resolved human-readable name of the scope target (read-only, set by server).
    - `calendar_aligned` boolean — When true, all budgets reset at clean calendar boundaries (midnight UTC for day, Monday for week, 1st for month, Jan 1 for year).
    - `budgets` Budget[] — Budget configurations for this model limit. Each entry must have a unique reset_duration.
      - `id` string, required
      - `max_limit` number, required — Maximum budget in dollars
      - `reset_duration` string, required — Reset duration (e.g., "30s", "5m", "1h", "1d", "1w", "1M")
      - `calendar_aligned` boolean — When true, resets align to calendar period boundaries in UTC (not rolling from last reset)
      - `last_reset` string, date-time, required
      - `current_usage` number, required
      - `team_id` string — Team that owns this budget, when the budget is team-scoped
      - `virtual_key_id` string — Virtual key that owns this budget, when the budget is virtual-key-scoped
      - `provider_config_id` integer — Provider config that owns this budget, when the budget is provider-config-scoped
      - `config_hash` string, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `budget` Budget — Budget configuration
      - `id` string, required
      - `max_limit` number, required — Maximum budget in dollars
      - `reset_duration` string, required — Reset duration (e.g., "30s", "5m", "1h", "1d", "1w", "1M")
      - `calendar_aligned` boolean — When true, resets align to calendar period boundaries in UTC (not rolling from last reset)
      - `last_reset` string, date-time, required
      - `current_usage` number, required
      - `team_id` string — Team that owns this budget, when the budget is team-scoped
      - `virtual_key_id` string — Virtual key that owns this budget, when the budget is virtual-key-scoped
      - `provider_config_id` integer — Provider config that owns this budget, when the budget is provider-config-scoped
      - `config_hash` string, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `rate_limit` RateLimit — Rate limit configuration
      - `id` string, required
      - `token_max_limit` integer
      - `token_reset_duration` string
      - `token_current_usage` integer, required
      - `token_last_reset` string, date-time, required
      - `request_max_limit` integer, nullable
      - `request_reset_duration` string, nullable
      - `request_current_usage` integer, required
      - `request_last_reset` string, date-time, required
      - `config_hash` string, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `created_at` string, date-time — When this model config was created
    - `updated_at` string, date-time — When this model config was last updated

## Other responses

- `404` — Model config not found
- `500` — Internal server error

---

[API](https://skmtc.net/getbifrost/apis/bifrost-api.md) · [All operations](https://skmtc.net/getbifrost/apis/bifrost-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbifrost/bifrost-api/versions/f8cab88f64ea/schema)