List Vehicle Assignments

GET 
https://secure.fleetio.com/api/v1/vehicles/:id/vehicle_assignments

List the Vehicle's assignments

Request

Path Parameters

id stringrequired

The Fleetio ID of the relevant Vehicle.

You may also look up Vehicles by their VIN, license plate, or other external ID. See the guide on External Vehicle Ids for information on how to set this up.

Query Parameters

start_cursor string

The start cursor for Keyset pagination.

per_page integer
Possible values: >= 2 and <= 100
The number of records per page to return
Default value: 50
filter object
The fields, operations, and values to filter the records by.
contact_id object
eqstringrequired
ended_at object
oneOf
LtFilter
ltstringrequired
LteFilter
ltestringrequired
GtFilter
gtstringrequired
GteFilter
gtestringrequired
created_at object
oneOf
LtFilter
ltstringrequired
LteFilter
ltestringrequired
GtFilter
gtstringrequired
GteFilter
gtestringrequired
updated_at object
oneOf
LtFilter
ltstringrequired
LteFilter
ltestringrequired
GtFilter
gtstringrequired
GteFilter
gtestringrequired
sort object
The fields and direction to sort the results by.
started_atSortAscDesc (string)
Possible values: [asc, desc]
ended_atSortAscDesc (string)
Possible values: [asc, desc]
created_atSortAscDesc (string)
Possible values: [asc, desc]
updated_atSortAscDesc (string)
Possible values: [asc, desc]
idSortAscDescDefaultDesc (string)
Possible values: [asc, desc]
Default value: desc

Responses

200

OK

application/json

Schema

Schema

start_cursorstringnullable
The current start cursor of the records returned.
next_cursorstringnullable
The next cursor to retrieve the next page of records.
per_pageinteger
The maxumum number of records returned.
estimated_remaining_countinteger
The number of remaining records including the returned records, up to a maximum of 500.
filtered_by object[]
The filters applied to the returned record set.
Array [
anyOf
MOD1
contact_id object
eqstringrequired
MOD2
ended_at object
oneOf
LtFilter
ltstringrequired
LteFilter
ltestringrequired
GtFilter
gtstringrequired
GteFilter
gtestringrequired
MOD3
created_at object
oneOf
LtFilter
ltstringrequired
LteFilter
ltestringrequired
GtFilter
gtstringrequired
GteFilter
gtestringrequired
MOD4
updated_at object
oneOf
LtFilter
ltstringrequired
LteFilter
ltestringrequired
GtFilter
gtstringrequired
GteFilter
gtestringrequired
]
sorted_by object[]
The sorts applied to the returned record set.
Array [
anyOf
MOD1
started_atSortAscDesc (string)
Possible values: [asc, desc]
MOD2
ended_atSortAscDesc (string)
Possible values: [asc, desc]
MOD3
created_atSortAscDesc (string)
Possible values: [asc, desc]
MOD4
updated_atSortAscDesc (string)
Possible values: [asc, desc]
MOD5
idSortAscDesc (string)
Possible values: [asc, desc]
]
records object[]
Array [
idintegerrequired
vehicle_idintegerrequired
The id of the vehicle associated with this Vehicle Assignment.
contact_idintegerrequired
The id of the contact associated with this Vehicle Assignment.
started_atdate-timenullablerequired
The date and time of this Vehicle Assignment. Dates in the future are accepted. We recommend using ISO-8601 formatted dates to avoid ambiguity.
Example: 2023-03-14T13:46:27-06:00
ended_atdate-timenullablerequired
The date and time of this Vehicle Assignment ending. We recommend using ISO-8601 formatted dates to avoid ambiguity.
Example: 2023-03-14T13:46:27-06:00
currentbooleanrequired
Whether this Vehicle Assignment is current/active.
Default value: false
futurebooleanrequired
Whether this Vehicle Assignment is set to take place in the future.
Default value: false
starting_meter_entry_valuenumbernullablerequired
The meter value at the start of this Vehicle Assignment.
ending_meter_entry_valuenumbernullablerequired
The meter value at the end of this Vehicle Assignment.
comments_countintegerrequired
The number of comments on this Vehicle Assignment.
attachment_permissions objectnullable
read_photosboolean
Indicates whether the user has read permission for photos.
manage_photosboolean
Indicates whether the user has permission to manage (eg. upload, delete) photos.
read_documentsboolean
Indicates whether the user has read permission for documents.
manage_documentsboolean
Indicates whether the user has permission to manage (eg. upload, delete) documents.
contact objectnullablerequired
A Contact
idinteger
emailstringnullable
The Contact's email address.
namestringnullable
The Contact's full name.
group_idintegernullable
If this Contact belongs to a Group, this will be the Fleetio ID of that Group.
employeebooleannullable
Whether or not the Contact is an employee.
employee_numberstringnullable
The employee number of the Contact.
default_image_urlstringnullable
The URL of the Contact's default image/profile photo, if any.
]

Example (auto)

{
  "start_cursor": "string",
  "next_cursor": "string",
  "per_page": 0,
  "estimated_remaining_count": 0,
  "filtered_by": [
    {
      "contact_id": {
        "eq": "string"
      }
    },
    {
      "ended_at": {
        "lt": "string"
      }
    },
    {
      "created_at": {
        "lt": "string"
      }
    },
    {
      "updated_at": {
        "lt": "string"
      }
    }
  ],
  "sorted_by": [
    {
      "started_at": "asc"
    },
    {
      "ended_at": "asc"
    },
    {
      "created_at": "asc"
    },
    {
      "updated_at": "asc"
    },
    {
      "id": "asc"
    }
  ],
  "records": [
    {
      "id": 0,
      "vehicle_id": 0,
      "contact_id": 0,
      "started_at": "2023-03-14T13:46:27-06:00",
      "ended_at": "2023-03-14T13:46:27-06:00",
      "current": false,
      "future": false,
      "starting_meter_entry_value": 0,
      "ending_meter_entry_value": 0,
      "comments_count": 0,
      "attachment_permissions": {
        "read_photos": true,
        "manage_photos": true,
        "read_documents": true,
        "manage_documents": true
      },
      "contact": {
        "id": 0,
        "email": "string",
        "name": "string",
        "group_id": 0,
        "employee": true,
        "employee_number": "string",
        "default_image_url": "string"
      }
    }
  ]
}

400

The format or parameters of the request was invalid

application/json

Schema

Schema

errors object
property name* string[]
Array [
string
]

Example (auto)

{
  "errors": {}
}

401

Request could not be authenticated

application/json

Schema

Schema

statusintegerrequired

Possible values: >= 400 and <= 599

titlestringrequired

A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

detailstring

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

instancestring

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

Example (auto)

{
  "status": 0,
  "title": "string",
  "detail": "string",
  "instance": "string"
}

500

Something unexpected happened

application/json

Schema

Schema

statusintegerrequired

Possible values: >= 400 and <= 599

titlestringrequired

A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

detailstring

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

instancestring

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

Example (auto)

{
  "status": 0,
  "title": "string",
  "detail": "string",
  "instance": "string"
}

Authorization: Authorization

name: Authorizationtype: apiKeyin: headerdescription: Prefix the value with "Token", for example: "Token 76cbe06c49a64".
You can generate a new API key [here](https://secure.fleetio.com/api_keys).

name: Account-Tokentype: apiKeyin: headerdescription: You can find your Account-Token [here](https://secure.fleetio.com/api_keys)

• curl
• ruby
• python
• csharp
• go
• java
• nodejs
• php

• CURL

Request Collapse all

Base URL

https://secure.fleetio.com/api

Auth

apiKey

accountToken

Parameters

id — pathrequired

start_cursor — query

per_page — query

filter — query

contact_ideq

ended_atltltegtgte

created_atltltegtgte

updated_atltltegtgte

sort — query

started_at---ascdesc

ended_at---ascdesc

created_at---ascdesc

updated_at---ascdesc

id---ascdesc

ResponseClear

Click the Send API Request button above and see the response here!