---
title: "Account status and credit balance"
method: GET
path: "/account"
tags: ["Account"]
---

# Account status and credit balance

`GET /account`

## Request

- Base URL: `https://app.1lookup.io/api/v1`
- URL: `https://app.1lookup.io/api/v1/account`
- Auth: HTTP bearer

Returns the organization, subscription, credit balance and usage for the calling API key. Free: this call spends no credits.

## Response `200`

Account status.

- object
  - `success` true, required
  - `data` Account, required: Account status for the calling API key.
    - `user` object, required
      - `email` string, nullable: Email of the user who created the API key, or of the account owner.
    - `organization` object, required
      - `id` string
      - `name` string
      - `active` boolean
      - `created_at` string, date-time
    - `subscription` object, nullable, required: null when the account has no subscription.
      - `status` string: Subscription status, such as active or trialing.
      - `is_trial` boolean
      - `trial_end` string, nullable
      - `current_period_start` string, date-time
      - `current_period_end` string, date-time
      - `plan` object
        - `name` string
        - `tokens_per_month` integer: Credits the plan adds each month.
    - `tokens` object, required: Credit balance. `tokens` is the API's name for credits.
      - `subscription` object: This billing period's plan credits.
        - `total` integer
        - `used` integer
        - `available` integer
      - `rollover` integer: Credits carried over from earlier periods.
      - `purchased` integer: Credits bought separately.
      - `total_available` integer: Every credit the account can spend now.
    - `usage` object, required
      - `current_period` object
        - `lookups` integer
        - `tokens_consumed` integer
      - `all_time` object
        - `lookups` integer, nullable: null when the total could not be read.
        - `tokens_consumed` integer, nullable
    - `api_key` object, required
      - `id` string: Id of the calling API key. Empty when the call was not made with an API key.
      - `total_lookups` integer, nullable
      - `total_tokens_consumed` integer, nullable

## Other responses

- `401`: `UNAUTHORIZED`: Invalid or missing API key
- `403`: `UPGRADE_REQUIRED`: The account has no paid plan, and API access needs one. Upgrade at https://app.1lookup.io/billing?tab=plan
- `404`: `NOT_FOUND`: Resource not found
- `429`: `RATE_LIMIT_EXCEEDED`: Too many requests
- `500`: `INTERNAL_ERROR`: Internal server error
- `503`: `SERVICE_UNAVAILABLE`: The lookup service, or the API key check, is temporarily unavailable. Nothing was charged; retry after `Retry-After` seconds

---

[API](https://skmtc.dev/1lookup/apis/1lookup-api.md) · [All operations](https://skmtc.dev/1lookup/apis/1lookup-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1lookup/apis/1lookup-api/revisions/57b6d8ba04ac?raw)