Developer API

Vehicle Location API Documentation.

Integrate vehicle location and operational data into your applications using our API.

Back to website
API VERSION

Bearer Token Authentication

All API requests require a valid access token. Include the token in the Authorization header using the Bearer authentication scheme.

Authorization: Bearer {token}
GET

/vehicles/current

Returns the current location and information for all accessible vehicles.

Parameters
ParameterTypeDescription
pageintegerPage number. Starts from 0.
sizeintegerNumber of vehicles per page.
Request
curl -X 'GET' \
  'https://api.1s-eastwest-eld.com/logger/external/vehicles/current?page=0&size=10' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {token}'
Response Structure
{
  "result": {
    "code": "ok",
    "description": "ok"
  },
  "content": [...],
  "pageable": {
    "total": "total number of total elements",
    "prev": "the previous page number | null",
    "next": "the next page number | null",
    "current": "current page number"
  }
}
200 — Success
{
  "result": {
    "code": "ok",
    "description": "ok"
  },
  "content": [
    {
      "vehicle": {
        "id": 403,
        "make": "Freightliner",
        "model": "TR",
        "vin": "3AKJHHDR5JSHU5802",
        "unit_number": "424"
      },
      "driver": {
        "id": 849,
        "name": "AHADI MALAK"
      },
      "location": {
        "vehicle_coordinates": {
          "latitude": 40.353963,
          "longitude": -76.725971
        },
        "nearby_location_coordinates": {
          "latitude": 40.36351,
          "longitude": -76.74677
        },
        "distance": 1.69,
        "state": "PA",
        "location": "West Hanover Township",
        "time": "2024-04-06T08:53:52",
        "direction": "se"
      },
      "dot": "3666726"
    }
  ],
  "pageable": {
    "total": 140,
    "prev": null,
    "next": 1,
    "current": 0
  }
}
403 — Forbidden
{
  "result": {
    "code": "forbidden",
    "description": "forbidden"
  },
  "content": null
}
401 — Unauthorized
{
  "result": {
    "code": "invalid_token",
    "description": "Invalid token"
  },
  "content": null
}
GET

/vehicles/{unit_number}

Returns detailed vehicle information using the vehicle unit number.

Request
curl -X 'GET' \
  'https://api.1s-eastwest-eld.com/logger/external/vehicles/{unit_number}' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {token}'
200 — Success
{
  "result": {
    "code": "ok",
    "description": "ok"
  },
  "content": {
    "vehicle": {
      "id": 736,
      "make": "Volvo",
      "model": "VNL",
      "vin": "4V4NC9EJ2PN615282",
      "unit_number": "826"
    },
    "driver": {
      "id": 1487,
      "name": "Mustafa Sahebzada"
    },
    "location": {
      "vehicle_coordinates": {
        "latitude": 42.8255,
        "longitude": -76.8582
      },
      "nearby_location_coordinates": {
        "latitude": 42.819444444,
        "longitude": -76.825555555
      },
      "distance": 1.24,
      "state": "NY",
      "location": "Lackawanna",
      "time": "2024-10-02T13:39:37",
      "direction": "nw"
    },
    "dot": "3666726"
  }
}