> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spurtcommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve shipment and delivery status for an order product.

> Retrieve shipment and delivery status for an order product.

**Authentication:** Customer bearer token required; permission `view-order-history` applies.

**Feature area:** Orders

**Implementation source:** `src/api/store/controllers/CustomerOrderController.ts`

**Request example provenance:** Source response fields and messages; sample values illustrative.

**Response example provenance:** Source response fields and messages; sample values illustrative.

> **Example status: Illustrative.** The example is included to demonstrate request/response shape in the reference UI; verify the owning controller and request DTO before using it as a contract.



## OpenAPI

````yaml /StoreAPI.json get /api/orders/track-order-product
openapi: 3.0.3
info:
  title: SpurtCommerce Store API
  version: 6.0.0
  description: >-
    Store API reference generated from the public SpurtCommerce repository
    (master, package version 6.0.0). Route inventory, controller annotations,
    request examples and response examples were used where available. Examples
    that are not explicitly defined by source annotations are marked
    illustrative in the operation description. This specification excludes Admin
    APIs.
  license:
    name: MIT
    url: https://github.com/spurtcommerce/spurtcommerce/blob/master/LICENSE
servers:
  - url: https://api.example.com
    description: Replace with your SpurtCommerce API host. Paths include the /api prefix.
security: []
tags:
  - name: Store
    description: Store API endpoint reference, organized by functional topic.
  - name: Cart
    description: >-
      Retrieve, create, update, and clear the authenticated customer shopping
      cart.
    x-parent: Store
    x-displayName: Cart
  - name: Customer address
    description: >-
      Create, retrieve, and manage customer addresses and live-address settings
      used during checkout.
    x-parent: Store
    x-displayName: Customer address
  - name: Customer profile
    description: >-
      Retrieve and update the signed-in customer profile and read customer
      permission modules and assignments.
    x-parent: Store
    x-displayName: Customer profile
  - name: Authentication
    description: >-
      Register customers, send and verify OTPs, sign in, sign out, and
      authenticate through supported OAuth providers.
    x-parent: Store
    x-displayName: Authentication
  - name: Wishlist
    description: >-
      Add products to the customer wishlist, list saved items, and remove
      wishlist entries.
    x-parent: Store
    x-displayName: Wishlist
  - name: Product discovery
    description: >-
      Discover products and categories, retrieve product details, compare
      products, and inspect filters, attributes, and variants.
    x-parent: Store
    x-displayName: Product discovery
  - name: Orders
    description: >-
      Retrieve order details and payment status, request cancellations, track
      shipments, download invoices, and retry payments.
    x-parent: Store
    x-displayName: Orders
  - name: Store content
    description: >-
      Retrieve storefront settings, categories, languages, zones, payment
      methods, CMS pages, banners, widgets, and contact information.
    x-parent: Store
    x-displayName: Store content
  - name: Payments
    description: >-
      Start supported Store payment flows for existing orders through PayPal,
      Razorpay, and Stripe.
    x-parent: Store
    x-displayName: Payments
  - name: Ratings and reviews
    description: >-
      Retrieve product rating counts, rating distributions, and customer reviews
      for product SKUs.
    x-parent: Store
    x-displayName: Ratings and reviews
  - name: Products
    x-parent: Product discovery
    description: Browse product listings and retrieve product details.
  - name: Categories
    x-parent: Product discovery
    description: Browse storefront product categories and category filters.
  - name: Product comparison
    x-parent: Product discovery
    description: Compare products and retrieve related product suggestions.
  - name: Attributes and variants
    x-parent: Product discovery
    description: Retrieve product attributes and variant options.
  - name: Product ratings and reviews
    x-parent: Product discovery
    description: Retrieve product ratings, statistics and customer reviews.
  - name: Customer login and sessions
    x-parent: Authentication
    description: Register, authenticate and sign out customer accounts.
  - name: OTP and verification
    x-parent: Authentication
    description: Send and verify one-time passwords for customer authentication.
  - name: OAuth authentication
    x-parent: Authentication
    description: Authenticate customers through supported OAuth providers.
  - name: Customer permissions
    x-parent: Customer profile
    description: Retrieve customer permission modules and assignments.
  - name: Address book
    x-parent: Customer address
    description: Manage customer delivery and billing addresses.
  - name: Cart items
    x-parent: Cart
    description: Retrieve, create and remove shopping cart items.
  - name: Order details and tracking
    x-parent: Orders
    description: Retrieve order details, tracking and payment status.
  - name: Order cancellation
    x-parent: Orders
    description: Retrieve cancellation reasons and submit cancellation requests.
  - name: Order payments
    x-parent: Orders
    description: Retry order payments and retrieve payment status.
  - name: Payment gateways
    x-parent: Payments
    description: Start Store payment flows for supported payment gateways.
  - name: Store configuration
    x-parent: Store content
    description: Retrieve storefront settings, payment methods and configuration.
  - name: Navigation and widgets
    x-parent: Store content
    description: Retrieve storefront banners, widgets and navigation data.
  - name: Localization
    x-parent: Store content
    description: Retrieve available languages, zones and localization options.
  - name: Contact and store information
    x-parent: Store content
    description: Retrieve store contact information and public store metadata.
  - name: Store pages
    x-parent: Store content
    description: Retrieve published storefront content pages.
paths:
  /api/orders/track-order-product:
    get:
      tags:
        - Order details and tracking
      summary: Retrieve shipment and delivery status for an order product.
      description: >-
        Retrieve shipment and delivery status for an order product.


        **Authentication:** Customer bearer token required; permission
        `view-order-history` applies.


        **Feature area:** Orders


        **Implementation source:**
        `src/api/store/controllers/CustomerOrderController.ts`


        **Request example provenance:** Source response fields and messages;
        sample values illustrative.


        **Response example provenance:** Source response fields and messages;
        sample values illustrative.


        > **Example status: Illustrative.** The example is included to
        demonstrate request/response shape in the reference UI; verify the
        owning controller and request DTO before using it as a contract.
      operationId: getApiOrdersTrackOrderProduct
      parameters:
        - name: orderProductId
          in: query
          required: false
          schema:
            type: integer
          example: '1001'
          description: Query parameter orderProductId.
      responses:
        '200':
          description: >-
            Successful response. Source response fields and messages; sample
            values illustrative. Example is illustrative and does not guarantee
            a stable response contract.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  status:
                    type: string
                  data:
                    type: object
                    properties:
                      orderProductId:
                        type: integer
                      orderId:
                        type: integer
                      productId:
                        type: integer
                      orderProductPrefixId:
                        type: string
                      trackingId:
                        type: string
                      trackingUrl:
                        type: string
                      productName:
                        type: string
                      productPrice:
                        type: string
                      total:
                        type: string
                      productQuantity:
                        type: integer
                      orderPrefixId:
                        type: string
                      deliveryStatus:
                        type: array
                        items:
                          type: object
                          properties:
                            orderStatusId:
                              type: integer
                            name:
                              type: string
                            createdDate:
                              type: string
                          additionalProperties: true
                    additionalProperties: true
                additionalProperties: true
              examples:
                success:
                  summary: Sample success response
                  value:
                    message: Successfully shown the Track Order.
                    status: '1'
                    data:
                      orderProductId: 1001
                      orderId: 101
                      productId: 1
                      orderProductPrefixId: ORDP-001
                      trackingId: TRK-001
                      trackingUrl: https://carrier.example/track/TRK-001
                      productName: Wireless Headphones
                      productPrice: '79.99'
                      total: '79.99'
                      productQuantity: 1
                      orderPrefixId: ORD-0001
                      deliveryStatus:
                        - orderStatusId: 2
                          name: Processing
                          createdDate: '2026-10-20T10:00:00.000Z'
        '400':
          description: >-
            Error response example. Source response fields and messages; sample
            values illustrative.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  message:
                    type: string
                additionalProperties: true
              examples:
                error:
                  summary: Sample error response
                  value:
                    status: 0
                    message: Invalid Order Product Id
      security:
        - BearerAuth: []
      externalDocs:
        description: Open implementation source in GitHub
        url: >-
          https://github.com/spurtcommerce/spurtcommerce/blob/master/src/api/store/controllers/CustomerOrderController.ts
      x-codeSamples:
        - lang: HTTP
          label: HTTP
          source: |
            GET /api/orders/track-order-product?orderProductId=1001 HTTP/1.1
            Host: <API_HOST>
            Accept: application/json
            Authorization: Bearer <ACCESS_TOKEN>
        - lang: bash
          label: cURL
          source: |-
            curl --request GET \
              'https://<API_HOST>/api/orders/track-order-product?orderProductId=1001' \
              --header 'Accept: application/json' \
              --header 'Authorization: Bearer <ACCESS_TOKEN>'
        - lang: JavaScript
          label: JavaScript (fetch)
          source: >-
            const API_BASE_URL = 'https://<API_HOST>';

            const url = new URL("/api/orders/track-order-product",
            API_BASE_URL);

            const query = {
              "orderProductId": "1001"
            };

            for (const [key, value] of Object.entries(query)) {
              url.searchParams.set(key, String(value));
            }

            const headers = {
              "Accept": "application/json",
              "Authorization": "Bearer <ACCESS_TOKEN>"
            };

            const response = await fetch(url, { method: "GET", headers });

            const result = await response.json();

            console.log(response.status, result);
        - lang: JavaScript
          label: Node.js (Axios)
          source: >-
            import axios from 'axios';

            const API_BASE_URL = 'https://<API_HOST>';

            const url = `${API_BASE_URL}/api/orders/track-order-product`;

            const API_BASE_URL = 'https://<API_HOST>';

            const url = `${API_BASE_URL}/api/orders/track-order-product`;

            const headers = {
              "Accept": "application/json",
              "Authorization": "Bearer <ACCESS_TOKEN>"
            };

            const params = {
              "orderProductId": "1001"
            };

            const response = await axios.request({ method: "GET", url, headers,
            params });

            console.log(response.status, response.data);
        - lang: Python
          label: Python (requests)
          source: >-
            import requests

            url = 'https://<API_HOST>/api/orders/track-order-product'

            headers = {'Accept': 'application/json', 'Authorization': 'Bearer
            <ACCESS_TOKEN>'}

            params = {'orderProductId': '1001'}

            response = requests.request('GET', url, headers=headers,
            params=params)

            print(response.status_code)

            print(response.json())
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Paste the JWT access token returned by the corresponding login endpoint.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.