Get spend limits

⚠️
Preview — this feature is being built; the design below is the spec.
GET https://app.syntic.ai/v1/organizations/spend_limits

Return every monthly usage-credit limit (organization, workspaces, groups and members) with this month’s spend against each. Plan-covered usage never counts towards these limits.

For how this fits into a full workflow, see Spend limits.

Headers

HeaderRequiredValue
AuthorizationYesBearer <admin key>: an Admin API key (sk_admin_...). Inference keys are refused with 403 admin_key_required. See Admin API keys.
syntic-betaYes, while in previewadmin-2026-11-01. Without it the call fails with 400 beta_required. See Versioning.

Query parameters

ParameterTypeDefaultDescription
scopestringorganization, workspace, member or group to narrow the response.

Response

200 OK, Content-Type: application/json

{
  "type": "spend_limits",
  "period": {
    "starting_at": "2026-11-01T00:00:00Z",
    "ending_at": "2026-12-01T00:00:00Z"
  },
  "credits_enabled": true,
  "multi_group_policy": "lower",
  "organization": {
    "monthly_limit_usd": "500.00",
    "spent_usd": "212.4031"
  },
  "workspaces": [
    {
      "workspace_id": "wrkspc_01JC0A2C4E6G8J0L2N4Q",
      "monthly_limit_usd": "400.00",
      "spent_usd": "198.1022"
    }
  ],
  "groups": [
    {
      "group_id": "grp_01JB4D6F8H0K2M4P6R8T",
      "name": "Contractors",
      "monthly_limit_usd": "20.00"
    }
  ],
  "members": [
    {
      "user_id": "user_01J9Y0A2C4E6G8J0L2N4",
      "monthly_limit_usd": null,
      "inherited_limit_usd": "20.00",
      "inherited_from_group_id": "grp_01JB4D6F8H0K2M4P6R8T",
      "effective_limit_usd": "20.00",
      "spent_usd": "6.2200"
    }
  ]
}
FieldTypeDescription
periodobjectThe current calendar month in UTC; every limit resets at its end.
multi_group_policystringhigher or lower: which group limit applies to a member in several limited groups.
groups[].monthly_limit_usdstringApplies to each member of the group separately, not to the group’s total.
members[].effective_limit_usdstring or nullThe limit enforced for that member.

Examples

curl -sS https://app.syntic.ai/v1/organizations/spend_limits \
  -H "Authorization: Bearer $SYNTIC_ADMIN_KEY" \
  -H "syntic-beta: admin-2026-11-01"

Errors

Errors use the error envelope and carry a request_id. Codes specific to this operation:

StatustypecodeWhen
400invalid_request_errorbeta_requiredThe syntic-beta header is missing.
401authentication_errorinvalid_api_keyThe admin key is missing, unknown, revoked or expired.
403permission_erroradmin_key_requiredAn inference key was used.
429rate_limit_errorrate_limitedToo many requests; wait for Retry-After. See Rate-limit headers.
Was this page helpful?