Skip to main content
GET
Get order by ID

Path Parameters

orderId
string
required

Order unique identifier

Example:

"123e4567-e89b-12d3-a456-426614174000"

Response

200 - application/json

The order details

id
string
required

Unique identifier of the order

paymentCurrencyCode
string
required

The currency used by the customer when placing the order.

Example:

"123e4567-e89b-12d3-a456-426614174000"

taxesIncluded
boolean
required

Whether the taxes are included in the order subtotal.

Example:

"123e4567-e89b-12d3-a456-426614174000"

externalId
string | null
required

External order ID from user's platform (if any)

Example:

"shop123_order_456"

externalName
string | null
required

External order name/reference from user's platform

Example:

"#1001"

name
string
required

Generated order name for the user (starts at 1001 and increments)

Example:

"1001"

customerId
string | null
required

ID of the customer who placed the order

Example:

"123e4567-e89b-12d3-a456-426614174000"

storeId
string | null
required

ID of the store that owns the order

Example:

"store-uuid"

cartId
string | null
required

ID of the cart from which the order was created

Example:

"123e4567-e89b-12d3-a456-426614174000"

createdAt
string<date-time>
required

Date and time when the order was created

Example:

"2023-06-01T10:30:00Z"

updatedAt
string<date-time> | null
required

Date and time when the order was last updated

Example:

"2023-06-02T14:15:00Z"

deletedAt
string<date-time> | null
required

Date and time when the order was soft-deleted

Example:

"2023-06-03T09:45:00Z"

subtotal
number
required

Subtotal amount of the order, excluding canceled appointments

Example:

249.99

total
number
required

Total amount of the order, including canceled appointments and taxes

Example:

249.99

totalTax
number
required

Total tax amount of the order, excluding canceled appointments

Example:

249.99

dueToPay
number
required

Total amount still due to be paid for the order. Derived from the current total (which excludes canceled appointments and reflects current add-ons and discounts) minus the net amount already held (paid minus refunded). Never negative — when the customer has overpaid the current total, the surplus surfaces via dueToRefund instead.

Example:

249.99

paidTotal
number
required

Total amount paid for the order

Example:

249.99

refundedTotal
number
required

Total amount refunded for the order

Example:

249.99

balance
number
required

Balance of the order; based on paid and refunded amounts

Example:

249.99

dueToRefund
number
required

Total amount owed back to the customer. Derived from the net amount held (paid minus refunded) minus the current total. Any change that lowers the current total below what the customer has already paid — a canceled appointment, a removed or reduced add-on, or a discount that is restored on reevaluation — surfaces the surplus here. Never negative.

Example:

249.99

isFullyPaid
boolean
required

Whether the order is fully paid

Example:

false

isFullyRefunded
boolean
required

Whether everything the customer paid has been refunded (paid something, nothing held).

Example:

false

paymentStatus
enum<string>
required

Payment status of the order

Available options:
unpaid,
paid,
partially-paid
Example:

"paid"

refundStatus
enum<string>
required

Refund status of the order

Available options:
refund-owed,
partially-refunded,
fully-refunded,
unrefunded
Example:

"partially-refunded"

fulfillmentStatus
enum<string>
required

Fulfillment status of the order

Available options:
partially-fulfilled,
fulfilled,
unfulfilled
Example:

"partially-fulfilled"

customer
object
required

Customer who placed the order

lineItems
object[]
required

Line items in the order

transactions
object[]
required

Transactions associated with this order

refunds
object[]
required

Refunds associated with this order

logs
object[]
required

Order activity logs

gclid
string | null

Google Ads click ID captured at the time of booking

Example:

"EAIaIQobChMI..."

Last modified on July 26, 2026