Get the organization

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

Return the organization the admin key belongs to: name, plan, credit settings, rate-limit tier and API-relevant settings. A good first call in any admin script, to confirm the key points where you expect.

For how this fits into a full workflow, see Organization info.

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.

Response

200 OK, Content-Type: application/json

{
  "id": "org_01J9Z1B3D5F7H9K1M3P5",
  "type": "organization",
  "name": "Acme Store",
  "plan": {
    "name": "Business",
    "status": "active",
    "current_period_end": "2026-12-01T00:00:00Z",
    "monthly_token_allowance": 2000000
  },
  "usage_credits": {
    "enabled": true,
    "balance_usd": "184.2200",
    "monthly_spend_limit_usd": "500.00",
    "auto_reload": {
      "enabled": true,
      "trigger_usd": "20.00",
      "target_usd": "100.00"
    }
  },
  "rate_limit_tier": "2",
  "settings": {
    "zero_data_retention": false,
    "data_retention_days": null,
    "mfa_required": true,
    "sso_enforced": false,
    "default_workspace_id": "wrkspc_01JC0A2C4E6G8J0L2N4Q"
  },
  "member_count": 14,
  "workspace_count": 3,
  "created_at": "2025-04-17T11:20:00Z"
}
FieldTypeDescription
plan.namestringThe plan exactly as named on the Syntic platform, such as Business or Scale.
plan.monthly_token_allowanceinteger or nullTokens included per month; null for unlimited.
usage_creditsobjectWhether credits are on, the balance, the monthly spend limit and auto-reload.
rate_limit_tierstringstart, 1 to 4, or custom.
settingsobjectRetention, second-factor and sign-in settings, and the default workspace.

Examples

curl -sS https://app.syntic.ai/v1/organizations/me \
  -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.
403permission_errorrole_requiredThe admin key’s creator does not have the role this needs.
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?