# Legacy v1: 2025-02-01

This page applies only to the legacy 2025-02-01 API. Use /v1 paths and Parcel-Version: 2025-02-01. The current API is described in [Version migration](/guides/guides-versions/).

POST /v1/shipments sends mass_grams as a top-level integer; it does not use package.weight_g. GET /v1/shipments returns data and has_more. Pagination uses offset and limit, with a default limit of 25 and maximum of 75. Advance offset by the number of records received while has_more is true.

The v2 cursor, its 11-minute expiry and the v2 next_cursor field do not exist in v1. Authentication still needs the bearer token and workspace header. This documentation does not state a v1 sunset date or promise that v1 has the v2 retry contract. Avoid projecting current-version behavior onto undocumented legacy behavior.

## Related pages

- [Agent Benchmark Control 0922 Docs](../index.md)
- [Authentication and workspace scope](./guides-authentication.md)
- [Create shipment](./reference-create-shipment.md)
- [Idempotency](./guides-idempotency.md)
- [List shipments](./reference-list-shipments.md)
- [Pagination and recovery](./guides-pagination.md)
- [ParcelBench documentation](../guides.md)
- [Quickstart](./guides-quickstart.md)
- [Retention and undocumented policies](./guides-retention.md)
- [Retries and error handling](./guides-retries.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.