For US Market: Warehouse ID in Get Package Detail API

TikTok Shop plans to add warehouse_id to the Get Package Detail API for the US market. The field identifies the warehouse associated with a package's actual fulfillment, including cases where TikTok Shop switches the fulfillment warehouse after the order is placed. This update is intended for apps that retrieve package details for inventory reconciliation, warehouse reporting, or fulfillment operations.

Today, Get Package Detail does not identify the warehouse that actually fulfills a package. If TikTok Shop switches warehouses, an app cannot reliably map the package to the fulfillment warehouse by using the API response alone.

Before

• The response does not include the actual fulfillment warehouse ID.
• Apps may continue using the original warehouse allocation or another indirect mapping.
• Warehouse-level inventory reconciliation may show discrepancies after a warehouse switch.

After

• The response includes data.warehouse_id.
• Apps can map each package to the warehouse associated with its actual fulfillment.
• Apps can reconcile package and inventory records using the returned warehouse ID.

Affected API

New response field

{
  "data": {
    "package_id": "5433567853345",
    "warehouse_id": "7317467398322308906"
  }
}

Update your response model

1. Add warehouse_id as a string under the response data object.
2. Keep your parser forward-compatible with additive response fields.
3. Treat the field as optional until the rollout and unset-value behavior are confirmed.

Does this change the Get Package Detail request?

No. Continue sending the existing GET /fulfillment/202309/packages/{package_id} request.

Should I store the warehouse ID as a number?

No. Store warehouse_id as a string to preserve the complete identifier.