---
title: "Create tracker batch"
method: POST
path: "/v1/batches/trackers"
tags: ["Batches"]
---

# Create tracker batch

`POST /v1/batches/trackers`

Create tracker batch. `Beta`

## Request body

- BatchTrackerData
  - `trackers` TrackingData[], required — The list of tracking info to process.
    - `tracking_number` string, required — The package tracking number
    - `carrier_name` 'allied_express' | 'allied_express_local' | 'amazon_shipping' | 'aramex' | 'asendia_us' | 'australiapost' | 'boxknight' | 'bpost' | 'canadapost' | 'canpar' | 'chronopost' | 'colissimo' | 'dhl_express' | 'dhl_parcel_de' | 'dhl_poland' | 'dhl_universal' | 'dicom' | 'dpd' | 'dpdhl' | 'fedex' | 'fedex_ws' | 'generic' | 'geodis' | 'hay_post' | 'laposte' | 'locate2u' | 'nationex' | 'purolator' | 'roadie' | 'royalmail' | 'seko' | 'sendle' | 'tge' | 'tnt' | 'ups' | 'usps' | 'usps_international' | 'usps_wt' | 'usps_wt_international' | 'zoom2u', required — The tracking carrier
    - `account_number` string, nullable — The shipper account number
    - `reference` string, nullable — The shipment reference
    - `info` TrackingInfo
      - `carrier_tracking_link` string, nullable — The carrier tracking link
      - `customer_name` string, nullable — The customer name
      - `expected_delivery` string, nullable — The expected delivery date
      - `note` string, nullable — A tracking note
      - `order_date` string, nullable — The package order date
      - `order_id` string, nullable — The package order id or number
      - `package_weight` string, nullable — The package weight
      - `package_weight_unit` string, nullable — The package weight unit
      - `shipment_package_count` string, nullable — The package count
      - `shipment_pickup_date` string, nullable — The shipment pickup date
      - `shipment_delivery_date` string, nullable — The shipment delivery date
      - `shipment_service` string, nullable — The shipment service
      - `shipment_origin_country` string, nullable — The shipment origin country
      - `shipment_origin_postal_code` string, nullable — The shipment origin postal code
      - `shipment_destination_country` string, nullable — The shipment destination country
      - `shipment_destination_postal_code` string, nullable — The shipment destination postal code
      - `shipping_date` string, nullable — The shipping date
      - `signed_by` string, nullable — The person who signed for the package
      - `source` string, nullable — The tracker source
    - `metadata` object — The carrier user metadata.

## Response `200`

- BatchOperation
  - `id` string — A unique identifier
  - `status` 'queued' | 'running' | 'failed' | 'completed' | 'completed_with_errors', required
  - `resource_type` 'orders' | 'shipments' | 'trackers' | 'billing', required
  - `resources` BatchObject[], required
    - `id` string — A unique identifier
    - `status` 'queued' | 'running' | 'failed' | 'completed' | 'completed_with_errors', required — The batch operation resource status
    - `errors` object, nullable — Resource processing errors
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `test_mode` boolean, required

## Other responses

- `404`
- `500`

---

[API](https://skmtc.dev/karrio/apis/karrio-api.md) · [All operations](https://skmtc.dev/karrio/apis/karrio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/karrio/karrio-api/revisions/76ab3b7c3a61/schema)