API Response Formats (JSON & XML)
All IPGeolocation.io API endpoints support JSON and XML responses. JSON is the default response format. The only exception is the Get IP endpoint, which also supports plain-text output.
At a Glance
- Default: JSON
- XML:
output=xmlorAccept: application/xml/Accept: text/xml - If no output/Accept is set: response is JSON
- Get IP endpoint: returns public IP address, no auth, supports JSON/XML/plain text via
output
JSON (Default)
If you do not specify a response format, the API responds in JSON.
This is the recommended format for most integrations, SDK usage, and backend services.
XML
To request XML, use one of the two supported options below.
1. Option 1: URL Parameter (output=xml)
Pass output=xml as a URL parameter.
curl -X GET 'https://api.ipgeolocation.io/v3/ipgeo?apiKey=API_KEY&ip=1.1.1.1&fields=location.city&output=xml'2. Option 2: Accept Header
Set the Accept HTTP header to application/xml or text/xml .
curl -X GET 'https://api.ipgeolocation.io/v3/ipgeo?apiKey=API_KEY&ip=1.1.1.1&fields=currency' \
-H 'Accept: text/xml'Get IP Endpoint (No Auth)
The Get IP endpoint returns the public IP address of the client where it is called. If called from your server, it returns the server IP. If called from your website (JavaScript), it returns the visitor's IP address. This endpoint does not require authentication and can be used without creating an account.
1. Output Parameter
The optional output query parameter controls the response format:
-
output=json(default): JSON -
output=xml: XML -
output=text: plain text
2. JSON Response (Default)
curl -X GET 'https://api.ipgeolocation.io/v3/getip'1{
2 "ip": "1.1.1.1"
3}3. XML Response
curl -X GET 'https://api.ipgeolocation.io/v3/getip?output=xml'1<LinkedHashMap>
2 <ip>1.1.1.1</ip>
3</LinkedHashMap>4. Plain Text Response
curl -X GET 'https://api.ipgeolocation.io/v3/getip?output=text'11.1.1.1Frequently Asked Questions
output=xml or set Accept: application/xml or Accept: text/xml .