BrainerceGet checkout (Public API)
Returns the checkout with its totals, addresses, selected shipping method and gift card tenders.
AuthorizationBearer <token>
Admin API key (server-to-server). Issue via the dashboard at Settings → API keys. Plain-text key is shown once — store in a secret manager. Format: Authorization: Bearer brainerce_xxxxxxxxx.
In: header
Path Parameters
checkoutIdstring
Checkout ID
curl -X GET "https://api.brainerce.com/api/v1/checkout/string"{
"id": "clx1a2b3c4d5e6f7g8h9",
"status": "PENDING",
"email": "[email protected]",
"customerId": "clx1a2b3c4d5e6f7g8h9",
"deliveryType": "shipping",
"pickupLocation": {
"id": "clx1a2b3c4d5e6f7g8h9",
"name": "Main store",
"rateName": "Store pickup",
"address": {
"line1": "Herzl 12",
"line2": "Apt 4",
"city": "Tel Aviv",
"region": "Center District",
"postalCode": "6578301",
"country": "IL"
},
"phone": "+972501234567",
"hours": "Sun-Thu 09:00-18:00",
"instructions": "Bring your order number",
"price": "0.00",
"currency": "USD"
},
"shippingAddress": {
"firstName": "Dana",
"lastName": "Cohen",
"company": "Acme Ltd",
"line1": "Herzl 12",
"line2": "Apt 4",
"city": "Tel Aviv",
"region": "Center District",
"postalCode": "6578301",
"country": "IL",
"phone": "+972501234567"
},
"billingAddress": {
"firstName": "Dana",
"lastName": "Cohen",
"company": "Acme Ltd",
"line1": "Herzl 12",
"line2": "Apt 4",
"city": "Tel Aviv",
"region": "Center District",
"postalCode": "6578301",
"country": "IL",
"phone": "+972501234567"
},
"shippingRateId": "clx1a2b3c4d5e6f7g8h9",
"shippingMethod": {
"id": "clx1a2b3c4d5e6f7g8h9",
"name": "Standard shipping",
"description": "Delivery in 3 to 5 business days",
"price": "15.00",
"currency": "USD",
"estimatedDays": 4,
"source": "manual",
"carrier": "ups",
"service": "ground",
"speedTier": "cheapest",
"requiresPickupPoint": true
},
"currency": "USD",
"subtotal": "59.80",
"discountAmount": "5.00",
"ruleDiscountAmount": "5.00",
"appliedRules": [
{
"id": "clx1a2b3c4d5e6f7g8h9",
"name": "Summer sale",
"type": "ORDER_DISCOUNT",
"discountAmount": "10.00"
}
],
"shippingAmount": "15.00",
"taxAmount": "11.46",
"taxBreakdown": {
"subtotal": 50.9,
"shippingNet": 12.71,
"totalTax": 11.46,
"total": 75.1,
"breakdown": [
{
"name": "VAT",
"rate": 18,
"amount": 9.17
}
],
"currency": "USD"
},
"total": "81.26",
"surchargeAmount": "0.00",
"appliedSurcharges": [
{
"key": "handling",
"name": "Handling fee",
"value": "string",
"amount": "5.00"
}
],
"customFieldValues": {},
"couponCode": "WELCOME10",
"tenders": [
{
"tenderId": "clx1a2b3c4d5e6f7g8h9",
"amountApplied": "50.00"
}
],
"providerAmountDue": "81.26",
"notes": "Leave at the door",
"lineItems": [
{
"id": "clx1a2b3c4d5e6f7g8h9",
"productId": "clx1a2b3c4d5e6f7g8h9",
"variantId": "clx1a2b3c4d5e6f7g8h9",
"quantity": 2,
"unitPrice": "29.90",
"discountAmount": "0.00",
"product": {
"id": "clx1a2b3c4d5e6f7g8h9",
"name": "Classic T-Shirt",
"sku": "TSHIRT-BLK-M",
"images": [
{}
],
"isDownloadable": true
},
"variant": {
"id": "clx1a2b3c4d5e6f7g8h9",
"name": "Black / M",
"sku": "TSHIRT-BLK-M"
},
"notes": "Gift wrap please",
"metadata": {},
"customizations": {}
}
],
"itemCount": 2,
"availableShippingRates": [
{
"id": "clx1a2b3c4d5e6f7g8h9",
"name": "Standard shipping",
"description": "Delivery in 3 to 5 business days",
"price": "15.00",
"currency": "USD",
"estimatedDays": 4,
"source": "manual",
"carrier": "ups",
"service": "ground",
"speedTier": "cheapest",
"requiresPickupPoint": true
}
],
"expiresAt": "2019-08-24T14:15:22Z",
"recoveryEmailSentAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"reservation": {
"hasReservation": true,
"expiresAt": "2019-08-24T14:15:22Z",
"remainingSeconds": 540,
"strategy": "ON_PAYMENT",
"countdownMessage": "Your items are reserved for 9 minutes"
},
"presentment": {
"currency": "USD",
"subtotal": "59.80",
"discountAmount": "0.00",
"shippingAmount": "15.00",
"taxAmount": "11.46",
"surchargeAmount": "0.00",
"total": "86.26",
"fxChargingRate": "3.65",
"fxBufferPercent": "2.00"
},
"pickupPoint": {
"id": "pp_48213",
"name": "Kiosk Herzl",
"kind": "store",
"address": {
"street1": "Herzl 12",
"city": "Tel Aviv",
"zip": "6578301",
"country": "IL"
},
"latitude": 32.0668,
"longitude": 34.7647,
"hours": "Sun-Thu 08:00-20:00",
"note": "Next to the pharmacy",
"distanceKm": 0.8
},
"totalAmount": "81.26"
}{
"statusCode": 401,
"code": "UNAUTHORIZED",
"message": "Invalid or expired credential",
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/checkout/{checkoutId}"
}{
"statusCode": 403,
"code": "INSUFFICIENT_SCOPE",
"message": "API key does not have the required scope: products:write",
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/checkout/{checkoutId}"
}{
"statusCode": 404,
"code": "RESOURCE_NOT_FOUND",
"message": "Resource not found",
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/checkout/{checkoutId}"
}{
"statusCode": 429,
"code": "RATE_LIMITED",
"message": "Too many requests",
"details": {
"retryAfterSeconds": 12
},
"timestamp": "2026-08-23T10:15:00.000Z",
"path": "/api/v1/store"
}