Skip to content

Plan, credits used and credits left on the key's account.

This API endpoint enables you to get information regarding your Hunter account at any time.

Job account.usage

Your AI asks

checks the price first
telipot run hunter.account.usage \
  --input-json '{}' \
  --quote

Price

Free
Priced· before it runs

hunter.account.usage

FreeYour plan

Whose account it uses

1The person asking
not needed
2Your company’s Hunter plan
Selected identity for this example
3Our account
not used

What it sends

{

}

Your Hunter login is added for you. Your AI never sees it.

What it costs

Free

no charge from the provider

Preview the price first. --quote runs nothing.

For developers · run it

Shell · runs the task on the named account

telipot run hunter.account.usage \
  --input-json '{}'

No input. Run it as it is.

data

object

Full output schema · JSONNested fields and constraints

Output JSON Schema

{
  "type": "object",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "first_name",
        "last_name",
        "email",
        "plan_name",
        "plan_level",
        "reset_date",
        "team_id",
        "requests"
      ],
      "properties": {
        "first_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "last_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "email": {
          "type": "string"
        },
        "plan_name": {
          "type": "string"
        },
        "plan_level": {
          "type": "integer"
        },
        "reset_date": {
          "type": "string",
          "description": "ISO date the period's quota resets"
        },
        "team_id": {
          "type": "integer"
        },
        "requests": {
          "type": "object",
          "required": [
            "searches",
            "verifications"
          ],
          "properties": {
            "credits": {
              "type": "object",
              "description": "Present only when the team is on a unified credits bucket.",
              "required": [
                "used",
                "available",
                "remaining"
              ],
              "properties": {
                "used": {
                  "type": "number"
                },
                "available": {
                  "type": "number"
                },
                "remaining": {
                  "type": "number"
                },
                "over_quota": {
                  "type": "number"
                }
              }
            },
            "searches": {
              "type": "object",
              "required": [
                "used",
                "available",
                "remaining"
              ],
              "properties": {
                "used": {
                  "type": "number"
                },
                "available": {
                  "type": "number"
                },
                "remaining": {
                  "type": "number"
                },
                "over_quota": {
                  "type": "number"
                }
              }
            },
            "verifications": {
              "type": "object",
              "required": [
                "used",
                "available",
                "remaining"
              ],
              "properties": {
                "used": {
                  "type": "number"
                },
                "available": {
                  "type": "number"
                },
                "remaining": {
                  "type": "number"
                },
                "over_quota": {
                  "type": "number"
                }
              }
            }
          }
        },
        "calls": {
          "type": "object",
          "description": "Deprecated; use requests.",
          "properties": {
            "used": {
              "type": "number"
            },
            "available": {
              "type": "number"
            }
          }
        }
      }
    }
  }
}

A real answer

No example captured yet: one is recorded when telipot catalog verify passes.