---
title: "Tracking registration endpoint to start tracking shipments shipium did not create"
method: POST
path: "/api/v1/tracking/bulkRegister"
tags: ["tracking-registration-controller"]
---

# Tracking registration endpoint to start tracking shipments shipium did not create

`POST /api/v1/tracking/bulkRegister`

## Headers

- `X-DELEGATED-PARTNER-ID` string

## Request body

- BulkTrackingRegistrationRequest
  - `registrationRequests` TrackingRegistrationRequest[], required
    - `carrierId` string, required
    - `carrierTrackingId` string, required
    - `carrierServiceMethodId` string
    - `shipDateTime` string, date-time
    - `tenantId` string
    - `partnerShipmentId` string
    - `fromCountryCode` string
    - `fromPostalCode` string
    - `toCountryCode` string
    - `toPostalCode` string

## Response `200`

Result

- BulkTrackingRegistrationResponse
  - `trackingRegistrations` TrackingRegistrationResponse[], required
    - `carrierId` string
    - `carrierTrackingId` string
    - `shipiumTrackingId` string, required — A Shipium id that keeps track of the lifecycle of the uploaded tracking
  - `failures` BulkTrackingRegistrationFailure[], required
    - `carrierId` string
    - `carrierTrackingId` string
    - `trackingRegistrationRequestsIndex` integer
    - `errors` BulkTrackingRegistrationFailureError[]
      - `field` string
      - `detail` string

## Other responses

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

---

[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)