# List assets (tracks) across all manifests in the shipment

Returns a flattened list of track records spanning every non-cancelled manifest attached to the shipment. Each entry includes the track, its loading status, and the owning manifest reference.

Endpoint: GET /integration/rest/api/v1/shipment/{shipmentExternalId}/asset
Version: v0
Security: X-AUTH-KEY

## Path parameters:

  - `shipmentExternalId` (string, required)
    Shipment external identifier or uuid.
    Example: "SHIP-2024-001"

## Response 200 fields (*/*):

  - `trackIdentifier` (string)
    Track identifier (WMS id).

  - `track` (object)
    Track details.

  - `track.createDate` (string)

  - `track.updateDate` (string)

  - `track.deepLink` (string)
    Deep link URL to open this entity in Ops.App.

  - `track.trackCode` (string)
    Unique track code.

  - `track.wmsId` (string)
    External asset identifier provided by WMS.

  - `track.status` (string)
    Current status of the track.
    Enum: "SCHEDULED_FOR_RETIREMENT", "ACTIVE", "NOT_ACTIVE", "FLAGGED"

  - `track.zimarkCodes` (array)
    Associated Zimark codes for this track.

  - `track.zimarkCodes.zimarkMarkerValue` (string)
    Unique Zimark marker value encoded/printed on the label.

  - `track.zimarkCodes.markerType` (string)
    Marker type (layout/type) of this coupled marker.
    Enum: "MARKER_3X3", "MARKER_3X4", "PROPRIETARY", "ARUCO", "ZMARKER"

  - `track.zimarkCodes.coupledAt` (string)
    Timestamp when this marker was coupled to the track.

  - `track.manifests` (array)
    Manifests that include this track.

  - `track.manifests.externalIdentifier` (string)
    External unique identifier for this manifest.

  - `track.manifests.manifestStatus` (string)
    Current status of the manifest.
    Enum: "PLANNED", "TO_DO", "IN_PROGRESS", "COMPLETED", "CANCELLED"

  - `track.manifests.totalAssetsCount` (integer)
    Total assets attached to this manifest, excluding invalid loadings (WRONGLY_LOADED, UNKNOWN_LOADING).

  - `track.manifests.loadedAssetsCount` (integer)
    Successfully loaded assets in this manifest, excluding invalid loadings.

  - `track.manifests.deleted` (boolean)
    Indicates whether the manifest is soft-deleted.

  - `track.manifests.shipmentSummaryUrl` (string)
    Public URL to the Shipment Summary page for this manifest. Present only when manifest status is COMPLETED. Does not expire.

  - `track.customFields` (array)
    Custom fields attached to this track.

  - `track.customFields.fieldCaption` (string)
    Human-readable caption of the custom field.

  - `track.customFields.fieldName` (string)
    System key of the custom field.

  - `track.customFields.fieldValue` (string)
    Assigned value for this custom field.

  - `track.labels` (array)
    Labels assigned to this track.

  - `track.labels.name` (string)
    Human-readable label name.

  - `track.retirementDate` (string)
    Date when the track was retired.

  - `track.sku` (string)
    Assigned SKU value, or null when unassigned or the SKU feature is disabled.

  - `track.client` (object)
    Assigned Client, or null when unassigned or the Client feature is disabled.

  - `track.client.id` (string)
    Internal Client UUID.

  - `track.client.displayName` (string)
    Client display name.

  - `track.client.externalId` (string)
    Client external ID.

  - `track.wmsLocation` (string)
    Pallet location as reported by the client's WMS, or null when unset or the WMS Location feature is disabled.

  - `track.wmsLocationUpdatedAt` (string)
    Timestamp of the last WMS Location change, or null when no value is set or the WMS Location feature is disabled.

  - `loadingStatus` (string)
    Current loading status of the asset at the gate.
    Enum: "NOT_LOADED", "LOADED", "WRONGLY_LOADED", "UNKNOWN_LOADING", "UNLOADED", "OFFLOADED"

  - `manifest` (object)
    The manifest this track belongs to within the shipment.

  - `manifest.uuid` (string)
    Internal manifest identifier (uuid).

  - `manifest.externalIdentifier` (string)
    Caller-assigned manifest external identifier, if any.

  - `manifest.manifestStatus` (string)
    Current manifest status.
    Enum: "PLANNED", "TO_DO", "IN_PROGRESS", "COMPLETED", "CANCELLED"

## Response 403 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id

## Response 404 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id

## Response 500 fields (*/*):

  - `code` (string)
    Error code

  - `message` (string)
    Error message

  - `timeStamp` (integer)
    Timestamp

  - `correlationId` (string)
    Correlation id