IP Geolocation
Endpoints
Ungrouped Endpoints 1
What is the IP Geolocation API?
This API provides fast, reliable, and developer-friendly IP geolocation, ASN lookup, and location intelligence services. It is designed for high performance, secure communication, and seamless integration with web, mobile, cloud, and enterprise applications.
IP Geolocation API is available on the JoJ API marketplace. Subscribe with a single JoJ API key, call it through one gateway, and pay from one wallet — no separate account or contract with the provider.
IP Geolocation API endpoints
- POST
/api/geo/get-location-details-by-ipGet Location Details by IP
Retrieve detailed geolocation information for an IPv4 or IPv6 address, including country, city, state, latitude, longitude, timezone, ASN, ISP/organization, and metadata.
Frequently asked questions about IP Geolocation API
How do I authenticate with this API?
Authentication is performed using your API subscription key. Include your API key in the X-JoJAPI-Key request header with every request. Requests without a valid API key will return a 401 Unauthorized response.
Does this API support IPv6 addresses?
Yes. The API supports both IPv4 and IPv6 addresses. Provide a valid IP address in the request body, and the API will return the corresponding geolocation and ASN information.
What information does the API return?
The API returns comprehensive IP intelligence, including: IP Address Country Information State / Province City Latitude & Longitude Country Timezones ASN (Autonomous System Number) ISP / Organization Lookup Metadata (Cache Status, Processing Time, Database Version)
What request format should I use?
Send a POST request with the Content-Type: application/json header. Example: { "ip": "8.8.8.8" } The ip field must contain a valid IPv4 or IPv6 address.
Does the API support JSON responses?
Yes. All successful and error responses are returned in JSON format. Responses include geolocation details, country information, ASN information, timezone data, and lookup metadata when available.
What happens if I provide an invalid IP address?
If the supplied IP address is invalid, malformed, or cannot be resolved, the API returns an appropriate error response with the corresponding HTTP status code and an error message describing the issue.
Is HTTPS supported?
Yes. All API requests are served over HTTPS to ensure secure communication and encrypted data transmission between your application and the API.
What are the common use cases for this API?
Common use cases include: IP Geolocation Fraud Detection Login Security Geo Targeting Content Personalization Website Analytics Cybersecurity Network & ISP Identification SaaS Applications Mobile Applications Enterprise Applications
Is there a rate limit?
Yes. Rate limits are determined by your selected subscription plan. Each plan includes its own request rate and monthly usage quota. Please refer to your API marketplace subscription details for the limits applicable to your plan.
What request headers are required?
Every request must include the following headers: Header Required Description X-JoJAPI-Key Yes Your API subscription key Content-Type Yes application/json
What request body parameters are supported?
The request body accepts the following JSON parameter: Parameter Type Required Description ip String Yes A valid IPv4 or IPv6 address to look up. Example { "ip": "8.8.8.8" }
Which HTTP status codes can the API return?
The API may return the following HTTP status codes: Status Code Description 200 Request completed successfully 400 Invalid request or IP address 401 Authentication failed 404 Resource not found 405 Method not allowed 413 Payload too large 500 Internal server error