Tomba

Account

Endpointhttps://api.tomba.io/v1

Get Account

GET

https://api.tomba.io/v1

/me

Returns information about the current account.

Get Account › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get Account › Responses

200

Account information retrieved successfully

object

GET/me

curl --request GET \
  --url https://api.tomba.io/v1/me \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "data": {
    "user_id": 0,
    "secret_token": "secret_token",
    "role": 0,
    "confirmed": true,
    "blocked": true,
    "first_name": "first_name",
    "last_name": "last_name",
    "email": "email",
    "phone": "phone",
    "image": "image",
    "deleted": true,
    "provider": "provider",
    "timezone": "timezone",
    "newsletter": true,
    "activity": true,
    "title": {},
    "country": "country",
    "created_at": "created_at",
    "ip": "ip",
    "issued": "issued",
    "expired": "expired",
    "expired_subscription": "expired_subscription",
    "pricing": {
      "name": "name",
      "pricing_id": 0,
      "available_searches": 0,
      "available_verifications": 0,
      "available_phones": 0,
      "available_leads": 0,
      "available_list": 0,
      "available_attr": 0,
      "available_keys": 0,
      "available_teams": 0,
      "available_b2b": 0,
      "available_sources": 0,
      "available_email_count": 0,
      "frequency": "frequency",
      "price_monthly": "price_monthly",
      "price_yearly": "price_yearly",
      "update_url": {},
      "cancel_url": {}
    },
    "teams": {
      "team_id": {},
      "role": {},
      "workspace": {},
      "export": {},
      "bulks": {},
      "limit": {
        "search": {},
        "verifier": {}
      },
      "owner": {}
    },
    "requests": {
      "domains": {
        "available": 0,
        "used": 0
      },
      "verifications": {
        "available": 0,
        "used": 0
      },
      "phones": {
        "available": 0,
        "used": 0
      },
      "b2b": {
        "available": 0,
        "used": 0
      }
    }
  }
}

json

application/json

Retrieve API Usage

GET

https://api.tomba.io/v1

/usage

Retrieve current API usage information.

Retrieve API Usage › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Retrieve API Usage › Responses

200

API usage details.

requests

integer · required

limit

integer · required

resetAt

string · date-time · required

GET/usage

curl --request GET \
  --url https://api.tomba.io/v1/usage \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "requests": 0,
  "limit": 0,
  "resetAt": "2024-08-25T15:00:00Z"
}

json

application/json

Retrieve API Logs

GET

https://api.tomba.io/v1

/logs

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 › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Retrieve API Logs › Responses

200

A list of logs.

object[]

object

GET/logs

curl --request GET \
  --url https://api.tomba.io/v1/logs \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "data": [
    {
      "id": "id",
      "endpoint": "endpoint",
      "method": "method",
      "status": 0,
      "timestamp": "2024-08-25T15:00:00Z"
    }
  ],
  "meta": {
    "total": 0,
    "page": 0,
    "limit": 0
  }
}

json

application/json

Reveal Finder

Get Account

GET

https://api.tomba.io/v1

/me

Returns information about the current account.

Get Account › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Get Account › Responses

200

Account information retrieved successfully

object

{ "data": { "user_id": 0, "secret_token": "secret_token", "role": 0, "confirmed": true, "blocked": true, "first_name": "first_name", "last_name": "last_name", "email": "email", "phone": "phone", "image": "image", "deleted": true, "provider": "provider", "timezone": "timezone", "newsletter": true, "activity": true, "title": {}, "country": "country", "created_at": "created_at", "ip": "ip", "issued": "issued", "expired": "expired", "expired_subscription": "expired_subscription", "pricing": { "name": "name", "pricing_id": 0, "available_searches": 0, "available_verifications": 0, "available_phones": 0, "available_leads": 0, "available_list": 0, "available_attr": 0, "available_keys": 0, "available_teams": 0, "available_b2b": 0, "available_sources": 0, "available_email_count": 0, "frequency": "frequency", "price_monthly": "price_monthly", "price_yearly": "price_yearly", "update_url": {}, "cancel_url": {} }, "teams": { "team_id": {}, "role": {}, "workspace": {}, "export": {}, "bulks": {}, "limit": { "search": {}, "verifier": {} }, "owner": {} }, "requests": { "domains": { "available": 0, "used": 0 }, "verifications": { "available": 0, "used": 0 }, "phones": { "available": 0, "used": 0 }, "b2b": { "available": 0, "used": 0 } } } }

Retrieve API Usage

GET

https://api.tomba.io/v1

/usage

Retrieve current API usage information.

Retrieve API Usage › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Retrieve API Usage › Responses

200

API usage details.

requests

integer · required

limit

integer · required

resetAt

string · date-time · required

Retrieve API Logs

GET

https://api.tomba.io/v1

/logs

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 › Headers

X-Tomba-Key

string · required

Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

X-Tomba-Secret

string · required

Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Retrieve API Logs › Responses

200

A list of logs.

object[]

object