--- title: "Get delivery jobs list" method: GET path: "/{aplicationId}/delivery-jobs" --- # Get delivery jobs list `GET /{aplicationId}/delivery-jobs` This endpoint is used to retrieve detailed information about delivery jobs. You can track delivery performance, filter delivery data and handle large datasets efficiently. ## Path parameters - `aplicationId` string, required ## Query parameters - `fromDate` string - `toDate` string - `storeId` string - `status` string - `page_no` integer - `size` integer ## Response `200` List of delivery jobs - DeliveryJobList — Represents a paginated response containing a list of delivery jobs. It provides details about each job along with pagination metadata for efficient data retrieval. - `page` object — Specifies the page number of the results when retrieving a paginated list of delivery jobs. It is used for pagination to navigate through multiple pages of data efficiently. - `size` integer — Specifies the number of records to be returned per page when retrieving a paginated list of delivery jobs. It works alongside the page attribute to control pagination. - `totalElements` integer — Represents the total number of records available in the dataset, regardless of pagination. It is used to determine the total count of delivery jobs or orders in a paginated response. - `totalPages` integer — Represents the total number of pages available in a paginated response. It is calculated based on the totalElements and size attributes. - `number` integer — Represents the current page number in a paginated response. It helps track which page of results is being returned. - `_links` object — Provides metadata links for the resource. These links are used to navigate between related resources or actions associated with the current resource. The links may represent actions like "self", "next", "previous", "first", "last", or any other relevant related operations. - `first` object — Represents the first page of the paginated results. - `href` string — Represents the Uniform Resource Locator (URL) associated with a specific link in the response. - `self` object — A link that points to the current resource being viewed or manipulated. It is used to represent the "self-reference" of the current resource, enabling clients to understand and refer to the exact resource they are working with. - `href` string - `prv` object — Typically refers to a link pointing to the previous page in a paginated response. - `href` string - `next` object — A link that points to the next page in a paginated response. - `href` string - `last` object — A link that points to the last page of a paginated response. - `href` string - `data` ExtendedDeliveryJob[] - `id` string, required — A unique identifier assigned to each delivery job. - `storeId` string, required — The unique identifier for the store associated with the delivery job. - `orderReferenceId` string, required — A unique identifier that refers to the order being delivered. - `item` Item[], required — A list of items to be delivered. Each object contains details of an individual item. - `name` string, required — The name or description of the item to be delivered. - `quantity` integer, required — The quantity of the specific item to be delivered. - `pickup` PickupOrDropOff - `contactName` string, required — The name of the person at the drop-off location. - `contactPhone` string, required — The contact phone number of the person at the drop-off location. - `location` Location, required - `address1` string, required — The primary address line for the pickup location. - `address2` string — The secondary address line for the pickup location (optional). - `area` string, required — The area or neighborhood of the pickup location. - `city` string, required — The city where the pickup location is situated. - `country` string — The country where the pickup location is situated. - `formattedAddress` string, required — A formatted version of the full address. - `coordinates` Coordinates, required - `latitude` string, required — The latitude of the location. - `longitude` string, required — The longitude of the location. - `notes` string — Any additional instructions for the delivery, such as security gate codes or preferred drop-off instructions. - `dropOff` ExtendedPickupOrDropOff, required - `contactName` string, required — The name of the person at the drop-off location. - `contactPhone` string, required — The contact phone number of the person at the drop-off location. - `location` Location, required - `address1` string, required — The primary address line for the pickup location. - `address2` string — The secondary address line for the pickup location (optional). - `area` string, required — The area or neighborhood of the pickup location. - `city` string, required — The city where the pickup location is situated. - `country` string — The country where the pickup location is situated. - `formattedAddress` string, required — A formatted version of the full address. - `coordinates` Coordinates, required - `latitude` string, required — The latitude of the location. - `longitude` string, required — The longitude of the location. - `notes` string — Any additional instructions for the delivery, such as security gate codes or preferred drop-off instructions. - `payment` Payment, required - `mode` 'CARD' | 'CASH' | 'PREPAID', required — Specifies the method of payment for the delivery order. It indicates how the payment will be handled at the time of delivery. - `amount` integer, required — The total amount to be collected at delivery. - `currencyCode` string, required — The currency of the payment, in ISO 4217 format (e.g., USD, AED). - `preparedAt` string, required — Represents the timestamp when the order was fully prepared and ready for pickup. It follows the ISO 8601 format (e.g., 2025-01-29T14:30:00Z). This helps coordinate the pickup timing with the courier. - `scheduledAt` string — Represents the timestamp when the delivery is planned to take place. It follows the ISO 8601 format (e.g., 2025-01-29T15:00:00Z). This helps coordinate the expected delivery time with the recipient. - `deliveryPartnerId` string — A unique ID for the delivery service handling the order. It helps track which third-party provider is responsible for the delivery. - `statusLog` StatusLog[] — Maintains a chronological history of status updates for the delivery job. Each entry in the array records a specific status change, including timestamps and relevant details. - `status` string - `timestamp` string - `reason` string - `courier` Courier - `trackingId` string — A unique identifier assigned to the delivery for tracking purposes. - `trackingUrl` string — A URL that provides real-time tracking information for the delivery. - `driverId` string — A unique identifier assigned to the delivery driver. - `driverName` string — The name of the delivery driver. - `driverMobileNumber` string — The mobile phone number of the delivery driver. - `pickUpAt` string — The timestamp (ISO 8601 format) indicating when the courier picked up the order from the pickup location. --- [API](https://skmtc.net/grubtech/apis/grubtech-auth-server.md) · [All operations](https://skmtc.net/grubtech/apis/grubtech-auth-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grubtech/grubtech-auth-server/revisions/21688b6dcb69/schema)