x-correlation-idstring
Correlation ID for request tracing
Location Retrieval
Device location retrieval APIs
Retrieve device location
Retrieves the geographic area where a device is currently located. The returned area can be a circle or a polygon, depending on operator support.
post
https://api.pxg.konera.com/camara/location-retrieval/v0.4/retrieve
Headers
Body
application/json
Body
application/json
LocationRetrievalRequest
phoneNumberstringrequired
MSISDN in E.164 format
Example:+919036499174
maxAgeSecondsinteger | null
Maximum acceptable age of the location information in seconds
>= 0
Example:300
Response
application/json
Response
application/json
Location retrieved successfully
LocationRetrievalResponse
location
One Ofrequired
CircleAreaobject
Show Child Parameters
assessedAtstring(date-time)required
Time when the location was assessed
Example:2026-02-05T10:30:00Z
post/location-retrieval/v0.4/retrieve
Authentication
Headers
Body
{
"phoneNumber": "+14155550123",
"maxAgeSeconds": 86400
}
application/json
LocationRetrievalRequest
objectphoneNumberstringrequired
MSISDN in E.164 format
Example:+919036499174
maxAgeSecondsinteger
Maximum acceptable age of the location information in seconds
>= 0
Example:300
Example
LocationRetrievalResponse
objectlocation
One Ofrequired
CircleAreaobject
Show Child Parameters
assessedAtstring(date-time)required
Time when the location was assessed
Example:2026-02-05T10:30:00Z
Example
CircleArea
objecttypestringrequired
Allowed values:circle
centerobjectrequired
Show Child Parameters
radiusMetersnumber(double)required
Example:500
Example