Filter MykaarmaDealerOrders by request - PaymentDealerOrder + StandardOrderDTO
ApiScope: payment.paymentdealerorder.read
API Scope Level: DepartmentScope
Path Parameters
departmentUuid string required
Query Parameters
fetchDealerOrderFromRedis boolean required
Search for DealerOrder in Redis
fetchInvoicesAndSignatureRequest boolean required
Fetch invoices and signature request details for orders
application/json
Request Body required
dealerOrderUuids string[]
dealerUUID string
startDate string
endDate string
userUUID string
orderFilterLabel string
orderType string
sortField string
sortOrder string
pageNumber string
pageSize string
customerUuidList string[]
orderStatus string[]
exactOrderNumber string
Responses
- 200
OK
*/*
Schema
Example (from schema)
Schema
errors object[]
warnings object[]
mykaarmaDealerOrderList object[]
{
"errors": [
{
"errorCode": 0,
"errorTitle": "string",
"errorMessage": "string",
"errorDescription": "string"
}
],
"warnings": [
{
"warningCode": 0,
"warningTitle": "string",
"warningMessage": "string",
"warningDescription": "string"
}
],
"mykaarmaDealerOrderList": [
{
"paymentDealerOrderDTO": {
"orderNumber": "string",
"orderType": "string",
"orderDate": "2025-03-28T11:34:46.582Z",
"paymentDealer": {
"dealerUuid": "string",
"name": "string"
},
"paymentCustomer": {
"customerUuid": "string",
"firstName": "string",
"middleName": "string",
"lastName": "string",
"company": "string"
},
"paymentUser": {
"id": 0,
"dealerAssociateUUID": "string",
"userUUID": "string",
"dealerDepartmentUUID": "string"
},
"signatureRequestId": 0,
"departmentUuid": "string",
"dealerOrderUuid": "string",
"numberOfInvoices": 0,
"readyROData": "string",
"paidAmount": 0,
"amount": 0,
"dealerOrderSyncDate": "2025-03-28T11:34:46.582Z",
"paidInKaarma": true,
"suspicious": true,
"paid": true,
"paymentRequestSent": true,
"paidOnline": true
},
"standardOrderDTO": {
"dealerAssociateUuid": "string",
"dealerUuid": "string",
"dms": "ADP,0",
"orderNumber": "string",
"orderType": "string",
"description": "string",
"orderStatus": "string",
"dmsRawStatus": "string",
"isWaiter": true,
"tagOrHat": "string",
"mileageText": "string",
"transportOption": "string",
"departmentType": "string",
"labourOpTypes": "string",
"payTypes": "string",
"id": 0,
"uuid": "string",
"creatorAssociateUuid": "string",
"laborTypes": "string",
"dealerOrderStatusFilter": [
"string"
],
"invoiceUrl": "string",
"amount": 0,
"vehicle": {
"uuid": "string",
"vin": "string",
"make": "string",
"key": "string",
"model": "string",
"color": "string",
"licensePlate": "string"
},
"customer": {
"uuid": "string",
"key": "string",
"firstName": "string",
"lastName": "string"
},
"paymentInfo": {
"deliveryAmount": 0,
"paidAmount": 0,
"numberOfInvoices": 0,
"readyROData": "string",
"isPaymentRequestSent": true,
"isPaidOnline": true,
"customerSignatureUrl": "string",
"isSuspicious": true
},
"dateInfo": {
"orderDate": "string",
"printDate": "string",
"closeDate": "string",
"updated_dt": "string",
"promiseTime": "string",
"created_dt": "string",
"dmsSyncDate": "string"
},
"transactions": [
{
"tenderDataId": 0,
"transactionId": 0,
"deviceId": 0,
"transactionTypeId": 0,
"transactionAmount": 0,
"ccNumber": "string"
}
],
"summary": [
{
"originalEstimate": 0,
"warrantyAmount": 0,
"salesTax": 0,
"laborTotal": 0,
"getcPAmount": "string",
"partsTotal": 0,
"orderStatus": "string",
"techniciansUuids": [
"string"
],
"jobCount": 0
}
],
"advisorDetails": {
"userUuid": "string",
"departmentUuid": "string",
"firstName": "string",
"lastName": "string"
},
"creatorDetails": {
"userUuid": "string",
"departmentUuid": "string",
"firstName": "string",
"lastName": "string"
}
},
"isAuthorised": true,
"lastPaidInvoiceGuid": "string",
"signedInvoiceUrl": "string",
"invoices": [
{
"id": 0,
"guid": "string",
"invoiceStatus": "string",
"amount": 0,
"invoiceDate": "2025-03-28T11:34:46.582Z",
"description": "string",
"refundedAmount": 0,
"paidDate": "2025-03-28T11:34:46.582Z",
"fileName": "string",
"reminderMileage": 0,
"reminderDate": "2025-03-28T11:34:46.582Z",
"signatureFileName": "string",
"paymentDeclines": "string",
"invoiceAttributes": {},
"paymentDealer": {
"dealerUuid": "string"
},
"paymentDealerOrder": {
"orderNumber": "string",
"orderType": "string",
"departmentUuid": "string",
"dealerOrderUuid": "string"
},
"paymentCustomer": {
"customerUuid": "string"
},
"paymentUser": {
"id": 0,
"dealerAssociateUUID": "string",
"userUUID": "string",
"dealerDepartmentUUID": "string"
}
}
],
"mykaarmaCustomer": {
"errors": [
{
"errorCode": 0,
"errorTitle": "string",
"errorMessage": "string",
"errorDescription": "string"
}
],
"warnings": [
{
"warningCode": 0,
"warningTitle": "string",
"warningMessage": "string",
"warningDescription": "string"
}
],
"customer": {
"guid": "string",
"firstName": "string",
"lastName": "string",
"company": "string",
"customerKey": "string",
"preferredLocale": "string",
"preferredCommunication": "string",
"bestTimeToContact": {
"startTime": "string",
"endTime": "string"
},
"isBusiness": true,
"availability": 0,
"addresses": [
{
"line1": "string",
"line2": "string",
"city": "string",
"zip": "string",
"addressType": "string",
"type": "COMMON",
"country": "string",
"updateTS": "2025-03-28T11:34:46.583Z",
"uuid": "string",
"isValid": true,
"isPreferred": true,
"state": "string"
}
],
"emails": [
{
"emailAddress": "string",
"label": "string",
"okToEmail": true,
"isPreferred": true,
"comments": "string"
}
],
"phoneNumbers": [
{
"phoneNumber": "string",
"label": "string",
"okToCall": true,
"okToText": true,
"isPreferred": true,
"comments": "string"
}
]
},
"vehicles": [
{
"uuid": "string",
"model": "string",
"trim": "string",
"vin": "string",
"engine": "string",
"year": "string",
"licensePlate": "string",
"make": "string",
"isValid": true,
"customerUuid": "string"
}
]
}
}
]
}
POST /v4/departments/:departmentUuid/mykaarma-dealer-orders/searches
Authorization
name: basicAuthtype: httpscheme: basic
Request
Request
curl / cURL
curl -L -X POST '/payment/v4/departments/:departmentUuid/mykaarma-dealer-orders/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: */*' \
--data-raw '{
"dealerOrderUuids": [
"string"
],
"dealerUUID": "string",
"startDate": "string",
"endDate": "string",
"userUUID": "string",
"orderFilterLabel": "string",
"orderType": "string",
"sortField": "string",
"sortOrder": "string",
"pageNumber": "string",
"pageSize": "string",
"customerUuidList": [
"string"
],
"orderStatus": [
"string"
],
"exactOrderNumber": "string"
}'
python / requests
curl -L -X POST '/payment/v4/departments/:departmentUuid/mykaarma-dealer-orders/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: */*' \
--data-raw '{
"dealerOrderUuids": [
"string"
],
"dealerUUID": "string",
"startDate": "string",
"endDate": "string",
"userUUID": "string",
"orderFilterLabel": "string",
"orderType": "string",
"sortField": "string",
"sortOrder": "string",
"pageNumber": "string",
"pageSize": "string",
"customerUuidList": [
"string"
],
"orderStatus": [
"string"
],
"exactOrderNumber": "string"
}'
go / native
curl -L -X POST '/payment/v4/departments/:departmentUuid/mykaarma-dealer-orders/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: */*' \
--data-raw '{
"dealerOrderUuids": [
"string"
],
"dealerUUID": "string",
"startDate": "string",
"endDate": "string",
"userUUID": "string",
"orderFilterLabel": "string",
"orderType": "string",
"sortField": "string",
"sortOrder": "string",
"pageNumber": "string",
"pageSize": "string",
"customerUuidList": [
"string"
],
"orderStatus": [
"string"
],
"exactOrderNumber": "string"
}'
nodejs / axios
curl -L -X POST '/payment/v4/departments/:departmentUuid/mykaarma-dealer-orders/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: */*' \
--data-raw '{
"dealerOrderUuids": [
"string"
],
"dealerUUID": "string",
"startDate": "string",
"endDate": "string",
"userUUID": "string",
"orderFilterLabel": "string",
"orderType": "string",
"sortField": "string",
"sortOrder": "string",
"pageNumber": "string",
"pageSize": "string",
"customerUuidList": [
"string"
],
"orderStatus": [
"string"
],
"exactOrderNumber": "string"
}'
ruby / Net::HTTP
curl -L -X POST '/payment/v4/departments/:departmentUuid/mykaarma-dealer-orders/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: */*' \
--data-raw '{
"dealerOrderUuids": [
"string"
],
"dealerUUID": "string",
"startDate": "string",
"endDate": "string",
"userUUID": "string",
"orderFilterLabel": "string",
"orderType": "string",
"sortField": "string",
"sortOrder": "string",
"pageNumber": "string",
"pageSize": "string",
"customerUuidList": [
"string"
],
"orderStatus": [
"string"
],
"exactOrderNumber": "string"
}'
csharp / RestSharp
curl -L -X POST '/payment/v4/departments/:departmentUuid/mykaarma-dealer-orders/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: */*' \
--data-raw '{
"dealerOrderUuids": [
"string"
],
"dealerUUID": "string",
"startDate": "string",
"endDate": "string",
"userUUID": "string",
"orderFilterLabel": "string",
"orderType": "string",
"sortField": "string",
"sortOrder": "string",
"pageNumber": "string",
"pageSize": "string",
"customerUuidList": [
"string"
],
"orderStatus": [
"string"
],
"exactOrderNumber": "string"
}'
php / cURL
curl -L -X POST '/payment/v4/departments/:departmentUuid/mykaarma-dealer-orders/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: */*' \
--data-raw '{
"dealerOrderUuids": [
"string"
],
"dealerUUID": "string",
"startDate": "string",
"endDate": "string",
"userUUID": "string",
"orderFilterLabel": "string",
"orderType": "string",
"sortField": "string",
"sortOrder": "string",
"pageNumber": "string",
"pageSize": "string",
"customerUuidList": [
"string"
],
"orderStatus": [
"string"
],
"exactOrderNumber": "string"
}'
java / OkHttp
curl -L -X POST '/payment/v4/departments/:departmentUuid/mykaarma-dealer-orders/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: */*' \
--data-raw '{
"dealerOrderUuids": [
"string"
],
"dealerUUID": "string",
"startDate": "string",
"endDate": "string",
"userUUID": "string",
"orderFilterLabel": "string",
"orderType": "string",
"sortField": "string",
"sortOrder": "string",
"pageNumber": "string",
"pageSize": "string",
"customerUuidList": [
"string"
],
"orderStatus": [
"string"
],
"exactOrderNumber": "string"
}'
powershell / RestMethod
curl -L -X POST '/payment/v4/departments/:departmentUuid/mykaarma-dealer-orders/searches' \
-H 'Content-Type: application/json' \
-H 'Accept: */*' \
--data-raw '{
"dealerOrderUuids": [
"string"
],
"dealerUUID": "string",
"startDate": "string",
"endDate": "string",
"userUUID": "string",
"orderFilterLabel": "string",
"orderType": "string",
"sortField": "string",
"sortOrder": "string",
"pageNumber": "string",
"pageSize": "string",
"customerUuidList": [
"string"
],
"orderStatus": [
"string"
],
"exactOrderNumber": "string"
}'