Get Order
Gets order details using a reference ID (current system) or order number (previous system). Both identifiers are supported.
Endpoint Details
GET /orders/{identifier}
Path Parameters
Name
Type
Description
Required
identifier
string
Order ID, returned upon checkout complete
Headers
Header
Value
Content-Type
application/json
Authorization
Bearer <YOUR_ACCESS_TOKEN>
Response Details
Field
Type
Description
statusCode
number
HTTP status code of the response
message
string
A brief message describing the result of the API call
metadata
Contains metadata about the API call
data
Order object
Sample Request and Response
curl --location 'https://staging.api.liquidcommerce.cloud/orders/order_number'
--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'{
"statusCode": 200,
"message": "Order fetched successfully.",
"metadata": {
"languages": [
"en"
],
"timestamp": 1745257267418,
"timezone": "UTC",
"requestId": "1deb1965-279b-4458-9b39-1baf83ca4fe7",
"path": "/orders/1745257243084",
"version": "1.7.0"
},
"data": {
"referenceId": "RESV_90874794283742",
"legacyOrderNumber": "174423423423423",
"partnerId": "65ba4c2ea7f3d123456789ab",
"createdAt": "2025-04-21T17:40:43.000Z",
"updatedAt": "2025-04-21T17:40:49.000Z",
"isHybrid": true,
"customer": {
"id": 12643699,
"firstName": "Test",
"lastName": "Test",
"email": "test@reservebar.com",
"phone": "(432) 424-2424",
"birthdate": "2004-04-21"
},
"addresses": {
"shipping": {
"one": "100 Madison Avenue",
"two": null,
"city": "Morristown",
"state": "NJ",
"zip": "07960",
"country": "US",
"firstName": "Test",
"lastName": "Test",
"email": "test@reservebar.com",
"phone": "(432) 424-2424",
"company": null
},
"billing": {
"one": "100 Madison Avenue",
"two": null,
"city": "Morristown",
"state": "NJ",
"zip": "07960",
"country": "US",
"firstName": "Test",
"lastName": "Test",
"email": "test@reservebar.com",
"phone": "(432) 424-2424",
"company": null
}
},
"options": {
"isGift": false,
"giftMessage": null,
"giftRecipient": {
"name": null,
"email": null,
"phone": null
},
"hasVerifiedAge": false,
"allowsSubstitution": true,
"billingSameAsShipping": true,
"deliveryInstructions": null,
"marketingPreferences": {
"email": true,
"sms": true
}
},
"amounts": {
"subtotal": 8638,
"shipping": 1998,
"platform": 1198,
"tax": 704,
"engraving": 0,
"service": 0,
"delivery": 0,
"discounts": 0,
"giftCards": 0,
"tip": 0,
"total": 12538,
"taxDetails": {
"products": 572,
"shipping": 132,
"delivery": 0,
"bag": 0,
"bottleDeposits": 0,
"retailDelivery": 0
},
"discountDetails": {
"products": 0,
"shipping": 0,
"delivery": 0,
"engraving": 0,
"service": 0
}
},
"paymentMethods": [
{
"type": "CREDIT_CARD",
"card": "Visa",
"last4": "1111",
"holder": "Test Test",
"code": null
}
],
"retailers": [
{
"id": "65ba4d9f1234567890abcdef",
"legacyId": "1798987",
"name": "Test Liquor & Wine Cellar",
"system": "ReserveBar OMS",
"timezone": "America/Chicago",
"address": {
"one": "6506 Liquor Test",
"two": "Suite 800",
"city": "Sugar Land",
"state": "NY",
"zip": "10019",
"country": "US",
"coordinates": {
"latitude": 29.6079351,
"longitude": -95.6592685
}
},
"fulfillments": [
{
"id": "65ba4db8abcdef1234567890",
"type": "shipping",
"status": "processing",
"scheduledFor": null,
"updatedAt": "2025-04-21T17:40:49.000Z",
"itemIds": [
"f47ac10b-58cc-4372-a567-0e02b2c3d479"
],
"packages": [],
"timeline": [
{
"status": "processing",
"timestamp": "2025-04-21T17:40:49.91184"
},
{
"status": "created",
"timestamp": "2025-04-21T17:40:45.711992"
}
]
}
],
"amounts": {
"subtotal": 4139,
"shipping": 999,
"platform": 0,
"tax": 340,
"engraving": 0,
"service": 0,
"delivery": 0,
"discounts": 0,
"giftCards": 0,
"tip": 0,
"total": 5478,
"taxDetails": {
"products": 274,
"shipping": 66,
"delivery": 0,
"bag": 0,
"bottleDeposits": 0,
"retailDelivery": 0
},
"discountDetails": {
"products": 0,
"shipping": 0,
"delivery": 0,
"engraving": 0,
"service": 0
}
}
},
{
"id": "65ba4df09876543210fedcba",
"legacyId": "89928",
"name": "Liquid's Elixir & Spirits",
"system": "ReserveBar OMS",
"timezone": "America/New_York",
"address": {
"one": "2627 Main Ave NW",
"two": null,
"city": "Dalton",
"state": "NC",
"zip": "20008",
"country": "US",
"coordinates": {
"latitude": 38.924376,
"longitude": -77.0515667
}
},
"fulfillments": [
{
"id": "65ba4e0812345678abcdef90",
"type": "shipping",
"status": "created",
"scheduledFor": null,
"updatedAt": "2025-04-21T17:40:45.000Z",
"itemIds": [
"d0782bd8-86c8-4053-93b5-a48a28f5648b"
],
"packages": [],
"timeline": [
{
"status": "created",
"timestamp": "2025-04-21T17:40:45.749774"
}
]
}
],
"amounts": {
"subtotal": 4499,
"shipping": 999,
"platform": 0,
"tax": 364,
"engraving": 0,
"service": 0,
"delivery": 0,
"discounts": 0,
"giftCards": 0,
"tip": 0,
"total": 5862,
"taxDetails": {
"products": 298,
"shipping": 66,
"delivery": 0,
"bag": 0,
"bottleDeposits": 0,
"retailDelivery": 0
},
"discountDetails": {
"products": 0,
"shipping": 0,
"delivery": 0,
"engraving": 0,
"service": 0
}
}
}
],
"items": [
{
"id": "d0782bd8-86c8-4053-93b5-a48a28f5648b",
"fulfillmentId": "65ba4f2312345678abcdef90",
"retailerId": "65ba4f359876543210fedcba",
"variantId": "65ba4f5712345678fedcba09",
"liquidId": "65ba4f40abcdef1234567890",
"customerPlacement": "standard",
"isPresale": false,
"estimatedShipBy": null,
"product": {
"name": "Liquid Elixir",
"brand": "Liquid",
"upc": "001928391838291",
"sku": "958050",
"mskus": [
"LIQUID-ELIXIR"
],
"category": "SPIRITS > MEZCAL",
"size": "700 ML",
"volume": "700",
"uom": "ML",
"proof": null,
"attributes": {
"pack": false,
"packDescription": null,
"abv": "43",
"container": "BOTTLE",
"containerType": "Bottle"
}
},
"image": "https://assets.liquidcommerce.co/core/white_matte_bottle_nobg.png",
"pricing": {
"price": 4139,
"unitPrice": 4139,
"quantity": 1,
"tax": 274,
"bottleDeposits": 0
},
"attributes": {
"engraving": {
"hasEngraving": false,
"fee": 0,
"location": null,
"lines": []
},
"giftCard": {
"sender": null,
"message": null,
"recipients": [],
"sendDate": null
}
}
},
{
"id": "33b5e5a7-5dd7-4e33-b8a8-5cf7cec79f39",
"fulfillmentId": "65ba501eedcba0987654321f",
"retailerId": "65ba501eedcba0987654321f",
"variantId": "65ba501eedcba0987654321f",
"liquidId": "65ba501eedcba0987654321f",
"customerPlacement": "standard",
"isPresale": false,
"estimatedShipBy": null,
"product": {
"name": "Liquid Elixir Aged",
"brand": "Liquid",
"upc": "001928391838291",
"sku": "65ba4f9210fedcba98765432_65ba501eedcba0987654321f",
"mskus": [
"LIQUID-ELIXIR-AGED"
],
"category": "SPIRITS > WHISKEY > BOURBON",
"size": "750 ML",
"volume": "750",
"uom": "ML",
"proof": null,
"attributes": {
"pack": false,
"packDescription": null,
"abv": "40",
"container": "BOTTLE",
"containerType": "Bottle"
}
},
"image": "https://assets.liquidcommerce.co/core/white_matte_bottle_nobg.png",
"pricing": {
"price": 4499,
"unitPrice": 4499,
"quantity": 1,
"tax": 298,
"bottleDeposits": 0
},
"attributes": {
"engraving": {
"hasEngraving": false,
"fee": 5000,
"location": "Side of the Bottle",
"lines": []
},
"giftCard": {
"sender": null,
"message": null,
"recipients": [],
"sendDate": null
}
}
}
]
}
}Last updated