Account API - Seamless

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

curl https://api.seamless.ai/api/client/v2/credits \
  -H "Token: $SEAMLESS_API_KEY"

Response (illustrative)

{
  "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.

API keys and OAuth
HTTP status codes