v1

latestOpenAPI 3.0.12026-07-244011,5573.5 MB

Persons

List person locations

Returns request context location records for the specified person, sorted by created date in descending order. Locations capture the geographic context (country, region, city) observed at the time of person interactions.

get/v5/persons/{person_id}/locations

Path parameters

person_idstring required

The Extole unique profile identifier of this user at Extole.

Query parameters

countriesstring[]

offsetinteger

limitinteger

Response

Successful response

accuracy_radius_kminteger required

Accuracy radius in kilometres for the geo-IP lookup. Absent if not available.

created_datestring required

RFC 3339 or RFC 9557 date-time with a numeric UTC offset and an optional IANA time-zone suffix in square brackets. Precision up to milliseconds.

device_idstring required

Device identifier associated with the request.

ip_addressstring required

IP address of the request that produced this location record.

zip_codestring required

Postal/ZIP code derived from the IP address. Absent if not resolvable.