{ "openapi": "3.1.0", "info": { "title": "IPIntel.ai x402 Tools API", "version": "1.0.0", "contact": { "email": "support@ipintel.ai" }, "x-logo": { "url": "https://tools.ipintel.ai/favicon.png", "altText": "IPIntel.ai" }, "description": "Pay-per-call x402 APIs for DNS lookup, domain health checks, reverse DNS, WHOIS lookup, JSON Schema validation, JWT decoding, and Base64 encoding/decoding. Designed for autonomous agents, developers, domain diagnostics, API testing, structured output validation, token inspection, and data transformation workflows.", "x-guidance": "Use POST /dns-lookup to fetch DNS records, POST /domain-health to check DNS/email configuration, POST /reverse-dns to resolve PTR hostnames for IP addresses, and POST /whois-lookup to retrieve WHOIS domain registration data. All paid endpoints cost $0.001 USDC on Base via x402 v2." }, "servers": [ { "url": "https://tools.ipintel.ai" } ], "x-discovery": { "provider": "IPIntel.ai", "contact": "support@ipintel.ai", "payTo": "0x0550779CFBc832657A8BB46BAC9f359A5ad038B8" }, "components": { "securitySchemes": { "x402": { "type": "apiKey", "in": "header", "name": "PAYMENT", "description": "x402 v2 payment header. Unpaid requests return HTTP 402 with a payment-required header." } } }, "paths": { "/openapi.json": { "get": { "operationId": "getOpenApiDocument", "summary": "Get OpenAPI discovery document", "description": "Free endpoint that returns the OpenAPI discovery document for IPIntel.ai x402 tools.", "security": [], "responses": { "200": { "description": "OpenAPI document", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/.well-known/x402": { "get": { "operationId": "getX402DiscoveryDocument", "summary": "Get x402 discovery document", "description": "Free endpoint that returns the OpenAPI discovery document for x402scan-compatible discovery.", "security": [], "responses": { "200": { "description": "OpenAPI document", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/dns-lookup": { "get": { "operationId": "dnsLookupInfo", "summary": "DNS Lookup API info", "description": "Free metadata endpoint describing how to call DNS Lookup API. The paid API call uses POST /dns-lookup.", "security": [], "responses": { "200": { "description": "Tool information", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "DNS Lookup API", "endpoint": "https://tools.ipintel.ai/dns-lookup", "method": "POST", "x402": true, "price": "$0.001", "input": { "domain": "example.com", "types": [ "A", "MX", "NS", "TXT" ] } } } } } } }, "post": { "operationId": "dnsLookup", "summary": "DNS Lookup API", "description": "DNS Lookup API. Resolve domain DNS records and receive structured JSON with A, AAAA, MX, NS, TXT, CAA, and SOA records. Useful for agents, developers, domain diagnostics, email setup checks, DNS troubleshooting, and infrastructure investigation. Paid per call via x402.", "tags": [ "dns-lookup", "domain-intelligence", "mx-records", "txt-records", "developer-tools" ], "security": [ { "x402": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x0550779CFBc832657A8BB46BAC9f359A5ad038B8" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "domain": { "type": "string", "description": "Domain name to query, for example example.com" }, "types": { "type": "array", "description": "Optional DNS record types to return", "items": { "type": "string", "enum": [ "A", "AAAA", "MX", "NS", "TXT", "CAA", "SOA" ] } } }, "required": [ "domain" ] }, "example": { "domain": "example.com", "types": [ "A", "MX", "NS", "TXT" ] } } } }, "responses": { "200": { "description": "Successful paid response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "dns_lookup", "domain": "example.com", "types": [ "A", "MX", "NS", "TXT" ], "records": { "A": [ "93.184.216.34" ], "MX": [ { "host": "mail.example.com", "priority": 10 } ], "NS": [ "a.iana-servers.net", "b.iana-servers.net" ], "TXT": [ "v=spf1 -all" ] }, "timestamp": "2026-06-22T18:15:01+00:00" } } } }, "400": { "description": "Invalid request" }, "402": { "description": "Payment Required. Call without payment returns x402 v2 payment requirements in the payment-required header." } } } }, "/reverse-dns": { "get": { "operationId": "reverseDnsInfo", "summary": "Reverse DNS Lookup API info", "description": "Free metadata endpoint describing how to call Reverse DNS Lookup API. The paid API call uses POST /reverse-dns.", "security": [], "responses": { "200": { "description": "Tool information", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "Reverse DNS Lookup API", "endpoint": "https://tools.ipintel.ai/reverse-dns", "method": "POST", "x402": true, "price": "$0.001", "input": { "ip": "8.8.8.8" } } } } } } }, "post": { "operationId": "reverseDns", "summary": "Reverse DNS Lookup API", "description": "Reverse DNS Lookup API. Look up PTR records for an IP address and receive reverse DNS hostname data in structured JSON. Useful for agents, developers, IP enrichment, network diagnostics, infrastructure investigation, abuse analysis, and security workflows. Paid per call via x402.", "tags": [ "reverse-dns", "ptr-record", "ip-lookup", "dns", "developer-tools" ], "security": [ { "x402": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x0550779CFBc832657A8BB46BAC9f359A5ad038B8" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "ip": { "type": "string", "description": "IPv4 or IPv6 address to reverse-resolve" } }, "required": [ "ip" ] }, "example": { "ip": "8.8.8.8" } } } }, "responses": { "200": { "description": "Successful paid response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "reverse_dns", "ip": "8.8.8.8", "ptr": "dns.google", "has_ptr": true, "timestamp": "2026-06-22T18:15:01+00:00" } } } }, "400": { "description": "Invalid request" }, "402": { "description": "Payment Required. Call without payment returns x402 v2 payment requirements in the payment-required header." } } } }, "/domain-health": { "get": { "operationId": "domainHealthInfo", "summary": "Domain Health Check API info", "description": "Free metadata endpoint describing how to call Domain Health Check API. The paid API call uses POST /domain-health.", "security": [], "responses": { "200": { "description": "Tool information", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "Domain Health Check API", "endpoint": "https://tools.ipintel.ai/domain-health", "method": "POST", "x402": true, "price": "$0.001", "input": { "domain": "ipintel.ai" } } } } } } }, "post": { "operationId": "domainHealth", "summary": "Domain Health Check API", "description": "Domain Health Check API. Check domain DNS, MX, SPF, DMARC, and email configuration health and receive a structured JSON score with issues and recommendations. Useful for agents, developers, email deliverability checks, domain diagnostics, infrastructure investigation, and security workflows. Paid per call via x402.", "tags": [ "domain-health", "dns-lookup", "spf", "dmarc", "email-security" ], "security": [ { "x402": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x0550779CFBc832657A8BB46BAC9f359A5ad038B8" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "domain": { "type": "string", "description": "Domain name to analyze" } }, "required": [ "domain" ] }, "example": { "domain": "ipintel.ai" } } } }, "responses": { "200": { "description": "Successful paid response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "domain_health", "domain": "ipintel.ai", "score": 100, "status": "good", "dns": { "a": [ "104.21.0.211" ], "aaaa": [ "2606:4700:3033::6815:d3" ], "mx": [ { "host": "mx1.hostinger.com", "priority": 5 } ], "ns": [ "frank.ns.cloudflare.com", "journey.ns.cloudflare.com" ], "spf": "v=spf1 include:_spf.mail.hostinger.com ~all", "dmarc": "v=DMARC1; p=none" }, "issues": [], "timestamp": "2026-06-22T18:15:01+00:00" } } } }, "400": { "description": "Invalid request" }, "402": { "description": "Payment Required. Call without payment returns x402 v2 payment requirements in the payment-required header." } } } }, "/whois-lookup": { "get": { "operationId": "whoisLookupInfo", "summary": "WHOIS Lookup API info", "description": "Free metadata endpoint describing how to call WHOIS Lookup API. The paid API call uses POST /whois-lookup.", "security": [], "responses": { "200": { "description": "Tool information", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "WHOIS Lookup API", "endpoint": "https://tools.ipintel.ai/whois-lookup", "method": "POST", "x402": true, "price": "$0.001", "input": { "domain": "example.com" } } } } } } }, "post": { "operationId": "whoisLookup", "summary": "WHOIS Lookup API", "description": "WHOIS Lookup API. Retrieve domain registration data including registrar, WHOIS server, creation date, expiration date, updated date, nameservers, domain status, and privacy/redaction signals. Useful for agents, developers, domain intelligence, expiry checks, registrar lookup, ownership investigation, and security workflows. Paid per call via x402.", "tags": [ "whois", "domain-lookup", "domain-intelligence", "registrar", "developer-tools" ], "security": [ { "x402": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x0550779CFBc832657A8BB46BAC9f359A5ad038B8" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "domain": { "type": "string", "description": "Domain name to query, for example example.com" } }, "required": [ "domain" ] }, "example": { "domain": "example.com" } } } }, "responses": { "200": { "description": "Successful paid response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "whois_lookup", "domain": "example.com", "registrar": "RESERVED-Internet Assigned Numbers Authority", "whois_server": "whois.iana.org", "creation_date": "1995-08-14T04:00:00Z", "updated_date": "2024-08-14T07:01:34Z", "expiration_date": "2025-08-13T04:00:00Z", "nameservers": [ "a.iana-servers.net", "b.iana-servers.net" ], "statuses": [ "clientDeleteProhibited", "clientTransferProhibited" ], "is_redacted": true, "raw_excerpt": "Domain Name: EXAMPLE.COM\nRegistrar: RESERVED-Internet Assigned Numbers Authority\n...", "timestamp": "2026-06-22T20:00:00+00:00" } } } }, "400": { "description": "Invalid request" }, "402": { "description": "Payment Required. Call without payment returns x402 v2 payment requirements in the payment-required header." } } } }, "/json-schema-validator": { "get": { "operationId": "jsonSchemaValidatorInfo", "summary": "JSON Schema Validator API info", "description": "Free metadata endpoint describing how to call JSON Schema Validator API. The paid API call uses POST /json-schema-validator.", "security": [], "responses": { "200": { "description": "Tool information", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "JSON Schema Validator API", "endpoint": "https://tools.ipintel.ai/json-schema-validator", "method": "POST", "x402": true, "price": "$0.001", "input": { "schema": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" } } }, "data": { "name": "Niki" } } } } } } } }, "post": { "operationId": "jsonSchemaValidator", "summary": "JSON Schema Validator API", "description": "JSON Schema Validator API. Validate JSON data against a JSON Schema and receive structured valid/invalid results with detailed validation errors. Supports common JSON Schema features including type, required, properties, additionalProperties, enum, const, items, string lengths, patterns, and numeric bounds. Useful for agents, developers, API testing, structured output validation, schema checks, and automation workflows. Paid per call via x402.", "tags": [ "json-schema", "json-validator", "schema-validation", "structured-output", "developer-tools", "api-testing", "automation" ], "security": [ { "x402": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x0550779CFBc832657A8BB46BAC9f359A5ad038B8" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "schema": { "type": "object", "description": "JSON Schema object" }, "data": { "description": "JSON value to validate against the schema" } }, "required": [ "schema", "data" ] }, "example": { "schema": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" } } }, "data": { "name": "Niki" } } } } }, "responses": { "200": { "description": "Successful paid response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "json_schema_validator", "valid": true, "errors": [], "timestamp": "2026-06-23T00:00:00+00:00" } } } }, "400": { "description": "Invalid request" }, "402": { "description": "Payment Required. Call without payment returns x402 v2 payment requirements in the payment-required header." } } } }, "/jwt-decode": { "get": { "operationId": "jwtDecodeInfo", "summary": "JWT Decode API info", "description": "Free metadata endpoint describing how to call JWT Decode API. The paid API call uses POST /jwt-decode.", "security": [], "responses": { "200": { "description": "Tool information", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "JWT Decode API", "endpoint": "https://tools.ipintel.ai/jwt-decode", "method": "POST", "x402": true, "price": "$0.001", "input": { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjMifQ.signature" } } } } } } }, "post": { "operationId": "jwtDecode", "summary": "JWT Decode API", "description": "JWT Decode API. Decode JWT header and payload without verifying the signature. Returns algorithm, claims, expiration, issued-at, not-before timestamps, and token validity hints. Useful for agents, developers, authentication debugging, token inspection, API testing, and security workflows. Paid per call via x402.", "tags": [ "jwt", "jwt-decode", "token-inspection", "auth-debugging", "developer-tools", "api-testing", "security" ], "security": [ { "x402": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x0550779CFBc832657A8BB46BAC9f359A5ad038B8" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "token": { "type": "string", "description": "JWT token to decode" } }, "required": [ "token" ] }, "example": { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjMifQ.signature" } } } }, "responses": { "200": { "description": "Successful paid response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "jwt_decode", "valid_format": true, "verified_signature": false, "warning": "This tool decodes JWT header and payload only. It does not verify the signature.", "algorithm": "HS256", "header": {}, "payload": {}, "is_expired": false, "timestamp": "2026-06-23T00:00:00+00:00" } } } }, "400": { "description": "Invalid request" }, "402": { "description": "Payment Required. Call without payment returns x402 v2 payment requirements in the payment-required header." } } } }, "/base64-encode": { "get": { "operationId": "base64EncodeInfo", "summary": "Base64 Encode API info", "description": "Free metadata endpoint describing how to call Base64 Encode API. The paid API call uses POST /base64-encode.", "security": [], "responses": { "200": { "description": "Tool information", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "Base64 Encode API", "endpoint": "https://tools.ipintel.ai/base64-encode", "method": "POST", "x402": true, "price": "$0.001", "input": { "value": "hello", "url_safe": false } } } } } } }, "post": { "operationId": "base64Encode", "summary": "Base64 Encode API", "description": "Base64 Encode API. Encode plain text into standard or URL-safe Base64 and return structured JSON with input length and encoded output. Useful for agents, developers, API testing, token workflows, data transformation, encoding workflows, and automation tasks. Paid per call via x402.", "tags": [ "base64", "base64-encode", "encoding", "url-safe-base64", "data-transform", "developer-tools", "api-testing" ], "security": [ { "x402": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x0550779CFBc832657A8BB46BAC9f359A5ad038B8" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "value": { "type": "string", "description": "String value to encode" }, "url_safe": { "type": "boolean", "description": "Whether to return URL-safe Base64 without padding" } }, "required": [ "value" ] }, "example": { "value": "hello", "url_safe": false } } } }, "responses": { "200": { "description": "Successful paid response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "base64_encode", "url_safe": false, "input_length": 5, "encoded": "aGVsbG8=", "timestamp": "2026-06-23T00:00:00+00:00" } } } }, "400": { "description": "Invalid request" }, "402": { "description": "Payment Required. Call without payment returns x402 v2 payment requirements in the payment-required header." } } } }, "/base64-decode": { "get": { "operationId": "base64DecodeInfo", "summary": "Base64 Decode API info", "description": "Free metadata endpoint describing how to call Base64 Decode API. The paid API call uses POST /base64-decode.", "security": [], "responses": { "200": { "description": "Tool information", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "Base64 Decode API", "endpoint": "https://tools.ipintel.ai/base64-decode", "method": "POST", "x402": true, "price": "$0.001", "input": { "value": "aGVsbG8=", "url_safe": false } } } } } } }, "post": { "operationId": "base64Decode", "summary": "Base64 Decode API", "description": "Base64 Decode API. Decode standard or URL-safe Base64 and return UTF-8 text when possible, hex output, validity, and output length. Useful for agents, developers, token inspection, API debugging, decoding workflows, data transformation, and automation tasks. Paid per call via x402.", "tags": [ "base64", "base64-decode", "decoding", "url-safe-base64", "token-inspection", "data-transform", "developer-tools", "api-testing" ], "security": [ { "x402": [] } ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001" }, "protocols": [ { "x402": { "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x0550779CFBc832657A8BB46BAC9f359A5ad038B8" } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "value": { "type": "string", "description": "Base64 value to decode" }, "url_safe": { "type": "boolean", "description": "Whether the input uses URL-safe Base64" } }, "required": [ "value" ] }, "example": { "value": "aGVsbG8=", "url_safe": false } } } }, "responses": { "200": { "description": "Successful paid response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true }, "example": { "ok": true, "service": "base64_decode", "valid": true, "url_safe": false, "decoded": "hello", "decoded_hex": "68656c6c6f", "is_utf8": true, "output_length": 5, "timestamp": "2026-06-23T00:00:00+00:00" } } } }, "400": { "description": "Invalid request" }, "402": { "description": "Payment Required. Call without payment returns x402 v2 payment requirements in the payment-required header." } } } } } }