> ## 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

> Retrieve your MoltSets billing details, including your current plan, subscription status, remaining credit balance, billing period start and end dates, and the credit cost for each available tool. Use this to monitor spend, confirm renewal dates, or 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: >-
    Identity resolution API. Resolve emails, LinkedIn profiles, IP addresses,
    and emails into enriched contact and company data.
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: Get Full Business Profile
    description: Resolve identifiers to full business profiles and company firmographics.
  - name: Get Ad Audience
    description: >-
      Resolve identifiers to hashed email (HEM) and mobile advertising IDs
      (MAIDs) for audience matching.
  - 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: >-
        Retrieve your MoltSets billing details, including your current plan,
        subscription status, remaining credit balance, billing period start and
        end dates, and the credit cost for each available tool. Use this to
        monitor spend, confirm renewal dates, or display live billing
        information inside your own application.
      operationId: getBilling
      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
                        enum:
                          - free
                          - starter
                          - growth
                          - unlimited
                      subscription_status:
                        type: string
                        enum:
                          - active
                          - none
                          - cancelled
                          - past_due
                      credit_balance:
                        type: integer
                      unlimited:
                        type: boolean
                      current_period_start:
                        type:
                          - string
                          - 'null'
                        format: date-time
                      current_period_end:
                        type:
                          - string
                          - 'null'
                        format: date-time
                      token_costs:
                        type: object
                        description: >-
                          Credit cost per tool call. Keys are tool names, values
                          are integer credit costs.
                        additionalProperties:
                          type: integer
                  status:
                    type: string
                    example: ok
                  metadata:
                    $ref: '#/components/schemas/Metadata'
              example:
                results:
                  plan: free
                  subscription_status: none
                  credit_balance: 250
                  unlimited: false
                  current_period_start: null
                  current_period_end: null
                  token_costs:
                    linkedin_to_best_email: 1
                    linkedin_to_business_email: 1
                    linkedin_to_personal_email: 1
                    linkedin_to_mobile_phone: 10
                    get_account: 0
                    get_billing: 0
                    get_usage: 0
                status: ok
                metadata:
                  tokens_charged: 0
                  tokens_remaining: unlimited
                  daily_results_remaining: 9876
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
        '422':
          description: Invalid Input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInvalidInput'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorRateLimit'
components:
  schemas:
    Metadata:
      type: object
      properties:
        tokens_charged:
          type: integer
          description: >-
            Tokens consumed by this request. Always `0` when no data is
            returned.
        tokens_remaining:
          type: string
          description: >-
            Tokens remaining after this request. Number if on the free plan,
            'unlimited' if paid.
        daily_results_remaining:
          type: integer
          description: >-
            The number of 'results' remaining on your daily rate limit. Daily
            rate limit is unique per plan.
    ErrorBadRequest:
      type: object
      properties:
        error:
          type: string
          example: Bad Request
        message:
          type: string
          example: >-
            The server cannot process the request due to a client error (400 Bad
            Request).
    ErrorUnauthorized:
      type: object
      properties:
        error:
          type: string
          example: Unauthorized
        message:
          type: string
          example: Invalid API key.
    ErrorInvalidInput:
      type: object
      properties:
        error:
          type: string
          example: Invalid Input
        message:
          type: string
          example: Message describing the nature of the invalid input.
    ErrorRateLimit:
      type: object
      properties:
        error:
          type: string
          example: Too Many Requests
        message:
          type: string
          example: Rate limit exceeded. Maximum 100 requests per second.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Pass your API key as a Bearer token. Keys follow the format
        `ms_XXXXXXXXXXX`.

````