# List order ids by status

`GET /client_api/v2/orders_by_status`

The ids of your company's orders that have a shipment in the given status. Read each one with Get an order.

## Parameters

- `status` (string): A shipment status, such as `in_transit`. List order statuses has every value.

## Returns

Returns a list of order ids.

- `order_ids` (array of integer, required): The ids of the matching orders, each once.

## Errors

- `401 Unauthorized`: The token is missing, expired or invalid. Sign in again.

## Example request (curl)

```bash
curl -X GET "https://sandbox-api.vatit-stream.com/client_api/v2/orders_by_status?status=in_transit" \
  -H "Authorization: Bearer $API_TOKEN"
```

## Example response (200)

```json
{
  "order_ids": [
    14
  ]
}
```