---
title: "Create a new bulk download job (asynchronous)"
method: POST
path: "/bulk/download"
tags: ["bulk"]
---

# Create a new bulk download job (asynchronous)

`POST /bulk/download`

## Headers

- `Authorization` string, required

## Request body

- BulkDownloadRequest
  - `apiLimit` integer
  - `continueFromJobId` integer
  - `docsHubDetails` BulkDownloadRequestDocsHubDetails
    - `instanceId` string
    - `path` string
  - `filterDateField` string
  - `filterNulls` boolean
  - `format` 'application/json' | 'txt/csv' | 'application/jsonl', required
  - `from` string, date-time
  - `limit` integer
  - `notificationUrl` string
  - `objectName` string, required
  - `pageSize` integer
  - `query` BulkDownloadRequestQuery
    - `anyKey` string
  - `selectFields` string
  - `to` string, date-time
  - `where` string

## Response `200`

OK - Everything worked as expected

## Other responses

- `400` — Bad Request - Often due to a missing request parameter
- `401` — Unauthorized - An invalid element token, user secret and/or org secret provided
- `403` — Forbidden - Access to the resource by the provider is forbidden
- `404` — Not found - The requested resource is not found
- `405` — Method not allowed - Incorrect HTTP verb used, e.g., GET used when POST expected
- `406` — Not acceptable - The response content type does not match the 'Accept' header value
- `409` — Conflict - If a resource being created already exists
- `415` — Unsupported media type - The server cannot handle the requested Content-Type
- `500` — Server error - Something went wrong on the Cloud Elements server
- `502` — Provider server error - Something went wrong on the Provider or Endpoint's server

---

[API](https://skmtc.net/cloud-elements/apis/ecwid.md) · [All operations](https://skmtc.net/cloud-elements/apis/ecwid/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloud-elements/ecwid/revisions/6c2a6ade2a5b/schema)