Quickstart

Get started with GTMAPIs in 5 minutes

Setup Your Account

1. Sign Up

   Create your account at gtmapis.com

2. Get Your API Key

   Navigate to Dashboard → API Keys and generate a test key

   API keys follow this format:

   • Test keys: gtm_test_1234567890abcdef1234567890abcdef
   • Live keys: gtm_live_1234567890abcdef1234567890abcdef

   Test and live prefixes identify intended usage. Both must be valid account keys and both follow the normal access, rate-limit, and credit policy unless product docs state otherwise.

3. Make Your First Request

   Validate your first email with a simple cURL request

Validate a Single Email

CLI

export GTMAPIS_API_KEY=gtm_test_1234567890abcdef1234567890abcdef
gtmapis validate [e-mail]

curl -X POST https://api.gtmapis.com/v1/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_1234567890abcdef1234567890abcdef" \
  -d '{"email":"[e-mail]"}'

const response = await fetch('https://api.gtmapis.com/v1/validate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'gtm_test_1234567890abcdef1234567890abcdef'
  },
  body: JSON.stringify({
    email: '[e-mail]'
  })
});

const result = await response.json();
console.log(result);

import requests

response = requests.post(
    'https://api.gtmapis.com/v1/validate',
    headers={
        'Content-Type': 'application/json',
        'X-API-Key': 'gtm_test_1234567890abcdef1234567890abcdef'
    },
    json={
        'email': '[e-mail]'
    }
)

result = response.json()
print(result)

package main

import (
    "bytes"
    "encoding/json"
    "net/http"
)

func main() {
    body := map[string]string{"email": "[e-mail]"}
    jsonBody, _ := json.Marshal(body)

    req, _ := http.NewRequest("POST", "https://api.gtmapis.com/v1/validate", bytes.NewBuffer(jsonBody))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "gtm_test_1234567890abcdef1234567890abcdef")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()
}

Response Format

{
  "email": "[e-mail]",
  "result": "valid",
  "reason": "",
  "syntax_valid": true,
  "dns_valid": true,
  "smtp_valid": true,
  "is_catchall": false,
  "is_role_based": false,
  "b2b_outbound_quality": "high",
  "b2b_quality": "high",
  "credits_charged": 1,
  "charge_reason": "Valid personal email with high B2B outbound quality"
}

result · string · required

Validation result: valid, valid_role_based, risky, invalid, or unknown

b2b_outbound_quality · string · required

B2B quality score: high, low, none, or unknown

credits_charged · integer · required

Number of credits charged (0 or 1). Only high-value personal emails are charged.

Validate Multiple Emails

Process up to 100 emails in a single request:

CLI

gtmapis bulk --file leads.csv

curl -X POST https://api.gtmapis.com/v1/validate/bulk \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_1234567890abcdef1234567890abcdef" \
  -d '{
    "emails": [
      "[e-mail]",
      "[e-mail]",
      "[e-mail]"
    ]
  }'

Check Credit Balance

gtmapis credits
gtmapis credits --json

The credit command calls GET https://api.gtmapis.com/v1/credits with the same X-API-Key authentication model.

Understanding Credit Charges

Only pay for emails that matter:

Result	B2B Quality	Credits Charged	Example
valid	high	✅ 1 credit	[e-mail]
valid_role_based	low	🆓 FREE	[e-mail]
risky	none	🆓 FREE	catch-all domains
invalid	none	🆓 FREE	[e-mail]
unknown	unknown	🆓 FREE	restrictive SMTP servers

Next Steps

Validation Pipeline

Learn how our 4-layer validation works

B2B Quality Scoring

Understand how we score emails for outbound value

API Reference

Complete API documentation

MCP and Agent Tools

Use GTMAPIs safely from coding agents and GTM workflow agents

CSV Upload Guide

Upload and validate CSV files