List Contacts

GET 
https://secure.fleetio.com/api/v2/contacts

Returns a list of contacts excluding archived.

Request

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.
email object
oneOf
LikeFilter
likestringrequired
EqFilter
eqstringrequired
last_name object
oneOf
LikeFilter
likestringrequired
EqFilter
eqstringrequired
group_id object
eqstringrequired
employee_number object
eqstringrequired
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.
group_idSortAscDesc (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
email object
oneOf
LikeFilter
likestringrequired
EqFilter
eqstringrequired
MOD2
last_name object
oneOf
LikeFilter
likestringrequired
EqFilter
eqstringrequired
MOD3
group_id object
eqstringrequired
MOD4
employee_number object
eqstringrequired
MOD5
created_at object
oneOf
LtFilter
ltstringrequired
LteFilter
ltestringrequired
GtFilter
gtstringrequired
GteFilter
gtestringrequired
MOD6
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
group_idSortAscDesc (string)
Possible values: [asc, desc]
MOD2
created_atSortAscDesc (string)
Possible values: [asc, desc]
MOD3
updated_atSortAscDesc (string)
Possible values: [asc, desc]
MOD4
idSortAscDesc (string)
Possible values: [asc, desc]
]
records object[]
Array [
idinteger
Possible values: >= 1
created_atdate-time
The date and time at which this record was created.
Example: 2023-03-14T13:46:27-06:00
updated_atdate-time
The date and time at which this record was most recently updated.
Example: 2023-03-14T13:46:27-06:00
emailstringnullable
The Contact's email address.
namestringnullablerequired
The Contact's full name.
first_namestringnullablerequired
The Contact's first name.
middle_namestringnullablerequired
The Contact's middle name.
last_namestringnullablerequired
The Contact's last name.
group_idintegernullablerequired
If this Contact belongs to a Group, this will be the Fleetio ID of that Group.
group_namestringnullablerequired
If this Contact belongs to a Group, this will be the Group's name.
group_hierarchystringnullable
If this Contact belongs to a Group, this will be a pipe delimited string representing the Group hierarchy. Each Group in the list is the parent of the Groups which follow.
Example: Group 1|Group 2|Group 3
technicianbooleannullable
Whether or not the Contact is a Technician.
vehicle_operatorbooleannullable
Whether or not the Contact is a Vehicle Operator.
employeebooleannullable
Whether or not the Contact is an Employee.
birth_datedatenullable
The Contact's birth date.
Example: 2023-03-14
street_addressstringnullable
The Contact's street address.
Example: 123 Main St
street_address_line_2stringnullable
The Contact's street address line 2.
Example: Apt 1
citystringnullable
The Contact's city.
regionstringnullable
The Contact's region, state, or province.
postal_codestringnullable
The Contact's postal code, zip code, or equivalent.
countrystringnullable
The Contact's country.
employee_numberstringnullable
The Contact's employee number.
job_titlestringnullable
The Contact's job title.
Possible values: <= 255 characters
license_classstringnullable
The Contact's driver's license class.
license_numberstringnullable
The Contact's driver's license number.
license_statestringnullable
The locality which issued the Contact's license.
home_phone_numberstringnullable
The Contact's home phone number.
mobile_phone_numberstringnullable
The Contact's mobile phone number.
work_phone_numberstringnullable
The Contact's work phone number.
other_phone_numberstringnullable
Any other phone number for this Contact.
start_datedatenullable
When the Contact started working for the company, if applicable.
leave_datedatenullable
When the Contact left or will leave the company, if applicable.
hourly_labor_rate_centsintegernullable
The Contact's hourly rate in cents.
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.
default_image_urlstringnullablerequired
The URL of the Contact's default image/profile photo, if any.
account_membership_idNullableId (integer)nullable
Possible values: >= 1
last_api_requestdate-timenullable
The last date and time this Contact's associated User made an API request. Null if Contact is not assocated with a User.
last_web_accessdate-timenullable
The last date and time this Contact's associated User signed into the web application. Null if Contact is not assocated with a User.
last_mobile_app_accessdate-timenullable
The last date and time this Contact's associated User used the mobile app. Null if Contact is not assocated with a User.
custom_fieldsobjectnullable
*Full details on working with Custom Fields here.
imagesobject[]
A list of the images attached to this record.
images_countintegerrequired
The number of images attached to this record.
Possible values: >= 0
]

Example (auto)

{
  "start_cursor": "string",
  "next_cursor": "string",
  "per_page": 0,
  "estimated_remaining_count": 0,
  "filtered_by": [
    {
      "email": {
        "like": "string"
      }
    },
    {
      "last_name": {
        "like": "string"
      }
    },
    {
      "group_id": {
        "eq": "string"
      }
    },
    {
      "employee_number": {
        "eq": "string"
      }
    },
    {
      "created_at": {
        "lt": "string"
      }
    },
    {
      "updated_at": {
        "lt": "string"
      }
    }
  ],
  "sorted_by": [
    {
      "group_id": "asc"
    },
    {
      "created_at": "asc"
    },
    {
      "updated_at": "asc"
    },
    {
      "id": "asc"
    }
  ],
  "records": [
    {
      "id": 0,
      "created_at": "2023-03-14T13:46:27-06:00",
      "updated_at": "2023-03-14T13:46:27-06:00",
      "email": "string",
      "name": "string",
      "first_name": "string",
      "middle_name": "string",
      "last_name": "string",
      "group_id": 0,
      "group_name": "string",
      "group_hierarchy": "Group 1|Group 2|Group 3",
      "technician": true,
      "vehicle_operator": true,
      "employee": true,
      "birth_date": "2023-03-14",
      "street_address": "123 Main St",
      "street_address_line_2": "Apt 1",
      "city": "string",
      "region": "string",
      "postal_code": "string",
      "country": "string",
      "employee_number": "string",
      "job_title": "string",
      "license_class": "string",
      "license_number": "string",
      "license_state": "string",
      "home_phone_number": "string",
      "mobile_phone_number": "string",
      "work_phone_number": "string",
      "other_phone_number": "string",
      "start_date": "2024-07-29",
      "leave_date": "2024-07-29",
      "hourly_labor_rate_cents": 0,
      "attachment_permissions": {
        "read_photos": true,
        "manage_photos": true,
        "read_documents": true,
        "manage_documents": true
      },
      "default_image_url": "string",
      "account_membership_id": 0,
      "last_api_request": "2024-07-29T15:51:28.071Z",
      "last_web_access": "2024-07-29T15:51:28.071Z",
      "last_mobile_app_access": "2024-07-29T15:51:28.071Z",
      "custom_fields": {},
      "images": [
        {
          "id": 0,
          "created_at": "2023-03-14T13:46:27-06:00",
          "updated_at": "2023-03-14T13:46:27-06:00",
          "imageable_id": 0,
          "imageable_type": "ExpenseEntry",
          "file_name": "string",
          "file_mime_type": "image/jpeg",
          "file_size": 0,
          "file_url": "string",
          "full_url": "string"
        }
      ],
      "images_count": 0
    }
  ]
}

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

start_cursor — query

per_page — query

filter — query

emaillikeeq

last_namelikeeq

group_ideq

employee_numbereq

created_atltltegtgte

updated_atltltegtgte

sort — query

group_id---ascdesc

created_at---ascdesc

updated_at---ascdesc

id---ascdesc

ResponseClear

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