Fetch a list of the form entries (v1)

Purpose: Motive provides multiple forms to collect and record data for various operational tasks. These forms mostly pertain to driver, vehicle, and to meet compliance norms. You can fetch the forms to view the data collected for your reporting purposes, or just to understand about the business metrics.

📘

NOTE

A single API call will fetch a maximum of 3 months of data.

Response Parameters

id

  • Type: Integer
  • Description: Unique identifier for the form entry.

form_id

  • Type: String
  • Description: ID of the form associated with the entry.

form_version

  • Type: Integer
  • Description: Version of the form used for the entry.

dispatch_id

  • Type: Integer
  • Description: ID of the dispatch associated with the form entry.

vendor_dispatch_id

  • Type: String
  • Description: Vendor's dispatch ID.

vendor_stop_id

  • Type: Integer
  • Description: ID of the vendor stop.

driver_id

  • Type: Integer
  • Description: ID of the driver who completed the form entry.

vehicle_id

  • Type: Integer
  • Description: ID of the vehicle associated with the form entry (null if not applicable).

entry

  • Type: Object

  • Description: The data entered in the form.

bol

  • Type: String
  • Description: Bill of Lading number.

weight

  • Type: Integer
  • Description: Weight recorded in the form.

scanned_bol_image

  • Type: Array of Objects

  • Description: List of images related to the Bill of Lading.

filename

  • Type: String
  • Description: Name of the image file.

mime_type

  • Type: String
  • Description: MIME type of the image (e.g., "image/jpeg").

url

  • Type: String
  • Description: URL where the image can be accessed.

customer_signature

  • Type: Object

  • Description: Image of the customer's signature.

filename

  • Type: String
  • Description: Name of the signature image file.

mime_type

  • Type: String
  • Description: MIME type of the signature image (e.g., "image/jpeg").

url

  • Type: String
  • Description: URL where the signature image can be accessed.

lat

  • Type: Integer
  • Description: Latitude coordinate of the form entry location.

lon

  • Type: Integer
  • Description: Longitude coordinate of the form entry location.

bearing

  • Type: Integer
  • Description: Bearing direction of the vehicle at the time of the entry.

odometer

  • Type: Integer
  • Description: Odometer reading at the time of the entry.

speed

  • Type: Integer
  • Description: Speed of the vehicle at the time of the entry.

location

  • Type: String
  • Description: Description of the location (e.g., "2 mi NW San Francisco").

entered_at

  • Type: String (Date-Time)
  • Description: Timestamp when the form entry was made.

created_at

  • Type: String (Date-Time)
  • Description: Timestamp when the form entry was created.

rg_brg

  • Type: Integer
  • Description: Registration bearing.

rg_km

  • Type: Integer
  • Description: Registration kilometers.

rg_match

  • Type: Boolean
  • Description: Indicates if the registration matches (e.g., false).

Language
Credentials
Header
Click Try It! to start a request and see the response here!