---
title: "List orders"
method: GET
path: "/orders"
tags: ["Orders"]
---

# List orders

`GET /orders`

## Request

- Base URL: `https://barevalue.com/api/v1`
- URL: `https://barevalue.com/api/v1/orders`
- Auth: HTTP bearer

List orders for the authenticated account with optional status filtering and pagination.

## Query parameters

- `page` integer
- `per_page` integer
- `status` 'pending' | 'processing' | 'completed' | 'failed'

## Response `200`

Paginated list of orders

- OrderListResponse
  - `orders` object[]
    - `order_id` integer
    - `status` string
    - `podcast_name` string, nullable
    - `episode_name` string, nullable
    - `episode_number` string, nullable
    - `duration_minutes` number, nullable
    - `submitted_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
  - `pagination` object
    - `page` integer
    - `per_page` integer
    - `total` integer
    - `total_pages` integer

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/barevalue/apis/barevalue-api.md) · [All operations](https://skmtc.dev/barevalue/apis/barevalue-api/llms.txt) · [OpenAPI document](https://skmtc.dev/barevalue/apis/barevalue-api/revisions/c47bdd23fcf6?raw)