Account

Download schema

Account details, credits, and workspace settings

Get Account

GET

https://api.tomba.io/v1

/me

X-Tomba-Key (header)

+X-Tomba-Secret (header)

Returns information about the current account.

Get Account › Responses

Account information retrieved successfully

Account

object

Account details and subscription information

GET/me

curl https://api.tomba.io/v1/me \
  --header 'X-Tomba-Key: <api-key>' \
  --header 'X-Tomba-Secret: <api-key>'

Example Responses

{
  "data": {
    "user_id": 1,
    "secret_token": "ts_xxxxxxxxxxxx",
    "role": 0,
    "confirmed": true,
    "blocked": false,
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "phone": "+1234567890",
    "image": "https://example.com/avatar.jpg",
    "deleted": false,
    "provider": "local",
    "timezone": "America/New_York",
    "newsletter": true,
    "activity": true,
    "title": "Software Engineer",
    "country": "US",
    "created_at": "2024-01-01T00:00:00Z",
    "pricing": {
      "name": "Growth",
      "pricing_id": 3,
      "available_searches": 5000,
      "available_verifications": 5000,
      "available_phones": 100,
      "available_leads": 10000,
      "available_list": 100,
      "available_attr": 50,
      "available_keys": 5,
      "available_teams": 5,
      "available_b2b": 100,
      "available_sources": 5000,
      "available_email_count": 5000,
      "frequency": "monthly"
    },
    "requests": {
      "domains": {
        "available": 4500,
        "used": 500
      },
      "verifications": {
        "available": 4800,
        "used": 200
      },
      "phones": {
        "available": 95,
        "used": 5
      },
      "b2b": {
        "available": 100,
        "used": 0
      }
    }
  }
}

json

application/json

Retrieve API Usage

GET

https://api.tomba.io/v1

/usage

X-Tomba-Key (header)

+X-Tomba-Secret (header)

Retrieve current API usage information.

Retrieve API Usage › Responses

API usage details.

Usage

requests

integer · required

Number of API requests made in the current period

limit

integer · required

Maximum number of requests allowed in the period

resetAt

string · date-time · required

Timestamp when the usage counter resets

GET/usage

curl https://api.tomba.io/v1/usage \
  --header 'X-Tomba-Key: <api-key>' \
  --header 'X-Tomba-Secret: <api-key>'

Example Responses

{
  "data": {
    "usage": [
      {
        "domain_search": 500,
        "domain_search_used": 150
      },
      {
        "email_finder": 500,
        "email_finder_used": 75
      },
      {
        "email_verifier": 500,
        "email_verifier_used": 200
      },
      {
        "email_sources": 500,
        "email_sources_used": 30
      },
      {
        "email_count": 500,
        "email_count_used": 45
      },
      {
        "phone_finder": 100,
        "phone_finder_used": 10
      },
      {
        "b2b": 100,
        "b2b_used": 5
      }
    ],
    "total": {
      "domain_search": 500,
      "email_finder": 500,
      "email_verifier": 500,
      "email_sources": 500,
      "email_count": 500,
      "phone_finder": 100,
      "b2b": 100
    }
  }
}

json

application/json

Retrieve API Logs

GET

https://api.tomba.io/v1

/logs

X-Tomba-Key (header)

+X-Tomba-Secret (header)

Returns a your last 1,000 requests you made during the last 3 months.

Retrieve API Logs › query Parameters

page

integer

Page number.

Default: 1

limit

integer

Number of logs per page.

Default: 10

Retrieve API Logs › Responses

A list of logs.

Log[]

object

GET/logs

curl https://api.tomba.io/v1/logs \
  --header 'X-Tomba-Key: <api-key>' \
  --header 'X-Tomba-Secret: <api-key>'

Example Responses

{
  "data": [
    {
      "id": 98765,
      "type": "domain-search",
      "uri": "/v1/domain-search?domain=stripe.com",
      "cost": 1,
      "ip_address": "203.0.113.42",
      "created_at": "2025-08-30T14:22:00Z",
      "country": "US",
      "http_method": "GET",
      "source": "api"
    },
    {
      "id": 98764,
      "type": "email-verifier",
      "uri": "/v1/email-verifier?email=m@wordpress.org",
      "cost": 1,
      "ip_address": "203.0.113.42",
      "created_at": "2025-08-30T14:20:00Z",
      "country": "US",
      "http_method": "GET",
      "source": "api"
    }
  ],
  "meta": {
    "total": 542,
    "page": 1,
    "limit": 10
  }
}

json

application/json

Reveal Finder

Retrieve API Usage

GET

https://api.tomba.io/v1

/usage

X-Tomba-Key (header)

+X-Tomba-Secret (header)

Retrieve current API usage information.

Retrieve API Usage › Responses

API usage details.

Usage

requests

integer · required

Number of API requests made in the current period

limit

integer · required

Maximum number of requests allowed in the period

resetAt

string · date-time · required

Timestamp when the usage counter resets

Retrieve API Logs

GET

https://api.tomba.io/v1

/logs

X-Tomba-Key (header)

+X-Tomba-Secret (header)

Returns a your last 1,000 requests you made during the last 3 months.

Retrieve API Logs › query Parameters

page

integer

Page number.

Default: 1

limit

integer

Number of logs per page.

Default: 10

Retrieve API Logs › Responses

A list of logs.

Log[]

object