Fetch trips for a customer
End-point to fetch a list of trips for a customer. This end-point would return all trips (past and future) for the customer.
Path Parameters
customerUUID string required
Unique identifier for a customer
Header Parameters
authorization string required
Base64 encoded basic auth
application/json
Request Body required
Fetch trip for customer request
dealerDepartmentUUIDList string[]
dealerUUID string
requesterUserUUID string
source string
Possible values: [DEALER_APP
, WEB
, PND_API
, EXTERNAL_CONTROLLER
]
Responses
- 200
- 201
- 401
- 403
- 404
OK
application/json
Schema
Example (from schema)
Schema
error object
pickupDeliveryTripsList object[]
statusCode int32
warnings object[]
{
"error": {
"errorCode": "string",
"errorDescription": "string",
"metadata": {}
},
"pickupDeliveryTripsList": [
{
"appointmentTime": "string",
"assignedByDealerAssociateUUID": "string",
"clientSideLogs": [
"string"
],
"createdDate": "string",
"customerDlVerified": true,
"customerFirstName": "string",
"customerInsuranceVerified": true,
"customerLastName": "string",
"customerProfileToken": "string",
"customerSignatureUrl": "string",
"customerUUID": "string",
"customerVehicleInspectionId": "string",
"dealerDepartmentUUID": "string",
"dealerName": "string",
"dealerOrderUUID": "string",
"dealerUUID": "string",
"destLocationLat": 0,
"destLocationLon": 0,
"destinationAddress": "string",
"docStatus": "UPLOAD_PENDING",
"eventUUID": "string",
"internalNote": {
"attachmentList": [
"string"
],
"customerId": 0,
"customerUUID": "string",
"dealerAssociateId": 0,
"messageText": "string",
"recipientDAs": [
{
"dealerAssociateID": 0,
"dealerAssociateName": "string",
"dealerAssociateUserUuid": "string",
"isAssignee": true
}
],
"removedDAs": [
{
"dealerAssociateID": 0,
"dealerAssociateName": "string",
"dealerAssociateUserUuid": "string",
"isAssignee": true
}
]
},
"internalNoteMessageUUIDList": [
"string"
],
"internalRideType": "PICKUP_VEHICLE_NO_LOANER",
"isDropCar": true,
"isValid": true,
"linkedAppointmentUuid": "string",
"linkedTripUuids": [
"string"
],
"loanerDescription": "string",
"loanerModel": "string",
"loanerVehicleInspectionId": "string",
"loanerVehicleRequired": true,
"loanerVehicleUuid": "string",
"mustStartBy": "string",
"optionalFields": {},
"originAddress": "string",
"originLocationLat": 0,
"originLocationLon": 0,
"parentEventUUID": "string",
"primaryDriverFirstName": "string",
"primaryDriverLastName": "string",
"primaryDriverUUID": "string",
"rideType": "PICKUP_CUSTOMER",
"roNumber": "string",
"secondaryDriverFirstName": "string",
"secondaryDriverLastName": "string",
"secondaryDriverUUID": "string",
"sendMessageToCustomer": true,
"serviceAdvisorName": "string",
"serviceAdvisorUUID": "string",
"sharedRidePartner": "UBER",
"sharedRideRequest": {
"bookingType": "GENERAL",
"createdByUserFname": "string",
"createdByUserLname": "string",
"createdByUserUUID": "string",
"customerFname": "string",
"customerLname": "string",
"customerUUID": "string",
"dealerUUID": "string",
"departmentUuid": "string",
"fareValueAtBooking": 0,
"metadata": "string",
"module": "PICKUP_DELIVERY",
"orderNumber": "string",
"orderUUID": "string",
"phoneNumber": "string",
"rideType": "PICKUP_CUSTOMER",
"serviceAdvisorFname": "string",
"serviceAdvisorLname": "string",
"serviceAdvisorUUID": "string",
"updatedByUserFname": "string",
"updatedByUserLname": "string",
"updatedByUserUUID": "string"
},
"sharedRideResponse": {
"error": {
"errorCode": "string",
"errorDescription": "string",
"metadata": {}
},
"sharedRideUUID": "string",
"statusCode": 0,
"warnings": [
{
"warningCode": "string",
"warningDescription": "string"
}
]
},
"subTrips": [
{
"driverFirstName": "string",
"driverLastName": "string",
"driverUUID": "string",
"subRideType": "OUTBOUND",
"subTripStatus": "DRAFT",
"subTripUUID": "string",
"transportType": "DEALERSHIP_VEHICLE"
}
],
"swappedLoanerDescription": "string",
"swappedLoanerVehicleUuid": "string",
"tripStatus": "DRAFT",
"unlinkedInternalNoteMessageUuidList": [
"string"
],
"updatedByDealerAssociateUuid": "string",
"vehicleBookingStatus": "REQUEST_RESERVATION",
"vehicleIdentifiers": {
"estimatedMileage": "string",
"id": 0,
"vehicleMake": "string",
"vehicleModel": "string",
"vehicleUuid": "string",
"vehicleYear": "string",
"vin": "string"
},
"version": 0
}
],
"statusCode": 0,
"warnings": [
{
"warningCode": "string",
"warningDescription": "string"
}
]
}
Created
Unauthorized
Forbidden
Not Found
POST /v3/customer/:customerUUID/event/list
Request
Request
curl / cURL
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/customer/:customerUUID/event/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"dealerDepartmentUUIDList": [
"string"
],
"dealerUUID": "string",
"requesterUserUUID": "string",
"source": "DEALER_APP"
}'
python / requests
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/customer/:customerUUID/event/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"dealerDepartmentUUIDList": [
"string"
],
"dealerUUID": "string",
"requesterUserUUID": "string",
"source": "DEALER_APP"
}'
go / native
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/customer/:customerUUID/event/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"dealerDepartmentUUIDList": [
"string"
],
"dealerUUID": "string",
"requesterUserUUID": "string",
"source": "DEALER_APP"
}'
nodejs / axios
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/customer/:customerUUID/event/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"dealerDepartmentUUIDList": [
"string"
],
"dealerUUID": "string",
"requesterUserUUID": "string",
"source": "DEALER_APP"
}'
ruby / Net::HTTP
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/customer/:customerUUID/event/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"dealerDepartmentUUIDList": [
"string"
],
"dealerUUID": "string",
"requesterUserUUID": "string",
"source": "DEALER_APP"
}'
csharp / RestSharp
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/customer/:customerUUID/event/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"dealerDepartmentUUIDList": [
"string"
],
"dealerUUID": "string",
"requesterUserUUID": "string",
"source": "DEALER_APP"
}'
php / cURL
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/customer/:customerUUID/event/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"dealerDepartmentUUIDList": [
"string"
],
"dealerUUID": "string",
"requesterUserUUID": "string",
"source": "DEALER_APP"
}'
java / OkHttp
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/customer/:customerUUID/event/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"dealerDepartmentUUIDList": [
"string"
],
"dealerUUID": "string",
"requesterUserUUID": "string",
"source": "DEALER_APP"
}'
powershell / RestMethod
curl -L -X POST '//api.mykaarma.com/pickupdelivery/v3/customer/:customerUUID/event/list' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"dealerDepartmentUUIDList": [
"string"
],
"dealerUUID": "string",
"requesterUserUUID": "string",
"source": "DEALER_APP"
}'