List nearby tasks

get

https://{backendUrlScheme}://{backendUrlHost}/api/public/task/nearby

This endpoint retrieves tasks near the provided coordinates for a user.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

gpsLatitude

number

required

Latitude of the search location

gpsLongitude

number

required

Longitude of the search location

userId

string

required

ID of the user the nearby tasks are listed for

maxDistance

number

Maximum distance from the search location, in meters. When omitted, the configured nearby-tasks distance is used.

_id

array of strings

Task ID(s)

_id

taskTypeId

string

Task type ID

groupId

string

Group ID

status

string

Task status (e.g., open, confirmed, completed)

_updatedAt

string

Selector object for updated at timestamp — supports $gt (greater than) and $lt (less than) attributes using Unix timestamp(s) in milliseconds - maximum allowed range is 365 days

skip

integer

Skip from index count (default: 0)

limit

integer

Number of items (default: 100, max: 100)

Headers

bsy-sid

string

required

Session ID

Responses

200Nearby tasks retrieved successfully

400Bad request, missing required fields or invalid data

401Unauthorized access, invalid or missing session ID