# Your credits, plan and rate limit

`GET /api/v1/account`

Shows which key you are using, how many credits are left, your plan, the prices per result and your rate limit. A good first call to check that your key works.

**Credits:** Free.

## Example request

```bash
curl "https://moleman.io/api/v1/account" \
  -H "Authorization: Bearer $MOLEMAN_API_KEY"
```

## Example answer

```json
{
  "livemode": true,
  "key": {
    "name": "Clay",
    "prefix": "mm_live_Ab3x",
    "mode": "live"
  },
  "account": {
    "email": "you@yourcompany.com",
    "name": "Sam"
  },
  "credits": {
    "balance": 4210,
    "planCredits": 4000,
    "keptCredits": 210
  },
  "plan": {
    "id": "growth",
    "name": "Growth",
    "period": "monthly",
    "status": "active",
    "creditsPerMonth": 5000,
    "renewsAt": "2026-12-01T00:00:00.000Z"
  },
  "trial": null,
  "rateLimit": {
    "limit": 120,
    "remaining": 119,
    "resetSeconds": 60,
    "windowSeconds": 60
  },
  "limits": {
    "maxRowsPerRequest": 50000,
    "maxDeepSearchRows": 10000,
    "maxWaitSeconds": 30,
    "maxPageSize": 1000
  },
  "prices": {
    "verify": {
      "credits": 0.1,
      "charged": "you only pay when the email works (bad or unclear emails are free)"
    },
    "findEmail": {
      "credits": 1,
      "charged": "you only pay for emails that work (everything else is free)"
    }
  }
}
```

## Errors

| Status | Code | When |
| --- | --- | --- |
| 401 | [`missing_api_key`](/docs/errors#missing_api_key) | The request has no API key. |
| 401 | [`invalid_api_key`](/docs/errors#invalid_api_key) | The API key is not one of ours (a typo, a cut-off copy, or a key from another account that was deleted). |
| 401 | [`revoked_api_key`](/docs/errors#revoked_api_key) | The API key was revoked on the API page. Revoking takes effect at once. |
| 429 | [`rate_limited`](/docs/errors#rate_limited) | More than 120 requests in one minute with this key. |
| 500 | [`server_error`](/docs/errors#server_error) | Something broke on our side. Nothing was charged for it. |