API features

Org Models Directory

One directory of every model your organization can use, with per-model compliance eligibility.

The Models page in the dashboard (Organization → Models) lists every model your organization can use in a single directory. It answers two questions for your whole team:

  • What can we call? — every catalogue model, searchable and filterable by capability, model family, price, and context size, exactly like the public models page.
  • What are we allowed to call? — when a provider compliance policy is active, each model is marked eligible or blocked using the same fail-closed evaluation Halfbill applies at request time.

Who can see it

Every active organization member can browse the directory read-only — including project-scoped developer members, who see it as their only organization page. This is the recommended way for developers to discover available models without being granted additional permissions.

Compliance eligibility

With an enabled compliance policy, the directory evaluates every model against the policy — data-policy requirements and model allow and deny lists:

  • Blocked models render greyed out with a ban icon; the tooltip lists the exact failing requirements (for example "Not on the allowed-models list").
  • An Eligible only filter narrows the directory to models Halfbill will actually serve.

The directory mirrors API enforcement — the same predicates decide both the markers on this page and the 403 responses at request time. If a model is marked blocked here, requests for it will be rejected while the policy is active.

Discover models with an API key

Call GET /v1/models with your API key to list models available under your organization's compliance policy, inherited team and member IAM rules, and the key's own IAM rules. Blocked models are omitted.

curl "https://api.halfbill.uk/v1/models" \
  -H "Authorization: Bearer $HALFBILL_API_KEY"

The endpoint also accepts the x-api-key header. Without either authentication header, it returns the public catalogue. Invalid, inactive, or expired credentials return 401.

Set ?include_restricted=true to return the full public catalogue even with an authenticated API key. This skips organization, team, member, key, project, and plan filtering for discovery. Other query filters still apply, and inference requests still enforce all access restrictions. The default is false, which keeps authenticated results filtered.

Existing query filters, including no_training, apply alongside access restrictions. Discovery reflects model permissions and project configuration; it does not check remaining credits or usage budgets.

Priority models

Model ids ending in -max (for example claude-sonnet-5-max) are the same underlying models with priority routing and better cache efficiency for coding agents. They are priced at 40% below list instead of the standard 50%. They are recommended only for Claude Code power users; use the regular id otherwise. Current prices are on the models page.

How is this guide?

On this page