---
title: "Get account snapshot"
method: GET
path: "/v1/account"
tags: ["Account"]
---

# Get account snapshot

`GET /v1/account`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/account`
- Auth: HTTP bearer

Returns a read-only snapshot an agent can use to introspect itself:
tier, status, email domain, creation date, credit balance, the daily
request limits enforced by the rate limiter, and today's usage (UTC)
against those limits. Sourced from the same tier table the rate limiter
uses, the credit balance service, and the API request ledger.

## Response `200`

Account snapshot.

- object
  - `tier` string, required
  - `status` string, required
  - `email_domain` string, nullable
  - `created_at` string, date-time, nullable, required
  - `credits` object, required
    - `balance` number, float, required
    - `currency` string, required
  - `daily_limits` object, required: Daily request limits per namespace. -1 means unlimited.
    - `extract` integer
    - `platform` integer
    - `ingest` integer
    - `operations` integer
  - `usage_today` object, required: Requests made today (UTC) per namespace.
    - `extract` integer
    - `platform` integer
    - `ingest` integer
    - `operations` integer

## Other responses

- `401`: Missing or invalid API key.
- `429`: Daily rate limit exceeded.

---

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