Get spend limits

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

Query Parameters

organization_id string optional

The organization to act in. Defaults to your current organization. You must be an active member of it, or the request is refused with 403 ORGANIZATION_ACCESS_DENIED.

Headers

X-Organization-Id string optional

The same as organization_id, as a header. When both are sent, the query parameter wins.

Returns

Amounts are CHF strings with two decimals ("12.50"). A limit of null is not set; a spend of null could not be read, never "0.00" in its place.

• currency string — always CHF.
• month string — the UTC calendar month the spend covers, YYYY-MM.
• organization object — the organization's limits and spend:
  • limit_chf string or null — the organization's own monthly limit for Aitronos servers.
  • compute_share_limit_chf string or null — the share of the monthly spending limit set aside for cloud servers, in CHF.
  • effective_limit_chf string or null — the tighter of limit_chf and compute_share_limit_chf: what the organization's Aitronos servers are held to. null when only the monthly spending limit applies.
  • monthly_limit_chf string — the organization's overall monthly spending limit. It always applies, and no limit here can be set above it.
  • member_default_chf string or null — the default monthly limit per person.
  • spent_chf string or null — the organization's Aitronos server spend this month. null when it could not be read, and always null when can_view_org_spend is false.
• me object or null — your own limits; null for a caller without a person (an organization API key):
  • user_id string — your user id.
  • admin_limit_chf string or null — what your organization allows you: the limit set for you, else the default per person.
  • self_limit_chf string or null — the limit you set on yourself.
  • effective_limit_chf string or null — the smaller of the two: the limit you are held to. null means no per-person limit applies.
  • limit_source string or null — which limit binds: self, override (set for you by someone who manages billing) or default. self wins a tie, then override. null with no limit.
  • spent_chf string or null — your Aitronos server spend this month.
  • remaining_chf string or null — what is left of your limit, never below "0.00". null with no limit or an unknown spend.
• spend_known boolean — false when a spend reading you may see failed; its spent_chf is then null and summary says so. The organization's spend counts only when can_view_org_spend is true.
• can_view_org_spend boolean — whether you may see the organization's spend (view_billing or manage_billing). When false, organization.spent_chf is null and summary names only the organization's limit, never its spend.
• can_edit_org_limits boolean — whether you may change the organization limit, the default per person and each person's limit (manage_billing).
• can_edit_own_limit boolean — whether you may set a limit on yourself (false for an organization API key).
• summary string — one line on spend against the limits, to show as is. Without can_view_org_spend the organization part reads, for example, "Your organization's monthly limit for Aitronos servers is CHF 40.00." (nothing when the organization has no limit).
• fields object — the inputs, keyed org_limit_chf, member_default_chf, member_limit_chf (the per-person input of the members list; its value is always null) and, for a person, self_limit_chf. Each carries label and help (sentences to show), value (the amount now stored, or null), min, max and step (CHF strings) and editable (boolean). max is the organization's monthly spending limit, and for self_limit_chf what the organization allows you.

{
  "currency": "CHF",
  "month": "2026-10",
  "organization": {
    "limit_chf": "40.00",
    "compute_share_limit_chf": null,
    "effective_limit_chf": "40.00",
    "monthly_limit_chf": "80.00",
    "member_default_chf": "12.50",
    "spent_chf": "3.20"
  },
  "me": {
    "user_id": "usr_7f3a9c2e1b8d4e6fa0c5b3d9e2f1a4c7",
    "admin_limit_chf": "12.50",
    "self_limit_chf": null,
    "effective_limit_chf": "12.50",
    "limit_source": "default",
    "spent_chf": "1.66",
    "remaining_chf": "10.84"
  },
  "spend_known": true,
  "can_view_org_spend": true,
  "can_edit_org_limits": true,
  "can_edit_own_limit": true,
  "summary": "You have spent CHF 1.66 of your CHF 12.50 monthly limit for Aitronos servers. Your organization has spent CHF 3.20 of its CHF 40.00 monthly limit for Aitronos servers.",
  "fields": {
    "org_limit_chf": {
      "label": "Organization limit for Aitronos servers",
      "help": "The most your whole organization can spend on Aitronos servers in a calendar month. Leave it empty for no separate limit: the organization's monthly spending limit still applies.",
      "value": "40.00",
      "min": "0.01",
      "max": "80.00",
      "step": "0.01",
      "editable": true
    },
    "member_default_chf": {
      "label": "Default limit per person",
      "help": "The most each person can spend on Aitronos servers in a calendar month, unless you set a different limit for them. Leave it empty for no default.",
      "value": "12.50",
      "min": "0.01",
      "max": "80.00",
      "step": "0.01",
      "editable": true
    },
    "member_limit_chf": {
      "label": "Limit for this person",
      "help": "Replaces the default limit for this person. Leave it empty to use the default.",
      "value": null,
      "min": "0.01",
      "max": "80.00",
      "step": "0.01",
      "editable": true
    },
    "self_limit_chf": {
      "label": "My limit",
      "help": "Set a lower limit for your own Aitronos servers. It can only be lower than what your organization allows you. Leave it empty to use the limit your organization set.",
      "value": null,
      "min": "0.01",
      "max": "12.50",
      "step": "0.01",
      "editable": true
    }
  }
}

Errors

curl "https://api.aitronos.com/v1/forge/compute/limits" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Response:

{
  "currency": "CHF",
  "month": "2026-10",
  "organization": {
    "limit_chf": "40.00",
    "compute_share_limit_chf": null,
    "effective_limit_chf": "40.00",
    "monthly_limit_chf": "80.00",
    "member_default_chf": "12.50",
    "spent_chf": "3.20"
  },
  "me": {
    "user_id": "usr_7f3a9c2e1b8d4e6fa0c5b3d9e2f1a4c7",
    "admin_limit_chf": "12.50",
    "self_limit_chf": null,
    "effective_limit_chf": "12.50",
    "limit_source": "default",
    "spent_chf": "1.66",
    "remaining_chf": "10.84"
  },
  "spend_known": true,
  "can_view_org_spend": true,
  "can_edit_org_limits": true,
  "can_edit_own_limit": true,
  "summary": "You have spent CHF 1.66 of your CHF 12.50 monthly limit for Aitronos servers. Your organization has spent CHF 3.20 of its CHF 40.00 monthly limit for Aitronos servers.",
  "fields": {
    "org_limit_chf": {
      "label": "Organization limit for Aitronos servers",
      "help": "The most your whole organization can spend on Aitronos servers in a calendar month. Leave it empty for no separate limit: the organization's monthly spending limit still applies.",
      "value": "40.00",
      "min": "0.01",
      "max": "80.00",
      "step": "0.01",
      "editable": true
    },
    "member_default_chf": {
      "label": "Default limit per person",
      "help": "The most each person can spend on Aitronos servers in a calendar month, unless you set a different limit for them. Leave it empty for no default.",
      "value": "12.50",
      "min": "0.01",
      "max": "80.00",
      "step": "0.01",
      "editable": true
    },
    "member_limit_chf": {
      "label": "Limit for this person",
      "help": "Replaces the default limit for this person. Leave it empty to use the default.",
      "value": null,
      "min": "0.01",
      "max": "80.00",
      "step": "0.01",
      "editable": true
    },
    "self_limit_chf": {
      "label": "My limit",
      "help": "Set a lower limit for your own Aitronos servers. It can only be lower than what your organization allows you. Leave it empty to use the limit your organization set.",
      "value": null,
      "min": "0.01",
      "max": "12.50",
      "step": "0.01",
      "editable": true
    }
  }
}