List Messages

GET /drivers/{driver_id}/chats

Create new chat message.

Roles

Users with the following roles may access this endoint:

Admin
CrmUser
Dispatcher
Driver
ThirdPartyAdmin
ThirdPartyCrmUser
ThirdPartyDispatcher
ThirdPartyDriver

Request

Path Parameters

driver_id String, Required

Driver identifier.

Query Parameters

end_date String, Optional

Filter messages on or before this date.

  • Date in an ISO 8601 compatible format.

is_read Boolean, Optional

Return only read messages if TRUE, unread messages if FALSE. All messages if NULL or unspecified.

  • One of 0, 1, True, False (case insensitive).

page_index Integer, Optional

Paged results page index (starting from 1).

  • Less than or equal to 10000.
  • Greater than or equal to 1.

page_limit Integer, Optional

Maximun number of results per page.

  • Less than or equal to 1000.
  • Greater than or equal to 1.

start_date String, Optional

Filter messages on or after this date.

  • Date in an ISO 8601 compatible format.

Request Headers

Refer to StandardRequestHeadersModel for more details.

Authorization String, Required

Authorization header (bearer with access token). See the Authentication Guide to get started.

  • Matches ^bearer [a-z0-9-_=]+.[a-z0-9-_=]+.?[a-z0-9-_.+/=]*$
  • No longer than 256 characters.
  • At least 1 characters long.

x-tenant-id Integer, Required

Tenant identifier. Contact CRO Software for more info if you don't already have this id. See list tenant ids for info on listing the tenants you have access to.

Request Body

note

No request body

Response

Response Headers

Refer to StandardResponseHeadersModel for more details.

Accept String

Mime type (e.g. application/json).

  • At least 1 and no more than 256 characters.

x-request-id String

Request identifier.

  • Valid UUID.

Response Body

Refer to DriverChatMessageListModel for more details.

current_limit Integer

Maximun number of results per page.

  • Less than or equal to 1000.
  • Greater than or equal to 1.

current_page Integer

Paged results page index (starting from 1).

  • Less than or equal to 10000.
  • Greater than or equal to 1.

results Array[DriverChatMessageModel]

Refer to DriverChatMessageModel.


total_count Integer

Paged results total viewable records.

  • Less than or equal to 100000.
  • Greater than or equal to 0.

total_pages Integer

Paged results total pages.

  • Less than or equal to 1000.
  • Greater than or equal to 0.

Code Samples