# Account status: plan, tokens and limits

> **Casafari is the AI agent-native real estate data intelligence platform.** The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries. Every property is one record with its full price and market history. [How the property graph is built](/docs/property-graph).

`GET https://platform.casafari.com/v1/account`

[REST API](/docs/rest) · [Account and sign-up](/docs/rest/account). Send `Authorization: Bearer $CASAFARI_API_KEY`: a platform API key (`cf_sk_...`) from [the console](https://platform.casafari.com/console), or an OAuth access token; `X-API-Key` carries the key too. See [platform API keys](/docs/rest#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.

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

## Responses

### 200 Success.

Type: `object`.

- `account_id` (string, required)
- `name` (string, optional)
- `plan` (object, required)
  - `id` (string, optional)
  - `label` (string, optional)
  - `billing_mode` (string, optional)
- `standing` (string, required)
- `can_call` (boolean, required)
- `blocked_reason` (string, optional, nullable)
- `reset_at` (string (date-time), optional, nullable)
- `request_limits` (object[], optional)
  - `window` (string, required) Values: `minute`, `session`, `day`, `week`, `month`, `locations`.
  - `unit` (string, required) Values: `requests`, `places`.
  - `limit` (integer, required)
  - `used` (integer, required)
  - `remaining` (integer, required)
  - `period_seconds` (integer, required)
  - `reset_at` (string (date-time), required)
- `claro_trial_searches` (object, optional, nullable)
  - `limit` (integer, required)
  - `used` (integer, required)
  - `remaining` (integer, required)
- `units` (object, required)
- `upgrade_url` (string (uri), optional, nullable)
- `console_url` (string (uri), optional)

### 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})](/docs/rest/account/status-of-a-payment-link)
- [Read the current terms (GET /v1/signups/terms)](/docs/rest/account/read-the-current-terms)
- [Start a sign-up (POST /v1/signups)](/docs/rest/account/start-a-sign-up)
- [Finish a sign-up with the emailed code (POST /v1/signups/{signup_id}/verify)](/docs/rest/account/finish-a-sign-up-with-the-emailed-code)
- [Account and sign-up REST API: all operations](/docs/rest/account)
- [How to get a bearer token for the Casafari REST API](/docs/rest)
- [MCP vs REST API compared](/docs/parity)