Question 1

How do I authenticate with this API?

Accepted Answer

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.

Question 2

Does this API support IPv6 addresses?

Accepted Answer

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.

Question 3

What information does the API return?

Accepted Answer

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)

Question 4

What request format should I use?

Accepted Answer

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.

Question 5

Does the API support JSON responses?

Accepted Answer

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.

Question 6

What happens if I provide an invalid IP address?

Accepted Answer

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.

Question 7

Is HTTPS supported?

Accepted Answer

Yes. All API requests are served over HTTPS to ensure secure communication and encrypted data transmission between your application and the API.

Question 8

What are the common use cases for this API?

Accepted Answer

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

Question 9

Is there a rate limit?

Accepted Answer

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.

Question 10

What request headers are required?

Accepted Answer

Every request must include the following headers:

Header	Required	Description
X-JoJAPI-Key	Yes	Your API subscription key
Content-Type	Yes	application/json

Question 11

What request body parameters are supported?

Accepted Answer

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