---
title: "Get account"
description: "The shop this API key belongs to: its domain, name, contact email, currency and time zone, the Filemonk plan it is on with the plan's limits (orders per cycle, file count, storage and bandwidth, in bytes), and the curren"
url: https://docs.filemonk.io/v2/api-reference/account/get-account/
api: "API v2 reference"
method: GET
path: "/account"
---

# Get account

`GET https://app.filemonk.io/api/v2/external/account`

The shop this API key belongs to: its domain, name, contact email, currency and time zone, the Filemonk plan it is on with the plan's limits (orders per cycle, file count, storage and bandwidth, in bytes), and the current billing cycle's usage (bytes uploaded, bytes downloaded, paid orders). Read-only; nothing about charges or money.

## Returns

- `id` (string, nullable, required): e.g. `acdfd70d-145e-4151-b88a-ce77a4108b43`
- `shopify_domain` (string, nullable, required): e.g. `example-store.myshopify.com`
- `name` (string, nullable, required): e.g. `Example Store`
- `email` (string, nullable, required): e.g. `shopper@example.com`
- `currency` (string, nullable, required): e.g. `INR`
- `time_zone` (string, nullable, required): e.g. `America/New_York`
- `plan` (object, required)
  - `name` (string, nullable, required): e.g. `pro_per_order`
  - `type` (string, nullable, required): e.g. `pro`
  - `order_limit` (integer, nullable, required): e.g. `2500`
  - `asset_count_limit` (integer, nullable, required): e.g. `10000`
  - `asset_storage_bytes` (integer, nullable, required): e.g. `1000000000000`
  - `bandwidth_bytes` (any, required)
- `usage` (object, required)
  - `uploaded_bytes` (integer, nullable, required): e.g. `217370`
  - `bandwidth_used_bytes` (integer, nullable, required): e.g. `800900`
  - `orders_count` (integer, nullable, required): e.g. `3`
- `created_at` (string, nullable, required): e.g. `2025-03-04T13:34:39Z`

Rate limit: this call costs 1 point ([rate limits](https://docs.filemonk.io/v2/errors-and-rate-limits/)).

## Example request

```sh
curl "https://app.filemonk.io/api/v2/external/account" \
  -H "X-Auth-Token: $FILEMONK_API_KEY"
```

## 200

Success: the requested resource.

```json
{
  "id": "acdfd70d-145e-4151-b88a-ce77a4108b43",
  "shopify_domain": "example-store.myshopify.com",
  "name": "Example Store",
  "email": "shopper@example.com",
  "currency": "INR",
  "time_zone": "America/New_York",
  "plan": {
    "name": "pro_per_order",
    "type": "pro",
    "order_limit": 2500,
    "asset_count_limit": 10000,
    "asset_storage_bytes": 1000000000000,
    "bandwidth_bytes": null
  },
  "usage": {
    "uploaded_bytes": 217370,
    "bandwidth_used_bytes": 800900,
    "orders_count": 3
  },
  "created_at": "2025-03-04T13:34:39Z"
}
```

## 401

Missing or invalid API key.

```json
{
  "errors": [
    "Invalid API key"
  ]
}
```

## 422

The request failed validation, or sent a key the action does not take (`code: "unknown_parameters"` with `unknown` and `accepted`). Nothing was saved.

```json
{
  "errors": [
    "access.download_limit_count must be an integer of at least 0"
  ],
  "field_errors": {
    "access.download_limit_count": [
      "must be an integer of at least 0"
    ]
  }
}
```

## 429

Rate limited. Cost-weighted per API key, shared with API v1: a read costs 1 point, a write 2, 40 points per fixed 60-second window. Every response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (Unix time the window ends); a 429 adds `Retry-After` (seconds), `retry_after`, `retryable: true` and a `next_step` in the body. A 429 did nothing: wait `retry_after` seconds, then send the same request again. The budget is per key, so every tool or script using the key shares it; prefer one list call with `per_page` over many single reads.

```json
{
  "errors": [
    "You have exceeded the rate limit of 40 points per 60 seconds. Read requests cost 1 point(s) and write requests cost 2 point(s). Please retry after 12 second(s)."
  ],
  "code": "rate_limited",
  "retry_after": 12,
  "error": "Rate limit exceeded",
  "message": "You have exceeded the rate limit of 40 points per 60 seconds. Read requests cost 1 point(s) and write requests cost 2 point(s). Please retry after 12 second(s)."
}
```