Skip to Content

PackageOrdersApi

All URIs are relative to https://business.apis.kesk.app/v1 

MethodHTTP requestDescription
fetchPackageOrderVendorsPOST /package-order/fetch-vendorsFind vendors that service specified delivery locations.
getPackageOrderSummaryPOST /package-order/summaryCalculate complete pricing for a package delivery order.
verifyOrderStopPOST /package-order/verify-stop/{id}Mark a delivery stop as completed with proof.

fetchPackageOrderVendors

FetchVendorsResponse fetchPackageOrderVendors(FetchVendorsInput)

Find vendors that service specified delivery locations.

Discovers available package delivery vendors based on pickup and dropoff locations, package type, and vendor type. Validates that coordinates are within service boundaries and returns vendors with their pricing information and service coverage details.

Parameters

NameTypeDescriptionNotes
FetchVendorsInputFetchVendorsInputVendor search criteria including locations and package type

Return type

FetchVendorsResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: application/json; charset=utf-8
  • Accept: application/json; charset=utf-8

getPackageOrderSummary

PackageSummaryResponse getPackageOrderSummary(PackageOrderSummaryInput)

Calculate complete pricing for a package delivery order.

Computes total cost including base delivery fee, distance-based pricing, package size fees, multiple stop charges, taxes, vendor fees, and coupon discounts. Validates location service coverage and calculates distances between all stops.

Parameters

NameTypeDescriptionNotes
PackageOrderSummaryInputPackageOrderSummaryInputPackage order details including vendor, locations, package type, and weight

Return type

PackageSummaryResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: application/json; charset=utf-8
  • Accept: application/json; charset=utf-8

verifyOrderStop

MessageResponse verifyOrderStop(id, signature, photos)

Mark a delivery stop as completed with proof.

Verifies package delivery at a specific stop by uploading signature and photos as proof of delivery. Updates the stop status to verified and stores all uploaded documentation for delivery confirmation.

Parameters

NameTypeDescriptionNotes
idLongOrder stop ID to verify[default to null]
signatureList[default to null]
photosList[default to null]

Return type

MessageResponse

Authorization

JwtAuthScheme

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json; charset=utf-8