List all the company dispatch records

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Purpose: Use this API to fetch a list of all the dispatch records for your organisation.

šŸ“˜

Querying multiple IDs

If you want to query multiple IDs, Vendor IDs, and Driver IDs, it is suggested to add parenthesis after the corresponding parameter. For example, ids[]=3743956&ids[]=3989686.

Response Parameters

dispatches

  • Type: Array of Objects
  • Description: List of dispatches.

dispatch

  • Type: Object
  • Description: Information about a specific dispatch.

id

  • Type: Integer
  • Description: Unique identifier for the dispatch.

vendor_id

  • Type: String
  • Description: Vendor identifier associated with the dispatch.

vendor_shipper_id

  • Type: String
  • Description: Vendor shipper identifier.

vendor_consignee_id

  • Type: String
  • Description: Vendor consignee identifier.

driver_id

  • Type: Integer
  • Description: Unique identifier for the driver associated with the dispatch.

vehicle_id

  • Type: Integer
  • Description: Unique identifier for the vehicle associated with the dispatch.

additional_drops

  • Type: Integer
  • Description: Number of additional drop-off locations.

additional_pickups

  • Type: Integer
  • Description: Number of additional pickup locations.

consignee_bill_of_lading

  • Type: String
  • Description: Bill of lading number provided by the consignee.

consignee_comments

  • Type: String
  • Description: Comments provided by the consignee.

consignee_driver_load

  • Type: Boolean
  • Description: Indicates if the consignee will load the driver.

consignee_form_ids

  • Type: Array of Strings
  • Description: List of form IDs associated with the consignee.

consignee_pallets

  • Type: Integer
  • Description: Number of pallets handled by the consignee.

consignee_pieces

  • Type: Integer
  • Description: Number of pieces handled by the consignee.

consignee_refno

  • Type: String
  • Description: Reference number provided by the consignee.

consignee_status

  • Type: String
  • Description: Status of the consignee (e.g., "departed").

consignee_type

  • Type: String
  • Description: Type of consignee (e.g., "DROPOFF").

consignee_volume

  • Type: Float
  • Description: Volume of goods handled by the consignee (if available).

consignee_weight

  • Type: Float
  • Description: Weight of goods handled by the consignee.

delivery_early_date

  • Type: String
  • Description: Earliest date for delivery.

delivery_late_date

  • Type: String
  • Description: Latest date for delivery.

loaded_miles

  • Type: Integer
  • Description: Loaded miles for the dispatch.

order_pieces

  • Type: Integer
  • Description: Number of pieces in the order (if available).

order_volume

  • Type: Float
  • Description: Volume of the order (if available).

order_weight

  • Type: Float
  • Description: Weight of the order (if available).

pickup_early_date

  • Type: String
  • Description: Earliest date for pickup.

pickup_late_date

  • Type: String
  • Description: Latest date for pickup.

pickup_number

  • Type: String
  • Description: Pickup number for the dispatch.

product

  • Type: String
  • Description: Product being shipped.

shipper_bill_of_lading

  • Type: String
  • Description: Bill of lading number provided by the shipper.

shipper_comments

  • Type: String
  • Description: Comments provided by the shipper.

shipper_driver_load

  • Type: Boolean
  • Description: Indicates if the shipper will load the driver.

shipper_form_ids

  • Type: Array of Strings
  • Description: List of form IDs associated with the shipper.

shipper_pallets

  • Type: Integer
  • Description: Number of pallets handled by the shipper.

shipper_pieces

  • Type: Integer
  • Description: Number of pieces handled by the shipper.

shipper_status

  • Type: String
  • Description: Status of the shipper (e.g., "departed").

shipper_type

  • Type: String
  • Description: Type of shipper (e.g., "PICKUP").

shipper_volume

  • Type: Float
  • Description: Volume of goods handled by the shipper (if available).

shipper_weight

  • Type: Float
  • Description: Weight of goods handled by the shipper.

status

  • Type: String
  • Description: Overall status of the dispatch (e.g., "completed").

temperature_max

  • Type: Float
  • Description: Maximum temperature for the dispatch.

temperature_min

  • Type: Float
  • Description: Minimum temperature for the dispatch.

trailer

  • Type: String
  • Description: Trailer information.

shipper_dispatch_location_id

  • Type: Integer
  • Description: Unique identifier for the shipper's dispatch location.

consignee_dispatch_location_id

  • Type: Integer
  • Description: Unique identifier for the consignee's dispatch location.

vendor_shipper_dispatch_location_id

  • Type: String
  • Description: Vendor's shipper dispatch location identifier.

vendor_consignee_dispatch_location_id

  • Type: String
  • Description: Vendor's consignee dispatch location identifier.

custom_field1

  • Type: Mixed
  • Description: Custom field 1 (if available).

dispatch_stops

  • Type: Array of Objects
  • Description: List of stops associated with the dispatch.

dispatch_stop

  • Type: Object
  • Description: Information about a specific stop within a dispatch.

id (dispatch_stop)

  • Type: Integer
  • Description: Unique identifier for the dispatch stop.

vendor_id (dispatch_stop)

  • Type: String
  • Description: Vendor identifier associated with the dispatch stop.

bill_of_lading

  • Type: String
  • Description: Bill of lading number for the dispatch stop.

comments

  • Type: String
  • Description: Comments for the dispatch stop.

driver_load

  • Type: Boolean
  • Description: Indicates if the driver will load at this stop.

early_date

  • Type: String
  • Description: Earliest date for the stop.

form_ids

  • Type: Array of Strings
  • Description: List of form IDs associated with the stop.

late_date

  • Type: String
  • Description: Latest date for the stop.

number

  • Type: Integer
  • Description: Stop number in the sequence.

pallets_in

  • Type: Integer
  • Description: Number of pallets received at this stop.

pallets_out

  • Type: Integer
  • Description: Number of pallets delivered at this stop.

pieces

  • Type: Integer
  • Description: Number of pieces handled at this stop.

status (dispatch_stop)

  • Type: String
  • Description: Status of the dispatch stop (e.g., "available").

type

  • Type: String
  • Description: Type of stop (e.g., "PU" for pickup).

volume

  • Type: Float
  • Description: Volume of goods handled at this stop.

weight

  • Type: Float
  • Description: Weight of goods handled at this stop.

custom_field1 (dispatch_stop)

  • Type: Mixed
  • Description: Custom field 1 for the stop (if available).

dispatch_location_id

  • Type: Integer
  • Description: Unique identifier for the dispatch location associated with the stop.

vendor_dispatch_location_id

  • Type: String
  • Description: Vendor's dispatch location identifier for the stop.

Query Params
ids[]
array of int32s

Specify the ID of the dispatches that you want to view.

ids[]
vendor_ids
array of strings

Specify one or more vendor IDs for filter the search.

vendor_ids
driver_ids[]
array of int32s

Specify the driver ID for fetching the dispatch record for the particular driver.

driver_ids[]
vehicle_ids[]
array of int32s

Specify the ID of the vehicle for which you want to fetch the dispatch records.

vehicle_ids[]
statuses
array of strings

Specify the status of the dispatch to fetch the records of that particular value. Allowed values are "planned", "active", "completed", "cancelled"

statuses
boolean

Use this parameter to include the dispatches created on the Motive dashboard. Allowed values are true: Include all the dispatches created on the Motive Dashboard. false: Do not include the dispatches created on the Motive Dashboard.

date

Fetch the dispatch records that were updated after the specified date.

date

Fetch the dispatch records that were updated before the specified time.

int32
Defaults to 25

Denote the number of records displayed per page.

int32
Defaults to 1

Denotes the current page number.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json