All registered users, whether on a free or paid plan, can use our Quickstart Guide to explore the full range of API functionalities with just one click.

• Existing users: Access the Quickstart Guide below.
• New users: Create an account and get started right away.

Get onboarded with the IPstack API and start retrieving IP data in just a few minutes! 

Step 1: Get Your API Access Key

Sign up for a free or paid plan to start using the IPstack API. Once registered, your personal API Access Key will be available in the Dashboard. This key is required to authenticate all API requests—keep it secure. You can reset it anytime from your Account Dashboard.

Step 2: API Endpoints

IPstack provides three main endpoints:

• Standard Lookup – Retrieve details for a single IP address.
• Bulk Lookup – Retrieve details for multiple IP addresses in a single request.
• Requester Lookup – Retrieve details for the IP address making the API request.

Base URL: Every request starts with:

https://api.apilayer.net/ipstack/

Step 3: Make API Requests

Try simple requests to explore IP data. Append your access_key to any endpoint.

Example – Lookup Your Own IP:

https://api.apilayer.net/ipstack/162.158.122.99?access_key=123456789101112131415abcdefg

Standard IP Lookup

https://api.apilayer.net/ipstack/162.158.122.99?access_key=YOUR_ACCESS_KEY
// With optional parameters:
https://api.apilayer.net/ipstack/162.158.122.99?access_key=YOUR_ACCESS_KEY&fields=ip,location,security&hostname=1&security=1&language=en&callback=MY_CALLBACK&output=json

Bulk IP Lookup

https://api.apilayer.net/ipstack/134.201.250.155,72.229.28.185,110.174.165.78?access_key=YOUR_ACCESS_KEY
// With optional parameters:
https://api.apilayer.net/ipstack/134.201.250.155,72.229.28.185,110.174.165.78?access_key=YOUR_ACCESS_KEY&fields=ip,location,security&hostname=1&security=1&language=en&callback=MY_CALLBACK&output=json

Requester IP Lookup

https://api.apilayer.net/ipstack/check?access_key=YOUR_ACCESS_KEY
// With optional parameters:
https://api.apilayer.net/ipstack/check?access_key=YOUR_ACCESS_KEY&fields=ip,location,security&hostname=1&security=1&language=en&callback=MY_CALLBACK&output=json

Step 4: First API Call

We recommend starting with the Standard Lookup endpoint, as it is the primary method for retrieving information about a single IPv4 or IPv6 address.

This is just the beginning of what the IPstack API can do. For more detailed integration guides, code examples, and advanced features, refer to the official API Documentation.

Support & Resources

• For any questions or issues, contact our support team.
• Explore commonly used API calls and examples to get the most out of your integration.