---
title: "Check workspace access, allowances and balance for free"
method: GET
path: "/api/v1/account/status"
tags: ["Account"]
---

# Check workspace access, allowances and balance for free

`GET /api/v1/account/status`

## Request

- Base URL: `https://targetwise.ai`
- URL: `https://targetwise.ai/api/v1/account/status`
- Auth: HTTP bearer

Validates the connected workspace key and returns remaining free email/phone results, paid balance, usage budget and plan access. Free and read-only; does not retrieve contact or company data or trigger automatic top-up. Lookup readiness is advisory; concurrent calls can change it.

## Response `200`

Authenticated workspace snapshot. Available even when usage is exhausted; not a reservation.

- AccountStatus
  - `object` 'account_status', required
  - `request_id` string, required
  - `key_valid` true, required
  - `plan` string, required
  - `subscription_status` string, required
  - `billing_period` object, required
    - `starts_at` string, date-time, required
    - `ends_at` string, date-time, required
  - `free_allowance` object, required
    - `emails` object, required
      - `limit` integer, required
      - `used` integer, required
      - `remaining` integer, required
    - `business_phones` object, required
      - `limit` integer, required
      - `used` integer, required
      - `remaining` integer, required
  - `paid_balance` object, required
    - `currency` 'USD', required
    - `unit` 'usd_cents', required
    - `available_cents` integer, required
    - `included_remaining_cents` integer, required
    - `prepaid_remaining_cents` integer, required
    - `reserved_cents` integer, required
  - `evaluation_remaining_credits` integer, required
  - `usage_budget` object, required
    - `monthly_cap_cents` integer, nullable, required
    - `used_cents` integer, required
    - `reserved_cents` integer, required
    - `remaining_cents` integer, nullable, required
    - `resets_at` string, date-time, required
  - `data_access` object, required
    - `active` boolean, required
    - `reason` string, required
  - `lookup_readiness` object, required
    - `work_email` object, required
      - `can_call` boolean, required
      - `reason` string, required
      - `maximum_paid_charge_cents` integer, required
    - `business_phone` object, required
      - `can_call` boolean, required
      - `reason` string, required
      - `maximum_paid_charge_cents` integer, required
    - `email_and_phone` object, required
      - `can_call` boolean, required
      - `reason` string, required
      - `maximum_paid_charge_cents` integer, required
  - `operations` object[], required
    - `operation` 'company_prospecting' | 'contact_prospecting' | 'company_enrichment' | 'contact_enrichment' | 'work_email_lookup' | 'phone_lookup' | 'reverse_email_lookup' | 'company_search' | 'employee_prospecting' | 'employee_details' | 'company_autocomplete', required
    - `available_on_plan` boolean, required
    - `input_condition` object, nullable, required
  - `rates` object, nullable, required
    - `currency` 'USD', required
    - `email_cents` integer, required
    - `business_phone_cents` integer, required
  - `billing_url` string, uri, required
  - `message` string, required

## Other responses

- `400`: Invalid request or operation_pricing_unavailable. Adding credit does not enable an unpriced operation.
- `401`: A valid TargetWise bearer key is required.
- `402`: Free allowance or paid balance exhausted, or usage_budget_reached. A top-up does not increase the monthly usage budget.
- `403`: The workspace is inactive or access is restricted.
- `409`: Workspace usage could not be reserved. Inspect retryable before a bounded retry.
- `413`: The request body exceeds 64 KB.
- `415`: Use Content-Type: application/json.
- `429`: The workspace attempt/rate limit or provider limit has been reached.
- `500`: Unexpected internal error.
- `502`: The data connection returned an unusable response.
- `503`: The service or data connection is unavailable or unconfigured.
- `504`: The data connection timed out.

---

[API](https://skmtc.dev/targetwise/apis/targetwise-prospecting-enrichment-api.md) · [All operations](https://skmtc.dev/targetwise/apis/targetwise-prospecting-enrichment-api/llms.txt) · [OpenAPI document](https://skmtc.dev/targetwise/apis/targetwise-prospecting-enrichment-api/revisions/bd436a05769d?raw)