OpenCourt Developers
API ReferenceOrders

List orders

GET/v1/orders

Returns the club's orders, oldest first. Flat in v1 — totals only (amount is in minor units, e.g. cents). Incomplete/abandoned pending orders are never included. Cursor-paginate via starting_after. Narrow with status, created_after, and created_before. Scoped to the club tied to your API key.

Date basis. created_after / created_before filter on the order creation timestamp (UTC). A refunded order is reflected in its status and totals, not as a separate record. Re-fetching a past window can therefore return the same rows with a changed status and an unchanged amount. To see refunds as dated money movements, use GET /v1/transactions.

Authorization

bearerAuth
AuthorizationBearer <token>

Your club API key. Send it as Authorization: Bearer oc_live_….

In: header

Query Parameters

limit?integer

Number of results, 1–100 (default 25).

Range1 <= value <= 100
starting_after?string

Cursor: the id of the last order from the previous page.

status?string

Only orders with this status.

Value in"paid" | "failed" | "payment_failed" | "refunded" | "partial_refund" | "canceled"
created_after?string

ISO-8601 lower bound on the ORDER creation timestamp (inclusive). Not the refund date — a refund never moves an order out of the window that contains its sale.

created_before?string

ISO-8601 upper bound on the ORDER creation timestamp (inclusive). Not the refund date — a refund never moves an order out of the window that contains its sale.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.getopencourt.com/v1/orders"
{
  "object": "list",
  "data": [
    {
      "id": "d4e5f6a7-8b9c-4d0e-a1b2-c3d4e5f6a7b8",
      "object": "order",
      "customer_id": "3f29c4a1-7b6d-4e52-9c81-2a4b6d8e0f13",
      "status": "paid",
      "amount": 4500,
      "currency": "USD",
      "created_at": "2026-01-15T14:30:00.000Z"
    }
  ],
  "has_more": true,
  "url": "string"
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "request_id": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "request_id": "string"
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string",
    "param": "string",
    "request_id": "string"
  }
}