v1

latestOpenAPI 3.0.0Apache 2.02026-07-143281,4552.1 MB
V1Transactions

V1ListOrders

Provides summary information for a merchant's online store orders.

get/v1/{location_id}/orders

Path parameters

location_idstring required

The ID of the location to list online store orders for.

Query parameters

order'DESC' | 'ASC'

The order (e.g., chronological or alphabetical) in which results from a request are returned.

The order in which payments are listed in the response.

limitinteger

The maximum number of payments to return in a single response. This value cannot exceed 200.

batch_tokenstring

A pagination cursor to retrieve the next set of results for your original query to the endpoint.

Response

Success

idstring

The order's unique identifier.

buyer_emailstring nullable

The email address of the order's buyer.

recipient_namestring nullable

The name of the order's buyer.

recipient_phone_numberstring nullable

The phone number to use for the order's delivery.

state'PENDING' | 'OPEN' | 'COMPLETED' | 'CANCELED' | 'REFUNDED' | 'REJECTED'
created_atstring

The time when the order was created, in ISO 8601 format.

updated_atstring

The time when the order was last modified, in ISO 8601 format.

expires_atstring nullable

The time when the order expires if no action is taken, in ISO 8601 format.

payment_idstring nullable

The unique identifier of the payment associated with the order.

buyer_notestring nullable

A note provided by the buyer when the order was created, if any.

completed_notestring nullable

A note provided by the merchant when the order's state was set to COMPLETED, if any

refunded_notestring nullable

A note provided by the merchant when the order's state was set to REFUNDED, if any.

canceled_notestring nullable

A note provided by the merchant when the order's state was set to CANCELED, if any.

promo_codestring nullable

The promo code provided by the buyer, if any.

btc_receive_addressstring nullable

For Bitcoin transactions, the address that the buyer sent Bitcoin to.

btc_price_satoshinumber nullable

For Bitcoin transactions, the price of the buyer's order in satoshi (100 million satoshi equals 1 BTC).