Orders

Read orders from the Peppered API. Useful for syncing to CRM/BI systems.

Method	Path	Purpose
GET	/peppered/order	List all orders (filter by changedSince)
GET	/peppered/order/{orderId}	Get a specific order

For bulk exports (including seat-level detail, deleted seats, customer info in-line) see Exports.

---

List orders

GET /v1/:client_name/peppered/order

Query parameters

Name	Type	Description
changedSince	date	Only return orders changed on or after this date/time. Useful for incremental sync.

Response

200 OK - paginated data array (100 orders per page, newest first) of Order. This route is served by the same method as POST /peppered/export/orders, so each order also carries the export-only fields (orderChannel, fee, seats, deletedSeats, user) and the response is wrapped in the same pagination envelope (current_page, last_page, next_page_url, total, …).

{
  "data": [
    {
      "orderId": 12345,
      "orderKey": "XgFca-QmBxG-9WhAj-Osszb",
      "customerId": 867,
      "orderStatus": "ord",
      "orderPaymentStatus": "paid",
      "orderDate": "2026-04-22T13:08:55+02:00",
      "timeOut": null,
      "amount": 49.00,
      "donation": 5.00,
      "lastChanged": "2026-04-22T13:10:12+02:00",
      "handlingTextPayment": "iDEAL",
      "discountName": null
    }
  ],
  "current_page": 1,
  "last_page": 1,
  "per_page": 100,
  "total": 1,
  "next_page_url": null
}

---

Get order

GET /v1/:client_name/peppered/order/{orderId}

Returns a single order.

Response

200 OK - Order for one order.

404 Not Found - order doesn't exist for this client.

---

Order fields

Field	Type	Description
orderId	integer	Internal order ID
orderKey	string	Unique key used in public ticket URLs
customerId	integer | null	Linked customer (null for anonymous orders)
orderStatus	string	Order state - see table below
orderPaymentStatus	string	Payment state - see table below
orderDate	ISO datetime	When the order was created
timeOut	ISO datetime | null	For reservations: when it expires
amount	decimal	Total amount
donation	decimal	Donation portion (the cart checkout response uses orderDonation for the same value)
lastChanged	ISO datetime	Last modification timestamp
handlingTextPayment	string	Payment method label
discountName	string | null	Order-level discount (if any)

Order statuses

orderStatus:

Value	Meaning
ord	Regular order
cancel	Cancelled
reemit	Re-issued (replacement order)
reissue	Re-issued (older valid-again)
res	Reservation (no payment yet)
pros	Prospectus (offer, not confirmed)
trash	Soft-deleted

orderPaymentStatus:

Value	Meaning
none	No payment yet
pending	Payment in progress
paid	Paid in full
partial	Partially paid
cancelled	Cancelled

Incremental sync pattern

To keep a CRM or data warehouse in sync without fetching everything every time:

1. Record the lastChanged timestamp from your last sync.
2. Call GET /peppered/order?changedSince=<last-sync> to fetch only what changed.
3. For each order, optionally fetch details or linked customer.
4. Update your local copy.
5. Save the new high-watermark timestamp.

For full seat-level data (not included in the list endpoint), use Exports → Orders.

---

See also: Customers · Exports · Cart