API Documentation

The PayToolbox API provides programmatic access to DNS lookups, email verification, and blacklist checking tools. All API endpoints return data in JSON, XML, or CSV format.

Base URL

https://paytoolbox.com//api.php

Quick Example

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://paytoolbox.com//api.php?area=dns&action=lookup-mx&domain=example.com&output=json"

All API requests require authentication using an API key. You can include your API key in one of two ways:

1. HTTP Header (Recommended)

X-API-Key: mxw_your_api_key_here

2. Query Parameter

https://paytoolbox.com//api.php?apikey=mxw_your_api_key_here&...

Rate limits are applied per API key on a daily basis. The limit depends on your subscription plan.

Rate Limit Headers

Every response includes headers indicating your rate limit status:

X-RateLimit-Limit: 1000       # Your daily limit
X-RateLimit-Remaining: 742    # Requests remaining today
X-RateLimit-Reset: 1705536000 # Unix timestamp when limit resets

Rate Limit Exceeded Response

When you exceed your rate limit, you'll receive a 429 Too Many Requests response:

{
    "success": false,
    "error": "Rate limit exceeded",
    "reset_at": "2024-01-18T00:00:00Z"
}

Specify your preferred response format using the output parameter:

Success Response

{
    "success": true,
    "data": {
        // Response data here
    },
    "cached": false,
    "query_time_ms": 125
}

Error Response

{
    "success": false,
    "error": "Error description here",
    "error_code": "INVALID_DOMAIN"
}

• cURL
• PHP
• Python
• JavaScript

curl -X GET \
  -H "X-API-Key: mxw_your_api_key_here" \
  "https://paytoolbox.com//api.php?area=dns&action=lookup-mx&domain=example.com&output=json"

<?php
$apiKey = 'mxw_your_api_key_here';
$domain = 'example.com';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://paytoolbox.com//api.php?area=dns&action=lookup-mx&domain=$domain&output=json");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: $apiKey"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);

import requests

api_key = 'mxw_your_api_key_here'
domain = 'example.com'

response = requests.get(
    'https://paytoolbox.com//api.php',
    params={
        'area': 'dns',
        'action': 'lookup-mx',
        'domain': domain,
        'output': 'json'
    },
    headers={'X-API-Key': api_key}
)

data = response.json()
print(data)

const apiKey = 'mxw_your_api_key_here';
const domain = 'example.com';

fetch(`https://paytoolbox.com//api.php?area=dns&action=lookup-mx&domain=${domain}&output=json`, {
    headers: {
        'X-API-Key': apiKey
    }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));