<!-- canonical: https://docs.costplus.io/api-reference/search/searchOrders -->

> Search across orders using free-form criteria.
# Search orders

Search across orders using free-form criteria.

## Endpoint

```
POST /search/orders
```

## Authentication

HTTP Basic — use your API key as the username with an empty password.

```bash
curl -u YOUR_API_KEY: https://api.costplus.online/v1/search/orders/
```

## Request body

Content-Type: `application/json` (required)

## Responses

### 200 — Search results

### 401 — Invalid or missing API key

### 403 — No authorization for the requested resource

## cURL

```bash
curl -u YOUR_API_KEY: \
  -X POST https://api.costplus.online/v1/search/orders/ \
  -H 'Content-Type: application/json' \
  -d '{ "merchant_order_id": "ORDER-1" }'
```
