# Account balance (/account)

> GET /account returns your BestSERP credit balance, each credit grant with its expiry date, the next expiry and your rate limit. Free to call.

Source: https://bestserp.com/docs/account (updated 2026-11-14)

`GET /account` returns your balance and where it comes from. It costs nothing and is not rate limited like searches.

**Request**

```bash
curl 'https://api.bestserp.com/account' -H 'X-API-KEY: YOUR_API_KEY'
```

**200 OK**

```json
{
  "email": "you@example.com",
  "balance": 2997,
  "grants": [
    {
      "id": "c1f6f1d2-7a8e-4f0b-9a51-2d9a3c4b5e60",
      "source": "signup",
      "amount": 3000,
      "remaining": 2997,
      "expiresAt": "2026-12-14T09:00:00+00:00",
      "createdAt": "2026-11-14T09:00:00+00:00"
    }
  ],
  "nextExpiry": {
    "credits": 2997,
    "expiresAt": "2026-12-14T09:00:00+00:00"
  },
  "rateLimitPerMinute": 60
}
```

## Fields

| Field | Meaning |
| --- | --- |
| `email` | The account's email. |
| `balance` | Credits you can spend now. |
| `grants` | Each grant of credits: `source` (`signup`, `purchase`...), `amount`, `remaining`, `expiresAt` (null when it never expires). |
| `nextExpiry` | The soonest-expiring credits and when they expire. They are always spent first. |
| `rateLimitPerMinute` | Searches per minute allowed for the account. |

Every search response also carries `X-Credits-Remaining`, so you rarely need to poll this endpoint. See [credits](https://bestserp.com/docs/credits).
