# Retrieve orders by criteria

**POST /order/find/**

Finds orders based on specified criteria, such as channel, account token, and various filters like sale date, status, and buyer details.


## Servers
- production: https://m2e.cloud/api/v1/api (production)
- dev: https://sales-channels.m2ecloud.dev/api/v1/api (dev)
- local: https://10.0.30.15:56000/api/v1/api (local)


## Authentication methods
- Jwt


## Parameters


### Query parameters
- **channel** (string)
  The name of the sales channel (e.g., eBay, Amazon).
- **account_token** (string(uuid))
  A unique token identifying the account on the specified sales channel.

### Body: application/json (object)
Criteria for filtering and sorting orders.
- **sort** (object)
  Sorting options for the search results.
- **filters** (object)
  Filtering options.
- **search** (string | null)
  Search by Title, SKU, Identifier, GTIN
- **_result** (object)



## Responses
### 200
Orders retrieved successfully.
#### Headers
- **X-RateLimit-Limit** ()
  The number of allowed requests in the current period.
- **X-RateLimit-Remaining** ()
  The number of remaining requests in the current period.
- **X-RateLimit-Retry-After** ()
  The date of number of remaining requests will reset.

#### Body: application/json (object)
- **list** (array[object])
  A list of orders matching the query.
- **total** (integer)
  The total number of orders matching the query.

### 400
Bad request
#### Headers
- **X-RateLimit-Limit** ()
  The number of allowed requests in the current period.
- **X-RateLimit-Remaining** ()
  The number of remaining requests in the current period.
- **X-RateLimit-Retry-After** ()
  The date of number of remaining requests will reset.

#### Body: application/json (array[object])
- **code** (string)
  An error code that identifies the type of error that occurred.
- **message** (string)
  A message that describes the error condition in a human-readable form.
- **data** (object | array)
  Additional information that can help the caller understand or fix the issue.

### 404
Not found

#### Body: application/json (array[object])
- **code** (string)
  An error code that identifies the type of error that occurred.
- **message** (string)
  A message that describes the error condition in a human-readable form.
- **data** (object | array)
  Additional information that can help the caller understand or fix the issue.

### 401
Unauthorized

#### Body: application/json (array[object])
- **code** (string)
  An error code that identifies the type of error that occurred.
- **message** (string)
  A message that describes the error condition in a human-readable form.
- **data** (object | array)
  Additional information that can help the caller understand or fix the issue.

### 429
Too many requests
#### Headers
- **X-RateLimit-Limit** ()
  The number of allowed requests in the current period.
- **X-RateLimit-Remaining** ()
  The number of remaining requests in the current period.
- **X-RateLimit-Retry-After** ()
  The date of number of remaining requests will reset.

#### Body: application/json (array[object])
- **code** (string)
  An error code that identifies the type of error that occurred.
- **message** (string)
  A message that describes the error condition in a human-readable form.
- **data** (object | array)
  Additional information that can help the caller understand or fix the issue.

### 500
Internal server error

#### Body: application/json (array[object])
- **code** (string)
  An error code that identifies the type of error that occurred.
- **message** (string)
  A message that describes the error condition in a human-readable form.
- **data** (object | array)
  Additional information that can help the caller understand or fix the issue.


[Powered by Bump.sh](https://bump.sh)