---
title: "Shipments - Csv Export"
method: GET
path: "/s/job/shipments/csv_export"
tags: ["shipments"]
---

# Shipments - Csv Export

`GET /s/job/shipments/csv_export`

Export shipments data as a CSV file within a specified date range.

## Query parameters

- `store_ids` string[], required — Store IDs to export shipments from
- `start` string, required — Start date (ISO 8601)
- `end` string, required — End date (ISO 8601)
- `warehouse_ids` string[] — Filter by warehouse IDs
- `options` object — CSV export options
  - `order_level` boolean — Include order-level financial data (subtotal, shipping, discount, tax, total)
  - `shipment_items` boolean — Include a separate shipment items CSV with per-item detail
  - `shipments_no_items` boolean — Include itemless shipments when filtering by warehouse
  - `shipments_no_location` boolean — Include shipments with no location when filtering by warehouse

## Response `200`

Presigned S3 URLs for the generated CSV files

- object
  - `shipment` string — S3 URL for shipments CSV export
  - `shipment_items` string — S3 URL for shipment items CSV export

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden. Insufficient permissions.
- `429` — Too many requests. Rate limit exceeded.
- `500` — Internal server error.

## Changes

- **2026-03-02** `fa53dd949b8e` — 1 info
  - endpoint added
- **2025-10-07** `3b410dd1cc4b` — 1 breaking
  - api path removed without deprecation
- **2024-05-28** `5be88c3f42d3` — 1 info
  - endpoint added
- **2024-05-28** `b02ec7e89f32` — 1 breaking
  - api path removed without deprecation
- **2024-04-22** `08cd9cfa14dd` — 2 breaking, 3 info
  - for the `query` request parameter `end`, the type/format was changed from `string`/`` to `string`/`date`
  - for the `query` request parameter `start`, the type/format was changed from `string`/`` to `string`/`date`
  - for the `query` request parameter `store_ids`, the type/format was generalized from `string`/`` to `array`/``
  - added the non-success response with the status `400`
  - …1 more

[Full history](https://skmtc.dev/skulabs/apis/skulabs-api/changes/s/job/shipments/csv_export/get.md)

---

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