---
title: "List provider orders"
method: GET
path: "/v1/provider/orders"
tags: ["Provider"]
---

# List provider orders

`GET /v1/provider/orders`

Lists executed orders for a provider within a time window. 
Orders are sorted by execution time (most recent first) and use cursor-based pagination. Use `starting_after` or `ending_before` with a cursor to paginate through results.

## Query parameters

- `provider_id` string
- `start_time` string, date-time
- `end_time` string, date-time
- `limit` integer
- `starting_after` string — Opaque cursor string with format 'poc_base62_encoded_data' used for paginating provider orders
- `ending_before` string — Opaque cursor string with format 'poc_base62_encoded_data' used for paginating provider orders

## Response `200`

Successfully retrieved provider orders

- MarketApiProviderOrdersResponse
  - `object` 'list', required
  - `data` MarketApiProviderOrderResource[], required
    - `object` 'provider_order', required
    - `cursor` string, required — Opaque cursor string with format 'poc_base62_encoded_data' used for paginating provider orders
    - `id` string, required
    - `start_time` string, date-time, required
    - `end_time` string, date-time, required
    - `created_at` string, date-time, required
    - `executed_at` string, date-time, nullable
    - `cancelled_at` string, date-time, nullable
    - `executed` boolean, required
    - `cancelled` boolean, required
    - `quantity` string, required
    - `duration_hours` string, required
    - `tcv` string, required
    - `executed_gpu_hour_price` string, nullable
    - `market` string, required
    - `accelerator_type` string, required
    - `sender` string, required
    - `was_repriced` boolean, nullable
  - `summary` MarketApiProviderOrdersSummary, required
    - `object` 'provider_orders_summary', required
    - `total_revenue_cents` integer, required
    - `total_revenue_usd` string, required
    - `order_count` integer, required
    - `average_gpu_hour_price_cents` number, double, nullable
    - `average_gpu_hour_price_usd` string, nullable
    - `period_start` string, date-time, required
    - `period_end` string, date-time, required
    - `generated_at` string, date-time, required
  - `has_more` boolean, required

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized
- `403` — Forbidden - not a vendor or admin
- `500` — Internal server error

---

[API](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation.md) · [All operations](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sfcompute/san-francisco-compute-documentation/revisions/93dd7661e9bb/schema)