Get credits

Read the finder or verifier credit balance of your Findymail account.

GET https://cotlet.dev/api/v1/findymail/credits

read

Returns the credits left for the type you ask for, the account email and has_capacity. has_capacity is only filled on usage-based plans, where false means the plan limit is reached; on credit-based plans it is null and the agent reads the credits number. Credits belong to the team owner, so every member sees the same balance. Reading the balance is free.

Parameters

Parameters: get_credits
NameTypeDescription
type string string finder (default) or verifier.

Request

cURL
curl https://cotlet.dev/api/v1/findymail/credits \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("findymail", "get_credits")
Node.js
const result = await cotlet.call('findymail', 'get_credits');
CLI
cotlet call findymail get_credits

Example response

JSON

{
  "credits": 4210,
  "email": "maya@yourname.com",
  "has_capacity": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.