> For the complete documentation index, see [llms.txt](https://docs.ecwid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ecwid.com/api-reference/rest-api/batch-requests/search-batch-requests-by-status.md). # Search batch requests by status `GET` `https://app.ecwid.com/api/v3/{storeId}/batch?status=STATUS&limit=100`
Request and response example Request: ```http GET /api/v3/1003/batch?status=COMPLETED&limit=100 HTTP/1.1 Authorization: Bearer secret_token Host: app.ecwid.com ``` Response: ```json { "items": [ { "ticket": "11kl140a2-966f-1a9f-b4e6-fc451bc78570", "status": "COMPLETED" } ] } ```
### Required access scopes This request does not require any **access scopes.** ### Path params All path params are required. | Param | Type | Description | | ------- | ------ | --------------- | | storeId | number | Ecwid store ID. | ### Query params Some of the query params are **required**.
ParamTypeDescription
statusstring

Search term for the current batch status.


One of:
QUEUED – Find only batch requests that haven't been sarted yet.
IN_PROGRESS – Find only batch requests in progress.
COMPLETED – Find only completed batch requests.

Required

limitnumberMaximum number of returned items. Default and maximum allowed value: 100

Required
offsetnumber

Offset from the beginning of the returned items list. Used when the response contains more items than limit allows to receive in one request.

Usually used to receive all items in several requests with multiple of a hundred, for example:

?offset=0 for the first request,

?offset=100, for the second request,

?offset=200, for the third request, etc.

Optional

### Response JSON A JSON object with the following fields:
FieldTypeDescription
itemsarray of objects #items List of found batch requests.
#### items
FieldTypeDescription
ticketstringInternal "ticket ID" assigned to the batch request.
statusstringCurrent status of the batch request.

One of:
QUEUED – No requests inside the batch are yet completed. yet.
IN_PROGRESS – At least one request inside the batch was already completed.
COMPLETED – All requests inside the batch have been completed.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.ecwid.com/api-reference/rest-api/batch-requests/search-batch-requests-by-status.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.