Developer Docs

Order files

Resolve production files by platform order ID or merchant-facing order number.

Use the order-ID routes when your system stores the platform UUID. Use the order-number routes when your workflow is keyed by the merchant-facing number. Both resolve within the store bound to the API key.

bash 
curl --request GET 'https://tringify-custom-products.developers-c8a.workers.dev/api/v1/orders/by-number/%23STICKER100006/production-files.zip' \
  --header 'Authorization: Bearer cpk_live_YOUR_KEY' \
  --output order-production-files.zip

List by order ID

GET production_files:read

List production files by order ID

Returns all final production files linked to one order. The order ID is resolved within the store bound to the API key.

Path parameters

Name Type Description
order_id required UUID

Platform order ID.

Example: 292c78e6-608b-4796-a28b-c1cc42205301

Errors

  • 400 INVALID_ORDER_ID

    The order ID is not a UUID.
  • 404 PRODUCTION_FILES_NOT_FOUND

    No production files were found for that order in the key's store.
  • 409 PRODUCTION_FILES_NOT_READY

    At least one file for the order is not ready.
  • 410 PRODUCTION_FILES_EXPIRED

    At least one file for the order is no longer available.
  • 503 PRODUCTION_FILES_UNAVAILABLE

    At least one final object could not be verified temporarily.

List by order number

GET production_files:read

List production files by order number

Returns the same response as the order-ID route using the merchant-facing order number. URL-encode reserved characters such as # before placing the number in the path.

Path parameters

Name Type Description
order_number required string

Merchant-facing order number, URL-encoded as a path segment.

Example: %23STICKER100006

Errors

  • 400 INVALID_ORDER_NUMBER

    The order number is empty, too long, or contains an invalid path segment.
  • 404 PRODUCTION_FILES_NOT_FOUND

    No production files were found for that order number in the key's store.
  • 409 PRODUCTION_FILES_AMBIGUOUS

    The order number does not identify exactly one order in the key's store.

ZIP by order ID

GET production_files:read

Download order production files as ZIP

Streams a ZIP containing every final production file for the order. The archive is returned only after every file passes readiness, availability, size, and checksum checks.

Path parameters

Name Type Description
order_id required UUID

Platform order ID.

Example: 292c78e6-608b-4796-a28b-c1cc42205301

Errors

  • 400 INVALID_ORDER_ID

    The order ID is not a UUID.
  • 404 PRODUCTION_FILES_NOT_FOUND

    No production files were found for that order.
  • 409 PRODUCTION_FILES_NOT_READY

    At least one file for the order is not ready.
  • 409 PRODUCTION_FILES_CHANGED

    The file set changed while the archive was being prepared.
  • 410 PRODUCTION_FILES_EXPIRED

    At least one file for the order is no longer available.
  • 503 PRODUCTION_FILES_UNAVAILABLE

    At least one final object could not be verified temporarily.

ZIP by order number

GET production_files:read

Download order production files ZIP by order number

Streams the same all-or-nothing ZIP as the order-ID route, resolved by the URL-encoded merchant-facing order number.

Path parameters

Name Type Description
order_number required string

Merchant-facing order number, URL-encoded as a path segment.

Example: %23STICKER100006

Errors

  • 400 INVALID_ORDER_NUMBER

    The order number is invalid.
  • 404 PRODUCTION_FILES_NOT_FOUND

    No production files were found for that order number.
  • 409 PRODUCTION_FILES_NOT_READY

    At least one file for the order is not ready.
  • 409 PRODUCTION_FILES_CHANGED

    The file set changed while the archive was being prepared.
  • 410 PRODUCTION_FILES_EXPIRED

    At least one file for the order is no longer available.
  • 503 PRODUCTION_FILES_UNAVAILABLE

    At least one final object could not be verified temporarily.

Last updated Aug 5, 2026