Skip to main content
GET
/
orders
/
bulk
List Bulk Uploads
curl --request GET \
  --url https://api.zinc.com/orders/bulk \
  --header 'Authorization: <api-key>'
{
  "total": 123,
  "batches": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "row_count": 123,
      "placed_count": 123,
      "failed_count": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "filename": "<string>",
      "rows": [
        {
          "index": 123,
          "status": "<string>",
          "order_id": "<string>",
          "order_status": "<string>",
          "error": "<string>",
          "recipient": "<string>",
          "product_urls": [
            "<string>"
          ],
          "passthrough": {}
        }
      ]
    }
  ]
}
List your bulk-upload batches, newest first.

Query Parameters

  • limit — Number of batches to return (1–200, default 50)
  • offset — Number of batches to skip (default 0)

Response

An object with a batches array and a total count. Each batch includes its status, row tallies, and timestamps — see Get Bulk Upload for the full shape including per-row results.

Authorizations

Authorization
string
header
required

Zinc API key (Bearer zn_...)

Headers

authorization
string | null

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 200
offset
integer
default:0
Required range: x >= 0

Response

Successful Response

A user's recent bulk-upload batches (newest first).

total
integer
required
batches
BulkBatchResponse · object[]