# Fetches a list of Positions

We strongly recommend using Traccar WebSocket API instead of periodically polling positions endpoint. Without any params, it returns a list of last known positions for all the user's Devices. _from_ and _to_ fields are not required with _id_.

Endpoint: GET /positions
Version: 6.10.0
Security: BasicAuth, ApiKey

## Query parameters:

  - `deviceId` (integer)
    _deviceId_ is optional, but requires the _from_ and _to_ parameters when used

  - `from` (string)
    in ISO 8601 format. eg. 1963-11-22T18:30:00Z

  - `to` (string)
    in ISO 8601 format. eg. 1963-11-22T18:30:00Z

  - `id` (integer)
    To fetch one or more positions. Multiple params can be passed like id=31&id=42

## Response 200 fields (application/json):

  - `id` (integer)

  - `deviceId` (integer)

  - `protocol` (string)

  - `deviceTime` (string)
    in ISO 8601 format. eg. 1963-11-22T18:30:00Z

  - `fixTime` (string)
    in ISO 8601 format. eg. 1963-11-22T18:30:00Z

  - `serverTime` (string)
    in ISO 8601 format. eg. 1963-11-22T18:30:00Z

  - `valid` (boolean)

  - `latitude` (number)

  - `longitude` (number)

  - `altitude` (number)

  - `speed` (number)
    in knots

  - `course` (number)

  - `address` (string)

  - `accuracy` (number)

  - `network` (object)

  - `geofenceIds` (array)

  - `attributes` (object)