Skip to main content
GET
/
v1
/
prospect
/
account
Prospect Account Info
curl --request GET \
  --url https://api.gtmapis.com/v1/prospect/account \
  --header 'X-API-Key: <api-key>'
{
  "valid": true,
  "remaining_credits": 123,
  "max_requests_per_seconds": 123,
  "allowed_apis": [
    {}
  ]
}

​
Prospect Account Info

Get your account status, remaining credits, rate limits, and allowed API access. Use this endpoint to check your balance before making calls or to monitor usage.

​
Endpoint

GET /v1/prospect/account

​
Request

No request body required. Authenticate with your API key in the X-API-Key header.

​
Example Request

curl -X GET https://api.gtmapis.com/v1/prospect/account \
  -H "X-API-Key: gtm_test_your_key_here"

​
Response

​
valid
boolean
Whether the API key is valid and the account is active
​
remaining_credits
number
Number of credits remaining on the account
​
max_requests_per_seconds
integer
Maximum number of API requests allowed per second
​
allowed_apis
array
List of API categories the account has access to (e.g., “search”, “enrichment”)

​
Success Response

{
  "valid": true,
  "remaining_credits": 5000,
  "max_requests_per_seconds": 5,
  "allowed_apis": ["search", "enrichment"]
}

​
Invalid Key Response

{
  "valid": false,
  "remaining_credits": 0,
  "max_requests_per_seconds": 0,
  "allowed_apis": []
}

​
Credit Pricing

ResultCredits Charged
Account info request0 credits
This endpoint is free to call and does not consume any credits.

​
Error Responses

​
401 Unauthorized

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

​
Use Cases

Check remaining credits before kicking off a bulk enrichment job to avoid mid-run failures.
Periodically poll the account endpoint to track credit consumption and trigger alerts when balance is low.
Read your rate limit to throttle outbound requests and avoid 429 errors.

ICP Search

Find people matching your ICP

Employee Search

Search employees at a company

Email from LinkedIn

Get email from LinkedIn profile

Phone from LinkedIn

Get phone from LinkedIn profile

Email to Person

Reverse lookup person from email

Company Search

Find companies matching criteria