> ## Documentation Index > Fetch the complete documentation index at: https://developer.moltsets.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Billing > 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 ## OpenAPI ````yaml /openapi.json post /get_billing openapi: 3.1.0 info: title: MoltSets API version: 1.0.0 description: >- MoltSets is an identity resolution API. Use it to resolve emails, LinkedIn profiles, and IP addresses into enriched contact and company data, including business and personal emails, mobile phone numbers, and firmographic details. servers: - url: https://api.moltsets.com/api/v1/tools description: Production security: - bearerAuth: [] tags: - name: Search description: >- Search and filter company and business profiles by name, domain, industry, size, or revenue. - name: Get Valid Emails description: Resolve and enrich valid business and personal email addresses. - name: Get Carrier-Verified Mobile Phones description: Enrich carrier-verified mobile phone numbers. - name: Reverse Lookups description: Resolve an email address or LinkedIn URL to a full business profile. - name: Get Ad Audience description: >- Resolve identifiers to hashed email (HEM) and mobile advertising IDs (MAIDs) for audience matching. - name: Get LinkedIn description: Resolve an email address to its LinkedIn profile URL. - name: Get Company description: Resolve IP addresses to company data. - name: Account description: Account management tools. Free — do not consume credits. paths: /get_billing: post: tags: - Account summary: Get Billing description: >- 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 operationId: getBilling parameters: - $ref: '#/components/parameters/UserAgentHeader' requestBody: required: true content: application/json: schema: type: object description: No arguments required. Send an empty object. example: {} responses: '200': description: Success content: application/json: schema: type: object properties: results: type: object properties: plan: type: string description: Current plan identifier subscription_status: type: string enum: - active - none - cancelled - past_due description: Subscription status token_balance: type: integer description: >- Remaining token balance. `-1` when the account is unlimited. unlimited: type: boolean description: true if the account has unlimited tokens current_period_start: type: - string - 'null' format: date description: ISO 8601 start of the current billing period, or null. current_period_end: type: - string - 'null' format: date description: ISO 8601 end of the current billing period, or null. token_costs: type: object description: >- Token cost per tool call. Keys are tool names, values are integer token costs. additionalProperties: type: integer status: type: string example: ok metadata: $ref: '#/components/schemas/Metadata' example: results: plan: subscription_997 subscription_status: active token_balance: -1 unlimited: true current_period_start: '2026-07-09' current_period_end: '2026-08-09' token_costs: get_account: 0 get_billing: 0 get_usage: 0 business_email_to_sha256: 1 email_to_linkedin: 1 email_to_maid: 1 reverse_email_lookup: 1 ip_to_company: 1 linkedin_to_best_email: 1 linkedin_to_best_personal_email_usa: 1 linkedin_to_business_email: 1 linkedin_to_mobile_phone: 1 linkedin_to_personal_email_usa: 1 linkedin_to_sha256: 1 reverse_linkedin_lookup: 1 search_business_email_by_name: 1 search_business_profile_by_name: 1 search_companies: 1 search_linkedin_profile: 1 search_people: 1 status: ok metadata: fair_use: records_remaining_5h: 179999 records_reset_5h: '2026-07-15T18:53:16Z' records_remaining_1w: 899999 records_reset_1w: '2026-07-22T13:53:16Z' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorUnauthorized' '403': description: Forbidden — missing `User-Agent` header content: application/json: schema: $ref: '#/components/schemas/ErrorForbidden' '422': description: >- Invalid Input — malformed body, or a parameter is missing, malformed, or outside its allowed values content: application/json: schema: $ref: '#/components/schemas/ErrorInvalidInput' '429': description: >- Too Many Requests — burst guard (`rate_limited`). Account tools don't count toward the enrichment or search Fair Use limits. content: application/json: schema: $ref: '#/components/schemas/ErrorRateLimit' '500': description: >- 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. content: application/json: schema: $ref: '#/components/schemas/ErrorInternal' components: parameters: UserAgentHeader: name: User-Agent in: header required: true description: >- Identifies the calling client. Any non-empty value is accepted — MoltSets does not validate its contents. Requests without this header are rejected with `403 Forbidden` (`error.code`: `forbidden`). schema: type: string example: YOUR_APP_NAME/1.0 schemas: Metadata: type: object properties: fair_use: type: object description: >- Fair Use Policy headroom for the record limits that apply to this call. properties: records_remaining_5h: type: integer description: >- Records you can still request in the current rolling 5-hour window. records_reset_5h: type: string format: date-time description: ISO 8601 timestamp when the 5-hour records window resets. records_remaining_1w: type: integer description: >- Records you can still request in the current rolling 1-week window. records_reset_1w: type: string format: date-time description: ISO 8601 timestamp when the 1-week records window resets. tokens_used: type: integer description: >- 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: type: integer description: >- Token balance after this call. Present on token-bound (free) accounts only. personal_email_restricted: type: boolean description: >- 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. retry_after: type: integer description: >- 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: type: integer description: >- Phone tokens consumed by this call. `linkedin_to_mobile_phone` only; `0` on a `not_found`. phone_tokens_remaining: type: integer description: >- Phone tokens remaining after this call. `linkedin_to_mobile_phone` only. description: >- Per-call metadata. `fair_use` is always present on a tool call; the remaining fields appear only where they apply. ErrorUnauthorized: type: object description: The API key or OAuth token is missing, invalid, or revoked. properties: error: type: object properties: code: type: string example: unauthorized message: type: string example: Invalid API key. ErrorForbidden: type: object description: >- The request has no `User-Agent` header. Add one — any non-empty value is accepted. properties: error: type: object properties: code: type: string example: forbidden message: type: string ErrorInvalidInput: type: object description: >- The request body is malformed, or a parameter is missing, malformed, or outside its allowed values. properties: error: type: object properties: code: type: string example: invalid_input message: type: string example: Message describing the nature of the invalid input. ErrorRateLimit: type: object description: >- Rate or Fair Use limit. `rate_limited` is the burst/IP guard; `fair_use_limit_exceeded` means a Fair Use **record** window is exhausted (or, on the free tier, the one-time search trial); `fair_use_requests_exceeded` means the 5-hour **request** window is exhausted. The Fair Use codes carry `metadata.retry_after` and a `Retry-After` header. properties: error: type: object properties: code: type: string example: fair_use_limit_exceeded message: type: string example: Fair use record limit reached. Retry after the window resets. metadata: type: object properties: retry_after: type: integer description: >- Seconds until the binding window unlocks. Also sent as a `Retry-After` header. Absent when the limit is a plan condition rather than a window (free-tier search trial exhausted). ErrorInternal: type: object description: >- Returned when the call could not complete — usually because the endpoint is unavailable, though an oversized request can also cause it. Retry with a smaller request first. Never charged. properties: error: type: object properties: code: type: string example: internal_error message: type: string example: Unexpected connection error. metadata: type: object example: {} securitySchemes: bearerAuth: type: http scheme: bearer description: >- Pass your API key as a Bearer token. Keys follow the format `ms_XXXXXXXXXXX`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.