Skip to main content
GET
List pricing rules

Authorizations

Authorization
string
header
required

An access token from Barndoor's identity provider, sent as Authorization: Bearer <token>. Use a service-account token from the OAuth 2.0 client-credentials grant for scripts and CI, or a signed-in user's token. The caller needs the admin role in the organization. Gateway API keys (bd-...) are not accepted here.

Response

OK

effective_from
string<date-time>
required

When this version takes effect. The version with the latest effective_from in the past is the one billed.

id
string<uuid>
required
input_cost_per_million_tokens
number<double>
required
model_pattern
string
required
org_id
string<uuid>
required
output_cost_per_million_tokens
number<double>
required
change_source
enum<string>
required

How a pricing version was created: admin_create, admin_edit, admin_schedule, import, sync_manual, sync_auto, admin_archive, or admin_restore.

Available options:
admin_create,
admin_edit,
admin_schedule,
import,
sync_manual,
sync_auto,
admin_archive,
admin_restore
is_archived
boolean
required

True for the version that archived the rule. Archived rules are excluded from GET /admin/model-pricing.

sync_mode
enum<string>
required

How the rule reacts to changes in Barndoor's default pricing.

Available options:
tracking,
pinned,
auto
scheduled_count
integer<int64>
required

Future-dated versions waiting to activate.

version_count
integer<int64>
required

Total versions in this rule's history, including the current one.

cache_read_cost_per_million_tokens
number<double> | null

Rate for input tokens read from the prompt cache. Null means cached input is billed at the input rate.

cache_write_cost_per_million_tokens
number<double> | null

Rate for input tokens written to the prompt cache. Null means no separate rate.

catalog_slug
string | null

Catalog slug for provider-level pricing (e.g. "openai", "aws_bedrock").

long_context
null | object

Optional higher rate set for large prompts.

model_provider
string | null
provider_id
string<uuid> | null

Optional reference to a specific LLM Gateway provider instance.

provider_name
string | null
change_reason
string | null

Free-text note recorded with this version.

created_by_email
string | null
created_by_name
string | null
created_by_user_id
string<uuid> | null
next_scheduled_effective_from
string<date-time> | null

When the next scheduled version takes effect, if any.