My IP

GET https://api.echovalue.dev/myip

Returns the IP address seen by echoValue for the current request, plus geo metadata derived from the request headers.

This endpoint is useful when you need to:

verify the public IP used by your server or client
detect whether the current request arrived over IPv4 or IPv6
inspect geo metadata such as city, country, timezone, and region

Request

Headers:

Header	Description
`x-token`	Your API token

Examples:

curl 'https://api.echovalue.dev/myip' \
  -H 'x-token: mytoken'

Response

Response: 200 — JSON object.

{
  "ip": "203.0.113.42",
  "ipv6": "",
  "isCurrentIpv6": false,
  "userAgent": "curl/8.7.1",
  "acceptLanguage": "en-US,en;q=0.9",
  "city": "Rome",
  "country": "IT",
  "continent": "EU",
  "latitude": "41.9028",
  "longitude": "12.4964",
  "region": "Lazio",
  "regionCode": "62",
  "timezone": "Europe/Rome",
  "postalCode": "00100"
}

Field	Type	Description
`ip`	string	IPv4 address when available. Empty for native IPv6 callers.
`ipv6`	string	Raw IPv6 address when the current caller IP is IPv6.
`isCurrentIpv6`	boolean	`true` when the incoming request IP is IPv6.
`userAgent`	string	Caller user agent string.
`acceptLanguage`	string	Caller `Accept-Language` header when present.
`city`	string	Detected city.
`country`	string	Detected country code.
`continent`	string	Detected continent code.
`latitude`	string	Latitude associated with the caller IP.
`longitude`	string	Longitude associated with the caller IP.
`region`	string	Detected region or state name.
`regionCode`	string	Region code.
`timezone`	string	Detected IANA timezone.
`postalCode`	string	Detected postal code.

Response headers:

Header	Description
`x-balance`	Wallet balance after this call
`x-cost`	Credits consumed

See Response Headers for details.

Status Codes

Status	Meaning
`200`	IP data returned
`401`	Invalid token
`402`	Insufficient credits
`405`	Method not allowed