How do I authenticate with this API?
Create an API key in your Datpaq dashboard and send it with each request as a bearer token in the Authorization header.
IP Intelligence API
VPN & Tor Detection
Trust Scoring
Batch: 100 IPs
IP threat intelligence. In one call.
Analyze any IP address for trust score, VPN and Tor detection, ASN, country, and organization — all from a PostgreSQL-backed threat intelligence database. Single lookup or batch up to 100.
0–100 · trust scoreVPN + Tor · detection100 IPs · per batchIPv4 + IPv6 · supported
Loading IP intelligence playground
Why IP Intelligence API
Everything you need to assess an IP.
Trust scoring (0–100)
Every IP gets a trust score from 0 (high-risk) to 100 (clean). Use it to gate actions, flag requests, or inform risk decisions downstream.
VPN & Tor detection
Identify traffic from VPN services and Tor exit nodes with dedicated boolean flags — key signals for fraud prevention and access control.
ASN & geo lookup
Returns the Autonomous System Number, country code, and organization name for every IP — no extra enrichment step required.
Batch up to 100 IPs
POST an array of up to 100 IPs and get back concurrent results with a summary breakdown of found, not-found, valid, and invalid addresses.
PostgreSQL threat database
Backed by a PostgreSQL threat intelligence database with real-time analysis. Results include a correlationId for every request.
Use your own IP
Omit the ip parameter on the GET endpoint and the API automatically uses the client's IP from request headers — handy for self-checks.
/api/v1/ip-intelligence
Endpoints, at a glance.
GET for single lookups and quick scripts. POST batch for high-volume analysis. Both return the same intelligence fields.
GET/api/v1/ip-intelligence
Single IP lookup
Analyze one IP address. Pass ip as a query param, or omit it to analyze the caller's IP from request headers.
GET/api/v1/ip-intelligence/batch
Batch lookup (GET)
Comma-separated list of IPs in the ip query param. Up to 100 addresses. Returns the same result shape as POST batch.
POST/api/v1/ip-intelligence/batch
Batch lookup (POST)
JSON body with an ip array of up to 100 addresses. Concurrent processing with per-result found/error flags.
GET/api/v1/ip-intelligence/batch/info
Batch info
Returns batch processing configuration: max size, endpoint, example request, and response schema.
GET/health
Service health
Status, service name, version, and timestamp. Good for uptime monitoring.
GET/metrics
Prometheus metrics
Request counts, processing times, and lookup success/failure rates.
| Field | Type | Description |
|---|---|---|
| ip | string | The analyzed IP address (IPv4 or IPv6) |
| trust_score | integer | Trust assessment 0-100. Higher = safer. |
| is_vpn | boolean | True if the IP belongs to a known VPN service. |
| is_tor | boolean | True if the IP is a known Tor exit node. |
| asn | string | Autonomous System Number (e.g. "AS15169"). |
| country | string | Two-letter country code (e.g. "US"). |
| org | string | Organization that owns the IP (e.g. "Google LLC"). |
| correlationId | string | Unique request identifier for tracing. |
Requests & responses.
Single IP via GET. Batch via POST or comma-separated GET. Omit ip to analyze your own.
Single IP lookup
Pass any IPv4 or IPv6 address, or omit ip to use the caller's IP.
GET https://datpaq.com/api/v1/ip-intelligence?api_key=YOUR_API_KEY&ip=8.8.8.8
Batch lookup — up to 100 IPs
POST a JSON array, or GET with a comma-separated list. Both return the same shape.
POST https://datpaq.com/api/v1/ip-intelligence/batch
Content-Type: application/json
x-api-key: YOUR_API_KEY
{
"ip": ["8.8.8.8", "185.220.101.1", "1.1.1.1"]
}Error reference
Predictable errors, every time.
Every error response includes a correlationId for request tracing and a plain-English error field.
400Invalid IP Format
The ip parameter is not a valid IPv4 or IPv6 address. Validate format before sending.
400Invalid Batch Format
POST batch requires ip to be a JSON array: {"ip": ["8.8.8.8", "1.1.1.1"]}.
400Batch Size Exceeded
More than 100 IPs in a single batch. Split into multiple requests of 100 or fewer.
400Empty Batch
At least one IP address is required in the batch array.
404IP Not Found
The requested IP is not in the threat intelligence database. Private/RFC-1918 ranges may not be indexed.
404Endpoint Not Found
The requested path does not exist. Check the endpoint list for available routes.
429Rate Limited
Too many requests from this IP. Wait before retrying.
500Internal Error
Unexpected server error during analysis. The correlationId in the response helps trace the issue.
Example error response (batch invalid IP)
{
"success": true,
"data": {
"summary": { "total_requested": 2, "valid_ips": 1, "invalid_ips": 1, ... },
"invalid_ips": [
{ "index": 1, "ip": "invalid.ip.address", "reason": "Invalid IP format" }
]
},
"correlationId": "req-123456789"
}Working example
See the IP Intelligence sample app
An open-source single-page app that calls this API from JavaScript, with auth and rendering wired up.
FAQ
API questions developers ask first.
Is there a free tier?
Yes. Datpaq APIs include a free tier for building, testing, and small production workloads before you move to a paid plan.
What format do requests and responses use?
Datpaq APIs use REST over HTTPS and return JSON by default. Endpoint docs show the supported methods, query parameters, request bodies, and response fields.
Where can I see limits and errors?
Each API documents rate limits, validation rules, and error responses in the landing page and API docs so integrations can retry and fail cleanly.
Start analyzing IPs today.
One GET call returns trust score, VPN/Tor flags, ASN, country, and org. No setup required - just your API key and an IP address.