---
title: "POST /api/v1/tracking/bulkPartnerShipmentIdSearch"
method: POST
path: "/api/v1/tracking/bulkPartnerShipmentIdSearch"
tags: ["track"]
---

# POST /api/v1/tracking/bulkPartnerShipmentIdSearch

`POST /api/v1/tracking/bulkPartnerShipmentIdSearch`

## Request body

- BulkPartnerShipmentIdsSearchRequest
  - `partnerShipmentIds` string[], required
  - `excludeEvents` boolean

## Response `200`

Result

- BulkSearchTrackingResponse
  - `trackings` TrackingDto[]
    - `shipiumTrackingId` string
    - `shipiumShipmentId` string
    - `partnerShipmentId` string
    - `shipiumTenantId` string
    - `partnerTenantId` string
    - `carrierId` string
    - `carrierTrackingId` string
    - `carrierServiceMethodId` string
    - `shipmentStatus` 'Registered' | 'Label Printed' | 'In Transit' | 'Out For Delivery' | 'Delivered' | 'Exception' | 'Return to Sender: In Transit' | 'Return to Sender: Out For Delivery' | 'Return to Sender: Delivered' | 'Return to Sender: Exception'
    - `shippedDateTime` string, date-time
    - `deliveredAtDateTime` string, date-time
    - `carrierEstimatedDeliveryDate` string, date-time
    - `originalCarrierEstimatedDeliveryDate` string, date-time
    - `partnerReferenceId` string
    - `partnerReferenceId2` string
    - `carrierTrackingLink` string
    - `trackingEvents` TrackingEventDto[]
      - `carrierDescription` string
      - `shipmentStatus` 'Registered' | 'Label Printed' | 'In Transit' | 'Out For Delivery' | 'Delivered' | 'Exception' | 'Return to Sender: In Transit' | 'Return to Sender: Out For Delivery' | 'Return to Sender: Delivered' | 'Return to Sender: Exception'
      - `eventDate` string, date-time
      - `postalCode` string
      - `country` string
      - `city` string
      - `region` string

## Other responses

- `400` — Invalid inputs were provided.
- `401` — Not authorized via OAuth
- `403` — Not authenticated via OAuth
- `404` — Trackings were not found

---

[API](https://skmtc.net/shipium/apis/shipium-api.md) · [All operations](https://skmtc.net/shipium/apis/shipium-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipium/shipium-api/revisions/7ef5dbd6a025/schema)