---
title: "Get Billing"
method: POST
path: "/get_billing"
tags: ["Account"]
---

# Get Billing

`POST /get_billing`

## Request

- Base URL: `https://api.moltsets.com/api/v1/tools`
- URL: `https://api.moltsets.com/api/v1/tools/get_billing`
- Auth: HTTP bearer

The Get Billing API retrieves your MoltSets billing details: current plan, subscription status, remaining credit balance, billing period start and end dates, and the credit cost for each available tool.

**Use this endpoint to:**
- Monitor spend against your plan
- Confirm your next renewal date
- Display live billing information inside your own application

## Headers

- `User-Agent` string, required

## Request body

- object: No arguments required. Send an empty object.

## Response `200`

Success

- object
  - `results` object
    - `plan` string: Current plan identifier
    - `subscription_status` 'active' | 'none' | 'cancelled' | 'past_due': Subscription status
    - `token_balance` integer: Remaining token balance. `-1` when the account is unlimited.
    - `unlimited` boolean: true if the account has unlimited tokens
    - `current_period_start` string, date, nullable: ISO 8601 start of the current billing period, or null.
    - `current_period_end` string, date, nullable: ISO 8601 end of the current billing period, or null.
    - `token_costs` object: Token cost per tool call. Keys are tool names, values are integer token costs.
  - `status` string
  - `metadata` Metadata: Per-call metadata. `fair_use` is always present on a tool call; the remaining fields appear only where they apply.
    - `fair_use` object: Fair Use Policy headroom for the record limits that apply to this call.
      - `records_remaining_5h` integer: Records you can still request in the current rolling 5-hour window.
      - `records_reset_5h` string, date-time: ISO 8601 timestamp when the 5-hour records window resets.
      - `records_remaining_1w` integer: Records you can still request in the current rolling 1-week window.
      - `records_reset_1w` string, date-time: ISO 8601 timestamp when the 1-week records window resets.
    - `tokens_used` integer: Tokens consumed by this call. `0` on a `not_found`. Present on token-bound (free) accounts only — accounts on an unlimited subscription omit it.
    - `tokens_remaining` integer: Token balance after this call. Present on token-bound (free) accounts only.
    - `personal_email_restricted` boolean: Present and `true` only when the call actually withheld personal-email data because the account does not have the personal-email surface. Read a missing personal email as a plan boundary, not as absent data.
    - `identity_hashes_restricted` boolean: Present and `true` only when the call stripped `business_email_sha256s` because the account is on the \$397 or \$997 plan. Read a missing SHA256 hash as a plan boundary, not as absent data.
    - `retry_after` integer: Seconds until the binding Fair Use window unlocks. Present on Fair Use 429s, and on a batch that returned partial results because items were dropped for Fair Use — the same value is sent as a `Retry-After` header.
    - `phone_tokens_used` integer: Phone tokens consumed by this call. `linkedin_to_mobile_phone` only; `0` on a `not_found`.
    - `phone_tokens_remaining` integer: Phone tokens remaining after this call. `linkedin_to_mobile_phone` only.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden — missing `User-Agent` header
- `422`: Invalid Input — malformed body, or a parameter is missing, malformed, or outside its allowed values
- `429`: Too Many Requests — burst guard (`rate_limited`). Account tools don't count toward the enrichment or search Fair Use limits.
- `500`: Internal Server Error — the call could not complete. Usually the endpoint is temporarily unavailable, but an oversized request can also cause it. Retry with a smaller request first; the MoltSets team is alerted automatically.

---

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