API reference › Resources
Models and credits
Model catalog with prices in credits, available providers, and the organization's balance and usage.
GET/api/models/catalog#
The platform's model catalog, with each model's price in credits.
curl https://doublex.ai/api/models/catalog -H "Authorization: Bearer $DOUBLEX_API_KEY"{
"platform": true,
"ready": true,
"autoModel": "openrouter/auto",
"policy": { "autoAllowed": ["anthropic/*", "openai/*", "google/*"], "autoCostTier": "medium" },
"models": [
{
"id": "anthropic/claude-sonnet-5.5",
"name": "Claude Sonnet 5.5",
"vendor": "anthropic",
"contextLength": 1000000,
"inputCreditsPerMillion": 300,
"outputCreditsPerMillion": 1500,
"description": "…"
}
]
}| Field | Description |
|---|---|
platform | true when the organization uses the platform's models, billed in credits. If it's false, the installation uses its own provider keys: see GET /api/providers. |
autoModel | The ID of DoubleX Auto, which picks the model for each message. |
policy | The model families and cost tier DoubleX Auto can use, set by the organization on the Models page. |
models[].id | The value to use in model in Chat and in triggers. |
models[].inputCreditsPerMillion, outputCreditsPerMillion | Price in credits per million input and output tokens. |
To use a catalog model in an agent, send provider: "openrouter" and model with the catalog ID in the agent PATCH, or use doublex agents update <id> --model <catalog id>.
GET/api/providers#
On installations where each organization uses its own provider keys, lists the providers, whether each one is ready for you, and the available models. It never returns the keys.
{
"providers": [
{
"id": "anthropic",
"label": "Anthropic",
"ready": true,
"scope": "organization",
"models": [{ "id": "claude-sonnet-5-5", "label": "Claude Sonnet 5.5" }],
"suggestedModels": []
}
]
}Use the provider id and the model id together (anthropic/claude-sonnet-5-5) in Chat and in agents.
GET/api/credits#
Credit balance and usage.
| Query | Description |
|---|---|
month | Month in YYYY-MM format. Default: the current month. |
agent | Only one agent's usage. |
source | Only usage from one source (for example, cli). |
curl "https://doublex.ai/api/credits?month=2026-10" -H "Authorization: Bearer $DOUBLEX_API_KEY"{
"platform": true,
"month": "2026-10",
"balance": 48210,
"spent": 1790,
"byAgent": [{ "id": "agt_8f3a2b1c9d0e", "name": "CRM Analyst", "credits": 920, "count": 41 }],
"bySource": [],
"byModel": [],
"daily": [],
"entries": []
}| Field | Description |
|---|---|
balance | The organization's current balance. |
spent | Credits used in the period. |
byAgent, bySource, byModel, daily | Grouped usage. |
entries | Ledger entries for the period, 20 per page (page parameter). |
Members see only their own usage; admins see the whole organization's. If platform is false, the installation doesn't use credits. Credits can only be added in the app, in Settings › Usage and credits.