Overview
The REST API's operations, generated from its OpenAPI spec.
These pages are generated from a copy of the API's OpenAPI spec that the API's tests keep in step with its code. The MCP server has the same lookups as tools.
Base URL
https://api.ipalmanac.comEvery /v1 operation needs an API key in the Authorization: Bearer header (Authentication) and
answers JSON. Errors are {"error": "<code>", "message": "<text>"} (Errors).
Operations
| Operation | Returns |
|---|---|
GET /v1/ip/{ip} | One public IP: its network, published ranges, PTR name and the domains on it. |
GET /v1/ip/{ip}/domains | Reverse IP: every domain seen on an IP, with dates. Paged. |
GET /v1/domain/{domain}/history | DNS history: a domain's current A and AAAA state and every answer it gave. Paged. |
GET /v1/domain/{domain}/hosting | Hosting history: the networks a domain moved through. |
GET /v1/asn/{asn} | One network: its ranges, the published ranges inside them, and what we observed there. Paged. |
GET /v1/ping | Check that your API key works. |
GET /health | Whether the service is up, and the data snapshot it serves. No key needed. |
To try an operation without writing code, use the Playground page of a project in the console (owners and admins can run requests). These pages have no "try it" button, because the API accepts browser requests only from the console.
About the examples
The example responses on these pages are made up, with documentation addresses and .example domains, to show the
shape of each one. Live responses have real values and the full coverage and attribution blocks.