# parcelTrackingSubscribe

This endpoint allows you to subscribe to tracking updates for a specific parcel. It provides detailed information about the parcel’s status, ensuring that it can be tracked throughout its journey.

Endpoint: POST /sm/api/v2/parcel-tracking-subscribe
Version: 2.0.0
Security: ClientCredentialsFlow

## Header parameters:

  - `tenant-id-on-behalf` (string)
    Enhance Authorization with Tenant Context

## Request fields (application/json):

  - `parcelNumber` (string, required)

  - `tenantId` (string, required)

## Response 200 fields (application/json):

  - `parcelNumber` (string, required)

  - `tenantId` (string, required)

  - `status` (object)

  - `status.position` (object, required)

  - `status.position.lat` (number, required)
    Geographic latitude coordinate
    Example: 50.9098881

  - `status.position.lng` (number, required)
    Geographic longitude coordinate
    Example: 9.5806327

  - `status.etaTimestampMin` (string, required)
    Earliest estimated time of arrival
    Example: "2022-01-15T14:15:00Z"

  - `status.etaTimestampMax` (string, required)
    Latest estimated time of arrival
    Example: "2022-01-15T14:45:00Z"

  - `status.remainingStops` (integer, required)
    Number of driver's remaining stops before delivery of the parcel

  - `status.type` (string, required)
    Enum: "OUT_FOR_DELIVERY", "DELIVERED", "NOT_DELIVERED", "COLLECTED", "NOT_COLLECTED", "PICKED_UP", "NOT_PICKED_UP"

  - `statusType` (string)
    Enum: "NO_ETA_INFORMATION", "OUTDATED_ETA_INFORMATION", "SUCCESS", "UNKNOWN"

## Response 400 fields (application/json):

  - `id` (string, required)
    Example: "PARCEL-1"

  - `reason` (string, required)
    Example: "The provided jobInternalId is invalid."

  - `details` (string,null)
    Optional field for additional technical details.

## Response 409 fields (application/json):

  - `id` (string, required)
    Example: "PARCEL-4"

  - `reason` (string, required)
    Example: "Adding another subscription for this day is not supported."

  - `details` (string,null)
    Optional field for additional technical details.


## Response 401 fields

## Response 500 fields