Amazonaws APIcheckip.amazonaws.com ↗
Get the public IPv4 address of any HTTP client via the checkip.amazonaws.com API. One endpoint, one field, zero parameters required.
What is the Amazonaws API?
The checkip.amazonaws.com API exposes 1 endpoint — get_ip — that returns a single ip_address field containing the public-facing IPv4 address of the requesting client as observed by AWS infrastructure. No query parameters, authentication, or request body are needed. It is useful anywhere you need a reliable, network-level view of an outbound IP: VPN verification, proxy detection, server egress auditing, or NAT traversal debugging.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/d0143342-4c15-40d1-a6f8-53a36fcb9cb8/get_ip' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace checkip-amazonaws-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: CheckIP SDK — retrieve your public IP address."""
from parse_apis.checkip_amazonaws_com_api import CheckIP, NotFoundError
client = CheckIP()
# Get the caller's public IP address as seen by AWS.
try:
info = client.ip_infos.get()
print(f"Public IP: {info.ip_address}")
except NotFoundError as exc:
print(f"Service unavailable: {exc}")
print("exercised: ip_infos.get")
Returns the public-facing IPv4 address of the caller as seen by AWS infrastructure. No parameters required — the service reflects whatever source IP reaches it.
No input parameters required.
{
"type": "object",
"fields": {
"ip_address": "string"
},
"sample": {
"data": {
"ip_address": "193.23.198.197"
},
"status": "success"
}
}About the Amazonaws API
What the API Returns
The get_ip endpoint returns one field: ip_address, a string containing the public IPv4 address that AWS sees as the source of the incoming request. The address reflects the outermost network boundary the request passed through — a NAT gateway, a cloud egress IP, a residential router, or a VPN exit node — not any private or internal address.
Endpoint Behavior
get_ip takes no inputs. The response is determined entirely by the network path the request travels. If the caller is behind a corporate NAT, the returned address is the NAT's public IP. If running inside a cloud VM with an Elastic IP, the result is that Elastic IP. There is no way to query the IP of an arbitrary third party through this endpoint — it only reflects the caller's own source address.
Practical Notes
Because the endpoint requires no credentials and no parameters, it is well-suited for lightweight health checks, egress IP logging in CI/CD pipelines, and confirming that a VPN or proxy tunnel is active before making downstream requests. The response contains only the ip_address field — no geolocation, ASN, hostname, or threat intelligence data is included.
The Amazonaws API is a managed, monitored endpoint for checkip.amazonaws.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when checkip.amazonaws.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official checkip.amazonaws.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Verify the egress IP of a cloud function or container before making allowlist-restricted API calls
- Confirm a VPN or proxy connection is active by checking that
ip_addressmatches the expected exit node - Log the public IP of a server at startup for inventory or auditing purposes
- Detect NAT traversal in CI/CD pipelines by recording the outbound IP during each build
- Validate that a residential proxy rotates to a new
ip_addressbetween requests - Automate firewall rule generation by fetching the current egress IP of a dynamic host
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does checkip.amazonaws.com have an official developer API?+
What exactly does the `get_ip` endpoint return?+
ip_address, containing the public IPv4 address AWS observes as the source of the HTTP request. The value is the outermost public IP — typically a NAT gateway, cloud egress IP, or VPN exit node — not any private network address behind it.Does the API return IPv6 addresses?+
get_ip endpoint currently returns IPv4 addresses only. The ip_address field will not contain an IPv6 address even if the client supports dual-stack networking. You can fork this API on Parse and revise it to target an IPv6-capable reflection endpoint if you need IPv6 support.Does the API return geolocation, ASN, or hostname data alongside the IP?+
ip_address string — no country, city, ASN, ISP name, PTR record, or threat intelligence is included. You can fork this API on Parse and revise it to enrich the response by chaining a geolocation or ASN lookup endpoint.Can I use this endpoint to look up the IP address of a third-party server or domain?+
get_ip only reflects the IP of the client making the request. It cannot resolve or look up the public IP of an arbitrary hostname or third-party service. You can fork this API on Parse and revise it to add a DNS resolution or WHOIS lookup endpoint for that use case.