get
get
Header Parameters
authorization string required
authorization
application/json
Request Body required
filter
allTrips boolean
customerUuids string[]
dealerDepartmentUUIDList string[]
dealerUuids string[]
docStatuses string[]
Possible values: [UPLOAD_PENDING
, VERIFICATION_PENDING
, VERIFIED
, REQUEST_ITEMS
, VERIFY_ITEMS
, PREVIEW_ITEMS
]
driverUuids string[]
endApptTime string
eventUuids string[]
lastItemIndex int32
pageNumber int32
pageSize int32
requesterUserUUID string
rideTypes string[]
Possible values: [PICKUP_CUSTOMER
, PICKUP_VEHICLE
, DROPOFF_CUSTOMER
, DROPOFF_VEHICLE
, LOANER_SWAP
, MISCELLANEOUS
, RIDE_SHARE
]
sortOrder string
Possible values: [APPT_TIME_ASC
, APPT_TIME_DESC
]
source string
Possible values: [DEALER_APP
, WEB
, PND_API
, EXTERNAL_CONTROLLER
]
startApptTime string
subTripStatuses string[]
Possible values: [DRAFT
, AUTO_DRAFT
, ASSIGNED
, UNASSIGNED
, READY_TO_DRIVE
, STARTED
, IN_PROGRESS
, AT_DEALERSHIP
, COMPLETED
, CANCELLED
]
tripStatuses string[]
Possible values: [DRAFT
, AUTO_DRAFT
, ASSIGNED
, UNASSIGNED
, OUTBOUND
, INBOUND
, READY_TO_DRIVE
, AT_DESTINATION
, AT_DEALERSHIP
, COMPLETED
, CANCELLED
]
Responses
- 200
- 201
- 401
- 403
- 404
OK
application/json
Schema
Example (from schema)
Schema
error object
statusCode int32
totalCount int32
tripViewDtos object[]
warnings object[]
{
"error": {
"errorCode": "string",
"errorDescription": "string",
"metadata": {}
},
"statusCode": 0,
"totalCount": 0,
"tripViewDtos": [
{
"appointmentTime": "string",
"assignedBy": {
"departmentUuid": "string",
"firstName": "string",
"lastName": "string",
"roleName": "string",
"userUuid": "string",
"uuid": "string"
},
"createdDate": "string",
"customer": {
"dlVerified": true,
"firstName": "string",
"insuranceVerified": true,
"lastName": "string",
"signatureUrl": "string",
"uuid": "string"
},
"customerProfileToken": "string",
"dealerOrder": {
"orderNumber": "string",
"serviceAdvisor": {
"departmentUuid": "string",
"firstName": "string",
"lastName": "string",
"roleName": "string",
"userUuid": "string",
"uuid": "string"
},
"uuid": "string"
},
"department": {
"dealer": {
"name": "string",
"uuid": "string"
},
"name": "string",
"uuid": "string"
},
"docStatus": "UPLOAD_PENDING",
"driverPayments": [
{
"amountForMiles": 0,
"amountForMinutes": 0,
"amountForTrip": 0,
"dollarPerMile": 0,
"dollarPerMinute": 0,
"dollarPerTrip": 0,
"driverUuid": "string",
"salariedTotal": 0,
"totalAmount": 0,
"tripDetails": {
"distanceTravelledInMiles": 0,
"endDrivingTime": "string",
"endTime": "string",
"inboundStartTime": "string",
"maxSpeed": 0,
"outboundCompleteTime": "string",
"startDrivingTime": "string",
"startTime": "string",
"totalTimeInMinutes": 0
}
}
],
"eventUuid": "string",
"internalRideType": "PICKUP_VEHICLE_NO_LOANER",
"isValid": true,
"linkedAppointmentUuid": "string",
"linkedTripUuids": [
"string"
],
"loaner": {
"bookingStatus": "REQUEST_RESERVATION",
"description": "string",
"inspectionByDaUuid": "string",
"inspectionUuid": "string",
"isDropCar": true,
"isLoanerRequested": true,
"model": "string",
"uuid": "string"
},
"mustStartBy": "string",
"optionalFields": {},
"parentEventUuid": "string",
"primaryDriver": {
"departmentUuid": "string",
"firstName": "string",
"lastName": "string",
"roleName": "string",
"userUuid": "string",
"uuid": "string"
},
"rideType": "PICKUP_CUSTOMER",
"secondaryDriver": {
"departmentUuid": "string",
"firstName": "string",
"lastName": "string",
"roleName": "string",
"userUuid": "string",
"uuid": "string"
},
"serviceAdvisor": {
"departmentUuid": "string",
"firstName": "string",
"lastName": "string",
"roleName": "string",
"userUuid": "string",
"uuid": "string"
},
"subTrips": [
{
"destination": {
"address": "string",
"latitudeDouble": 0,
"longitude": 0
},
"distanceInMiles": 0,
"driver": {
"departmentUuid": "string",
"firstName": "string",
"lastName": "string",
"roleName": "string",
"userUuid": "string",
"uuid": "string"
},
"origin": {
"address": "string",
"latitudeDouble": 0,
"longitude": 0
},
"rideType": "OUTBOUND",
"status": "DRAFT",
"subTripUuid": "string",
"timeInMinutes": 0,
"transportType": "DEALERSHIP_VEHICLE"
}
],
"swappedLoaner": {
"bookingStatus": "REQUEST_RESERVATION",
"description": "string",
"inspectionByDaUuid": "string",
"inspectionUuid": "string",
"isDropCar": true,
"isLoanerRequested": true,
"model": "string",
"uuid": "string"
},
"tripStatus": "DRAFT",
"updatedBy": {
"departmentUuid": "string",
"firstName": "string",
"lastName": "string",
"roleName": "string",
"userUuid": "string",
"uuid": "string"
},
"vehicle": {
"estimatedMileage": "string",
"inspectionByDaUuid": "string",
"inspectionUuid": "string",
"make": "string",
"model": "string",
"uuid": "string",
"vin": "string",
"year": "string"
},
"version": 0
}
],
"warnings": [
{
"warningCode": "string",
"warningDescription": "string"
}
]
}
Created
Unauthorized
Forbidden
Not Found
POST /v3/trip-view/list
Request
Request
curl / cURL
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/trip-view/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"allTrips": true,
"customerUuids": [
"string"
],
"dealerDepartmentUUIDList": [
"string"
],
"dealerUuids": [
"string"
],
"docStatuses": [
"UPLOAD_PENDING"
],
"driverUuids": [
"string"
],
"endApptTime": "string",
"eventUuids": [
"string"
],
"lastItemIndex": 0,
"pageNumber": 0,
"pageSize": 0,
"requesterUserUUID": "string",
"rideTypes": [
"PICKUP_CUSTOMER"
],
"sortOrder": "APPT_TIME_ASC",
"source": "DEALER_APP",
"startApptTime": "string",
"subTripStatuses": [
"DRAFT"
],
"tripStatuses": [
"DRAFT"
]
}'
python / requests
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/trip-view/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"allTrips": true,
"customerUuids": [
"string"
],
"dealerDepartmentUUIDList": [
"string"
],
"dealerUuids": [
"string"
],
"docStatuses": [
"UPLOAD_PENDING"
],
"driverUuids": [
"string"
],
"endApptTime": "string",
"eventUuids": [
"string"
],
"lastItemIndex": 0,
"pageNumber": 0,
"pageSize": 0,
"requesterUserUUID": "string",
"rideTypes": [
"PICKUP_CUSTOMER"
],
"sortOrder": "APPT_TIME_ASC",
"source": "DEALER_APP",
"startApptTime": "string",
"subTripStatuses": [
"DRAFT"
],
"tripStatuses": [
"DRAFT"
]
}'
go / native
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/trip-view/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"allTrips": true,
"customerUuids": [
"string"
],
"dealerDepartmentUUIDList": [
"string"
],
"dealerUuids": [
"string"
],
"docStatuses": [
"UPLOAD_PENDING"
],
"driverUuids": [
"string"
],
"endApptTime": "string",
"eventUuids": [
"string"
],
"lastItemIndex": 0,
"pageNumber": 0,
"pageSize": 0,
"requesterUserUUID": "string",
"rideTypes": [
"PICKUP_CUSTOMER"
],
"sortOrder": "APPT_TIME_ASC",
"source": "DEALER_APP",
"startApptTime": "string",
"subTripStatuses": [
"DRAFT"
],
"tripStatuses": [
"DRAFT"
]
}'
nodejs / axios
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/trip-view/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"allTrips": true,
"customerUuids": [
"string"
],
"dealerDepartmentUUIDList": [
"string"
],
"dealerUuids": [
"string"
],
"docStatuses": [
"UPLOAD_PENDING"
],
"driverUuids": [
"string"
],
"endApptTime": "string",
"eventUuids": [
"string"
],
"lastItemIndex": 0,
"pageNumber": 0,
"pageSize": 0,
"requesterUserUUID": "string",
"rideTypes": [
"PICKUP_CUSTOMER"
],
"sortOrder": "APPT_TIME_ASC",
"source": "DEALER_APP",
"startApptTime": "string",
"subTripStatuses": [
"DRAFT"
],
"tripStatuses": [
"DRAFT"
]
}'
ruby / Net::HTTP
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/trip-view/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"allTrips": true,
"customerUuids": [
"string"
],
"dealerDepartmentUUIDList": [
"string"
],
"dealerUuids": [
"string"
],
"docStatuses": [
"UPLOAD_PENDING"
],
"driverUuids": [
"string"
],
"endApptTime": "string",
"eventUuids": [
"string"
],
"lastItemIndex": 0,
"pageNumber": 0,
"pageSize": 0,
"requesterUserUUID": "string",
"rideTypes": [
"PICKUP_CUSTOMER"
],
"sortOrder": "APPT_TIME_ASC",
"source": "DEALER_APP",
"startApptTime": "string",
"subTripStatuses": [
"DRAFT"
],
"tripStatuses": [
"DRAFT"
]
}'
csharp / RestSharp
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/trip-view/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"allTrips": true,
"customerUuids": [
"string"
],
"dealerDepartmentUUIDList": [
"string"
],
"dealerUuids": [
"string"
],
"docStatuses": [
"UPLOAD_PENDING"
],
"driverUuids": [
"string"
],
"endApptTime": "string",
"eventUuids": [
"string"
],
"lastItemIndex": 0,
"pageNumber": 0,
"pageSize": 0,
"requesterUserUUID": "string",
"rideTypes": [
"PICKUP_CUSTOMER"
],
"sortOrder": "APPT_TIME_ASC",
"source": "DEALER_APP",
"startApptTime": "string",
"subTripStatuses": [
"DRAFT"
],
"tripStatuses": [
"DRAFT"
]
}'
php / cURL
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/trip-view/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"allTrips": true,
"customerUuids": [
"string"
],
"dealerDepartmentUUIDList": [
"string"
],
"dealerUuids": [
"string"
],
"docStatuses": [
"UPLOAD_PENDING"
],
"driverUuids": [
"string"
],
"endApptTime": "string",
"eventUuids": [
"string"
],
"lastItemIndex": 0,
"pageNumber": 0,
"pageSize": 0,
"requesterUserUUID": "string",
"rideTypes": [
"PICKUP_CUSTOMER"
],
"sortOrder": "APPT_TIME_ASC",
"source": "DEALER_APP",
"startApptTime": "string",
"subTripStatuses": [
"DRAFT"
],
"tripStatuses": [
"DRAFT"
]
}'
java / OkHttp
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/trip-view/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"allTrips": true,
"customerUuids": [
"string"
],
"dealerDepartmentUUIDList": [
"string"
],
"dealerUuids": [
"string"
],
"docStatuses": [
"UPLOAD_PENDING"
],
"driverUuids": [
"string"
],
"endApptTime": "string",
"eventUuids": [
"string"
],
"lastItemIndex": 0,
"pageNumber": 0,
"pageSize": 0,
"requesterUserUUID": "string",
"rideTypes": [
"PICKUP_CUSTOMER"
],
"sortOrder": "APPT_TIME_ASC",
"source": "DEALER_APP",
"startApptTime": "string",
"subTripStatuses": [
"DRAFT"
],
"tripStatuses": [
"DRAFT"
]
}'
powershell / RestMethod
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/trip-view/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"allTrips": true,
"customerUuids": [
"string"
],
"dealerDepartmentUUIDList": [
"string"
],
"dealerUuids": [
"string"
],
"docStatuses": [
"UPLOAD_PENDING"
],
"driverUuids": [
"string"
],
"endApptTime": "string",
"eventUuids": [
"string"
],
"lastItemIndex": 0,
"pageNumber": 0,
"pageSize": 0,
"requesterUserUUID": "string",
"rideTypes": [
"PICKUP_CUSTOMER"
],
"sortOrder": "APPT_TIME_ASC",
"source": "DEALER_APP",
"startApptTime": "string",
"subTripStatuses": [
"DRAFT"
],
"tripStatuses": [
"DRAFT"
]
}'