Preorders

List preorders

Changed on

Returns a cursor-paginated list of the caller-owned, paid preorders, newest first. Filter by status and reservation-fee date.

get/preorders

Request

  • Base URL: https://api.ekho.com
  • URL: https://api.ekho.com/preorders
  • Auth: HTTP bearer

Query parameters

limitinteger

Page size, 1 to 100.

Example:20
starting_afterstring

Return the page after this resource id (newest first).

status'pending_invitation' | 'awaiting_checkout' | 'idle' | 'converted' | 'canceled'

Filter to a single preorder status.

created[gte]integer

Only preorders paid at or after this epoch ms.

Example:1767225600000
created[lte]integer

Only preorders paid at or before this epoch ms.

Example:1767225600000
expand[]string[]

Repeatable. Expand buyer to include the buyer (with PII).

Response

A page of preorders.

has_moreboolean required

True when another page follows the returned one.

next_cursorstring nullable required

Pass as starting_after to fetch the next page; null when has_more is false.

Example response

{
  "data": [
    {
      "id": "m3Vt8sQjRk2dLw9pXb4C"
    }
  ]
}

Changes

  • 819b111dc3bcRevision changes
    • breaking

      the ///// response's property type changed from string to integer for status

  • 87f98453866fRevision changes
    • info

      added the required property /// to the response with the status