Search
K
Location Retrieval

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

x-correlation-idstring

Correlation ID for request tracing

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

Location retrieved successfully

LocationRetrievalResponse

locationOne Of
required
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

Body

{ "phoneNumber": "+14155550123", "maxAgeSeconds": 86400 }
 
application/json

LocationRetrievalRequest

object
phoneNumberstringrequired

MSISDN in E.164 format

Example:+919036499174

maxAgeSecondsinteger

Maximum acceptable age of the location information in seconds

>= 0

Example:300

Example

LocationRetrievalResponse

object
locationOne Of
required
CircleAreaobject
Show Child Parameters
assessedAtstring(date-time)required

Time when the location was assessed

Example:2026-02-05T10:30:00Z

Example

CircleArea

object
typestringrequired

Allowed values:circle

centerobjectrequired
Show Child Parameters
radiusMetersnumber(double)required

Example:500

Example

PolygonArea

object
typestringrequired

Allowed values:polygon

coordinatesarray[object]required

List of polygon vertices

>= 3 items

Show Child Parameters
Example