---
title: "Update tracking status for shipped packages (Cron Job Endpoint)"
method: POST
path: "/api/tracking-update"
tags: ["Tracking - Automation"]
---

# Update tracking status for shipped packages (Cron Job Endpoint)

`POST /api/tracking-update`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/tracking-update`
- Auth: `ApiKeyAuth` (a scheme the document does not define)

Automatically updates tracking status for all shipped packages that haven't been
checked in the last 48 hours. This endpoint is designed to be called by a cron job
to keep tracking information up-to-date without manual intervention.

## Request body

- object
  - `force_update` boolean: Force update all shipped packages regardless of last update time
  - `limit` integer: Maximum number of packages to update in one batch
  - `dry_run` boolean: Show what would be updated without making changes

## Response `200`

Tracking update completed successfully

- object
  - `success` boolean
  - `data` object
    - `total_found` integer: Total packages needing update
    - `processed` integer: Packages successfully processed
    - `updated` integer: Packages with status changes
    - `delivered` integer: Packages newly marked as delivered
    - `failed` integer: Packages with tracking failures
    - `execution_time_ms` integer: Total execution time in milliseconds
    - `results` object[]: Detailed results for each package
      - `partnership_id` string, uuid
      - `tracking_number` string
      - `old_status` string
      - `new_status` string
      - `carrier_name` string
      - `updated` boolean
      - `error` string, nullable

## Other responses

- `500`: Server error during tracking update

---

[API](https://skmtc.dev/kolect/apis/kolect-api.md) · [All operations](https://skmtc.dev/kolect/apis/kolect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolect/apis/kolect-api/revisions/fe54528e8f54?raw)