> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mediafuse.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Orders

> Retrieve a paginated list of your PR distribution orders.

Fetches all orders for all members of your organization. Supports pagination and optional status filtering. Orders are returned sorted by `created_at` descending.

### Authorization

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer cw_ext_your_api_key_here`
</ParamField>

### Query Parameters

<ParamField query="limit" type="integer" default="50">
  The maximum number of orders to return. Minimum: `1`, Maximum: `200`.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  The number of orders to skip before starting to collect the result set.
</ParamField>

<ParamField query="status" type="string" default="all">
  Filter orders by their current status.

  | Value        | Description                                               |
  | ------------ | --------------------------------------------------------- |
  | `all`        | All orders (default)                                      |
  | `finished`   | Fully distributed orders                                  |
  | `processing` | Orders currently publishing or in publishing\_ended state |
</ParamField>

### Response

<ResponseField name="total" type="integer">
  The total number of orders matching the query (before pagination).
</ResponseField>

<ResponseField name="limit" type="integer">
  The limit applied to this response.
</ResponseField>

<ResponseField name="offset" type="integer">
  The offset applied to this response.
</ResponseField>

<ResponseField name="data" type="array">
  <Expandable title="Order Object">
    <ResponseField name="id" type="integer">
      The order ID.
    </ResponseField>

    <ResponseField name="press_release_title" type="string">
      Title of the press release attached to this order.
    </ResponseField>

    <ResponseField name="order_status" type="string">
      Human-readable status: `finished` or `processing`.
    </ResponseField>

    <ResponseField name="distribution_date_utc" type="string">
      Scheduled distribution date in UTC. Falls back to `created_at` for unscheduled (immediate) orders.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Order creation timestamp.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash All orders theme={null}
  curl -H "Authorization: Bearer cw_ext_your_key" \
    "https://app.chainwire.org/api/external-api/v1/orders?limit=50&offset=0"
  ```

  ```bash Finished orders only theme={null}
  curl -H "Authorization: Bearer cw_ext_your_key" \
    "https://app.chainwire.org/api/external-api/v1/orders?status=finished&limit=50&offset=0"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": 123,
        "press_release_title": "Chainwire Launches New Feature",
        "order_status": "finished",
        "distribution_date_utc": "2026-01-15 10:00:00",
        "created_at": "2026-01-14 08:00:00"
      }
    ],
    "total": 42,
    "limit": 50,
    "offset": 0
  }
  ```

  ```json 422 – Invalid status theme={null}
  {
    "error": "Invalid status",
    "message": "Allowed values for 'status': all, finished, processing."
  }
  ```
</ResponseExample>