> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seamless.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Account API

> Authenticated user, credit balances, feature access flags, and reference values such as contact statuses, email accounts, and footers. Free.

The Account API tells your integration who is calling, what they can do, and how many credits they have left. Call it at startup to choose which features to show, and before large jobs to check the balance.

> **Credits**
>
> Free

> **Version**
>
> `/oauth/*` on v1 and v2. Everything else on v2.

## Identity and access

| Method | Path | Description |
| - | - | - |
| `POST` | `/oauth/accessToken` | Exchange an OAuth code or refresh token for an access token |
| `GET` | `/oauth/me` | Get the authenticated user |
| `GET` | `/features` | Feature access flags for the organization (v2) |
| `GET` | `/credits` | Remaining credit balance by category, with refresh dates (v2) |

## Reference values (v2)

| Method | Path | Description |
| - | - | - |
| `GET` | `/contact-statuses` | Contact statuses configured for the org |
| `GET` | `/engagement-statuses` | Engagement statuses |
| `GET` | `/email-accounts` | Connected sending mailboxes |
| `GET` | `/email-footers` | Email footers |

## Example: check credits before a job

```bash theme={null}
curl https://api.seamless.ai/api/client/v2/credits \
  -H "Token: $SEAMLESS_API_KEY"
```

```json Response (illustrative) theme={null}
{
  "success": true,
  "data": {
    "CATEGORY_NAME": { "remaining": 9500, "refreshesAt": "2026-11-01T00:00:00Z" }
  }
}
```

On v1, read the `X-PublicAPI-Credits` header on any authenticated response. See [Rate limits and credits](/rate-limits-and-credits).

## Related

* [API keys](/authentication/api-keys) and [OAuth](/authentication/oauth)
* [HTTP status codes](/api-http-status-codes)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.