> ## Documentation Index
> Fetch the complete documentation index at: https://agent-traffic.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Verification

> How agent-traffic turns a claimed identity into a checked one.

User agents and headers are set by the client, so anyone can claim to be GPTBot. Operators that fetch from their own servers publish the IP ranges they use, which turns a claim into something you can check.

| Outcome | When | Result |
| - | - | - |
| Verified | The IP is inside the operator's published ranges | `verified: true`, confidence `high` |
| Impersonator | The IP is outside the ranges, and the range file is current | `category: 'bot'`, `kind: 'impersonator'`, `verified: false` |
| Unverified | No IP, an IP that isn't a single valid address, no published ranges or an empty range file, or an IP outside a range file older than `maxRangeAgeDays` (180 by default) | The claim is accepted with `verified: null` |

An unusable input never turns a real crawler into a suspected fake.

## Agents that run on the user's machine

Coding agents like Claude Code, OpenCode, Cursor and GitHub Copilot fetch from the developer's own computer, so their IPs will never be in the vendor's ranges. These entries are marked `"runsOn": "user"` and are never IP-checked.

## Use the real client IP

Behind a CDN or proxy, read the IP from the header your own proxy sets, such as `CF-Connecting-IP` on Cloudflare. The leftmost `X-Forwarded-For` value is set by the client, so it proves nothing.

Ports and IPv4-mapped IPv6 addresses (`::ffff:1.2.3.4`) are normalized before checking. A comma-separated chain is treated as unusable and skips verification.

## Where the ranges come from

[`loadIpRanges()`](https://agent-traffic.mintlify.site/reference/load-ip-ranges) downloads the files published by these operators:

* OpenAI
* Anthropic
* Google
* Perplexity
* Apple
* Microsoft
* Common Crawl
* DuckDuckGo

Refresh them about once a day.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.