List all positions for a asset.

GET 
/v1/assets/:uuid/positions

List all positions for a asset.

Request

Path Parameters

uuid uuidrequired

Unique identifier for the asset

Query Parameters

limit int64

Possible values: >= 1 and <= 100

Default value: 10

Number of items to return per page.

page int64

Possible values: >= 1

Default value: 1

Page number to return.

from date-time

Filter positions captured after this date and time.

to date-time

Filter positions captured before this date and time.

Responses

200

OK

application/json

Schema

Schema

$schema uri

A URL to the JSON Schema for this object.

data

object[]

required

Array [

accuracy double

Accuracy of the position

altitude double

Altitude of the position

asset uuidrequired

Unique identifier for the asset

capturedAt date-timerequired

Date and time the asset was captured.

createdAt date-timerequired

Date and time the asset was created.

deletedAt date-timerequired

Date and time the asset was deleted.

device stringrequired

Possible values: >= 16 characters and <= 16 characters

Unique identifier for the device

latitude doublerequired

Latitude of the position

longitude doublerequired

Longitude of the position

moving booleanrequired

Is the asset moving

receivedAt date-timerequired

Date and time the asset was captured.

source stringrequired

Possible values: [gnss, wifi, ble, lora]

Source of the position

updatedAt date-timerequired

Date and time the asset was updated.

]

metadata

object

required

limit int64required

page int64required

total int64required

totalPages int64required
status int64required
timestamp date-timerequired

Example (from schema)

{
  "$schema": "string",
  "data": [
    {
      "altitude": 0,
      "asset": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "capturedAt": "2024-06-25T14:10:22.440Z",
      "createdAt": "2024-06-25T14:10:22.440Z",
      "device": "string",
      "latitude": 0,
      "longitude": 0,
      "moving": true,
      "receivedAt": "2024-06-25T14:10:22.440Z",
      "source": "gnss"
    }
  ],
  "metadata": {
    "limit": 0,
    "page": 0,
    "total": 0,
    "totalPages": 0
  },
  "status": 0,
  "timestamp": "2024-06-25T14:10:22.440Z"
}

default

Error

application/problem+json

Schema

Schema

$schema uri

A URL to the JSON Schema for this object.

detail string

A human-readable explanation specific to this occurrence of the problem.

errors

object[]

Optional list of individual error details

Array [

location string

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

message string

Error message text

value

The value at the given location

]

instance uri

A URI reference that identifies the specific occurrence of the problem.

status int64

HTTP status code

title string

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

type uri

Default value: about:blank

A URI reference to human-readable documentation for the error.

Example (from schema)

{
  "$schema": "string",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string"
    }
  ],
  "instance": "string",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}

Loading...