---
title: "Get the current user's available AI tokens"
method: GET
path: "/api/v1/aissistant/tokens"
tags: ["v1", "Usage"]
---

# Get the current user's available AI tokens

`GET /api/v1/aissistant/tokens`

## Request

- Base URL: `https://app.serpmantics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.serpmantics.com/api/v1/aissistant/tokens`
- Auth: HTTP bearer

Returns the number of AI tokens available to the authenticated user.

These tokens fund EVERY AI feature in SERPmantics — meta, outline,
intent, internal-links, EEAT, EEAT competitors, score, AND the
AISSistant prompts. The endpoint lives under /aissistant for
historical reasons but the balance is shared across all AI features.

Do NOT confuse with guide-creation credits (see /api/v1/credits).
For a combined view (credits + tokens) prefer /api/v1/credits.

## Response `200`

Successfully retrieved token balance

- object
  - `success` boolean
  - `tokens` number

## Other responses

- `401`: Unauthorized - Invalid or missing authentication
- `405`: Method not allowed
- `500`: Internal server error

---

[API](https://skmtc.dev/serpmantics/apis/api-serpmantics.md) · [All operations](https://skmtc.dev/serpmantics/apis/api-serpmantics/llms.txt) · [OpenAPI document](https://skmtc.dev/serpmantics/apis/api-serpmantics/revisions/885ab1bdaa96?raw)