# IPRout

> Developer-first IP geolocation, GeoIP and ASN lookup API.

IPRout returns country, region, city, timezone, UTC offset, coordinates, ASN,
organization, currency and calling code data for caller-supplied IPv4 and IPv6
addresses. The production API base URL is https://api.iprout.com.

## Essential Documentation

- [Documentation Hub](https://iprout.com/docs): All integration guides.
- [Quickstart](https://iprout.com/docs/quickstart): Make a first authenticated lookup.
- [Authentication](https://iprout.com/docs/authentication): Bearer and X-API-Key headers.
- [Caller IP Lookup](https://iprout.com/docs/caller-ip-lookup): GET /ip with no path parameter.
- [Specific IP Lookup](https://iprout.com/docs/specific-ip-lookup): GET /ip/8.8.8.8 example.
- [Response Fields](https://iprout.com/docs/response-fields): GeoIP and ASN response schema.
- [Errors](https://iprout.com/docs/errors): HTTP 401, 422, 429 and 500 handling.
- [Usage Endpoint](https://iprout.com/docs/usage-endpoint): GET /usage totals and per-key usage.
- [OpenAPI Specification](https://iprout.com/docs/openapi.json): Machine-readable API contract.
- [Postman Collection](https://documenter.getpostman.com/view/55991899/2sBXwtrASm): Ready-to-run IPRout requests and examples.
- [GitHub API Examples](https://github.com/IProut2026/examples): IPRout integration examples.
- [Code Examples](https://iprout.com/docs/examples): Complete tutorials for 24 languages, runtimes, and frameworks.
- [Request and Response Format](https://iprout.com/docs/request-and-response-format): HTTP and JSON contract guidance.
- [Testing and Mocking](https://iprout.com/docs/testing-and-mocking): Success, failure, timeout, and integration-test patterns.
- [Accuracy and Limitations](https://iprout.com/docs/data-accuracy-and-limitations): Responsible interpretation of network location.
- [Privacy and Data Handling](https://iprout.com/docs/privacy-and-data-handling): Data minimization, access, and retention guidance.
- [Documentation Markdown](https://iprout.com/docs.md): Compact machine-readable guide index.

## API Key Management

- [Multi-Website API Key Management](https://iprout.com/docs/multi-website-api-key-management): Isolate website credentials, usage, exact browser origins, and Pro caps.
- [Multiple Active Keys](https://iprout.com/docs/multiple-active-api-keys): Free 1, Starter 2, Pro 5.
- [CORS Origin Restrictions](https://iprout.com/docs/cors-origin-restrictions): Starter up to 5 and Pro up to 10 exact origins per key.
- [Per-Key Request Caps](https://iprout.com/docs/per-key-request-caps): Pro can set 100 to 1,000,000; Starter is fixed by plan.
- [Shared Quotas](https://iprout.com/docs/usage-and-shared-quotas): All keys consume one account allowance.
- [Key Rotation](https://iprout.com/docs/key-rotation-and-revocation): Replace and revoke credentials safely.
- [Security Practices](https://iprout.com/docs/security-best-practices): Storage, restrictions, monitoring and rotation.

## Product

- [Features](https://iprout.com/features): IP intelligence and API control directory.
- [Multi-Site API Key Management](https://iprout.com/features/multi-site-api-key-management): Named website keys, origin restrictions, per-key visibility, and configurable Pro caps.
- [Features Markdown](https://iprout.com/features.md): Compact machine-readable feature directory.
- [Pricing](https://iprout.com/pricing): Free, Starter and Pro plans.
- [7-Day Developer Key](https://iprout.com/developer-key): 1,000 requests without an account.
- [FAQ](https://iprout.com/faq): Product, data, billing and integration answers.
- [MCP Server](https://iprout.com/mcp-server): IPRout tools for MCP-compatible AI clients.

## Current Public Plans

- Free: $0/month, 10,000 shared requests, 1 active API key.
- Starter: $7/month, 100,000 shared requests, 2 active keys, up to 5 exact CORS origins per key.
- Pro: $27/month, 1,000,000 shared requests, 5 active keys, up to 10 exact CORS origins per key, custom 100 to 1,000,000 per-key cap.
- Paid subscriptions are month-to-month and processed by Stripe.

## Endpoint Summary

- GET /ip looks up the authenticated caller IP.
- GET /ip/{ip} looks up the supplied IPv4 or IPv6 address.
- GET /usage returns monthly account and per-key usage data.
- Authenticate with Authorization: Bearer YOUR_API_KEY or X-API-Key.