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

> Retrieve your MoltSets account details, including account name, current plan, account status, remaining credit balance, number of API keys, and user count. Use this to programmatically check account health, verify active status, or display account information inside your own application or dashboard.



## OpenAPI

````yaml /openapi.json post /get_account
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_account:
    post:
      tags:
        - Account
      summary: Get Account
      description: >-
        Retrieve your MoltSets account details, including account name, current
        plan, account status, remaining credit balance, number of API keys, and
        user count. Use this to programmatically check account health, verify
        active status, or display account information inside your own
        application or dashboard.
      operationId: getAccount
      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:
                      id:
                        type: string
                        description: Account ID
                      name:
                        type: string
                        description: Account name
                      status:
                        type: string
                        description: Account status
                        enum:
                          - active
                          - suspended
                      plan:
                        type: string
                        description: Current plan
                        enum:
                          - free
                          - starter
                          - growth
                          - unlimited
                      credit_balance:
                        type: integer
                        description: Remaining credits
                      unlimited:
                        type: boolean
                        description: true if the account has unlimited credits
                      api_key_count:
                        type: integer
                        description: Number of API keys on the account
                      user_count:
                        type: integer
                        description: Number of users on the account
                      created_at:
                        type: string
                        format: date-time
                        description: ISO 8601 account creation timestamp
                  status:
                    type: string
                    example: ok
                  metadata:
                    $ref: '#/components/schemas/Metadata'
              example:
                results:
                  id: '#######'
                  name: Account_Name
                  status: active
                  plan: subscription_97
                  token_balance: -1
                  unlimited: true
                  daily_result_limit: 15000
                  daily_results_used: 0
                  external_token_balance: 100
                  external_token_allowance: 500
                  external_tokens_purchased: 0
                  api_key_count: 2
                  user_count: 1
                  created_at: '2026-05-26T12:28:10Z'
                status: ok
                metadata:
                  tokens_used: 0
        '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`.

````