Account status: plan, tokens and limits

Send Authorization: Bearer $CASAFARI_API_KEY: a platform API key (cf_sk_...) from the console, or an OAuth access token; X-API-Key carries the key too. See platform API keys. Free: 0 tokens.

Over MCP: account_status, on every product's server.

#Description

Free (uses no tokens).

#Example request

Placeholders only: replace the token and the values with your own.

curl "https://platform.casafari.com/v1/account" \
  -H "Authorization: Bearer $CASAFARI_API_KEY"

#Responses

#200 Success.

Type: object.

#Errors

Every error is an application/problem+json body (RFC 9457) with type (a page that explains it), title, status, detail (what to do), instance, code and request_id (what to quote to support). A 402 carries an upgrade_url, a 429 a Retry-After header. The codes each status can carry:

• 400 invalid_request, key_in_query (https://platform.casafari.com/errors/invalid-request, https://platform.casafari.com/errors/key-in-query)
• 401 unauthorized, invalid_credential, credential_revoked, token_expired (https://platform.casafari.com/errors/unauthorized, https://platform.casafari.com/errors/invalid-credential, https://platform.casafari.com/errors/credential-revoked, https://platform.casafari.com/errors/token-expired)
• 403 insufficient_scope, account_suspended (https://platform.casafari.com/errors/insufficient-scope, https://platform.casafari.com/errors/account-suspended)
• 404 not_found (https://platform.casafari.com/errors/not-found)
• 405 method_not_allowed (https://platform.casafari.com/errors/method-not-allowed)
• 429 rate_limited, request_limit_reached (https://platform.casafari.com/errors/rate-limited, https://platform.casafari.com/errors/request-limit-reached)
• 500 internal_error (https://platform.casafari.com/errors/internal-error)
• 503 unavailable (https://platform.casafari.com/errors/unavailable)

#Related pages

• Status of a payment link (GET /v1/account/payment-links/{payment_link_id})
• Read the current terms (GET /v1/signups/terms)
• Start a sign-up (POST /v1/signups)
• Finish a sign-up with the emailed code (POST /v1/signups/{signup_id}/verify)
• Account and sign-up REST API: all operations
• How to get a bearer token for the Casafari REST API
• MCP vs REST API compared