Account

Download schema

Account details, credits, and workspace settings

Get Account

GET

https://api.tomba.io/v1

/me

Returns information about the current account.

Get Account › Headers

X-Tomba-Key

string · required

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Get Account › Responses

Account information retrieved successfully

Account

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

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Retrieve API Usage › Responses

API usage details.

Usage

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

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Retrieve API Logs › Responses

A list of logs.

Log[]

object

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

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Get Account › Responses

Account information retrieved successfully

Account

object

Retrieve API Usage

GET

https://api.tomba.io/v1

/usage

Retrieve current API usage information.

Retrieve API Usage › Headers

X-Tomba-Key

string · required

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Retrieve API Usage › Responses

API usage details.

Usage

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

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Retrieve API Logs › Responses

A list of logs.

Log[]

object