Responses
-
A single order is returned, based on the
verbosequery parameter.When
verbose=true, the response object OrderVerbose includes detailed information about each order, including line items, and other associations like Customer and Vendor details, Invoice Details if generated.When
verbose=false, the response object Order includes basic information about each order, like Order Number, Status, Sub Total, Total, Vendor Name, Buyer Company Name, and Invoice Status.
-
Unauthorized
-
Not Found
GET
/orders/{orderId}
curl \
--request GET 'https://app.getfoundation.com/api/external/v1/orders/{orderId}' \
--header "X-API-Key: $API_KEY"
Response examples (200)
Order
{
"id": "9aa62446-c3b0-42f5-8027-3648daed9d73",
"order_number": "string",
"status": "received",
"sub_total": 99.99,
"total": "string",
"vendor_id": "string",
"vendor_name": "string",
"vendor_minimum_order_value": 200,
"buyer_id": "string",
"buyer_user_id": "string",
"buyer_company_name": "string",
"invoice_status": "string",
"shipping_name": "string",
"shipping_email": "hello@example.com",
"shipping_company": "string",
"shipping_phone": "string",
"shipping_address1": "string",
"shipping_address2": "string",
"shipping_city": "string",
"shipping_state": "string",
"shipping_country": "string",
"shipping_zip": "string",
"billing_name": "string",
"billing_email": "hello@example.com",
"billing_company": "string",
"billing_phone": "string",
"billing_address1": "string",
"billing_address2": "string",
"billing_city": "string",
"billing_state": "string",
"billing_country": "string",
"billing_zip": "string",
"payment_status": "Paid",
"transaction_fee": 0.26,
"billing_payment_method_type": "instant:card",
"billing_payment_method_instruction_pay_to": "string",
"billing_payment_method_instruction_send_to_address": "string",
"billing_payment_method_instruction_memo": "string",
"billing_payment_method_instruction_other": "string",
"order_line_items": [
{
"item_id": "string",
"title": "string",
"variant": "string",
"sku": "string",
"quantity": 1,
"unit_price": 99.99,
"total_price": 99.99,
"discount_amount": "string",
"categoy_name": "string",
"vendor_name": "string"
}
],
"po_number": "string",
"order_line_items_discount_amount": "string",
"order_comments": [
{}
],
"created_at": "2025-05-04T09:42:00Z",
"updated_at": "2025-05-04T09:42:00Z"
}
{
"id": "9aa62446-c3b0-42f5-8027-3648daed9d73",
"order_number": "string",
"status": "received",
"sub_total": 99.99,
"total": "string",
"shipping_name": "string",
"shipping_email": "hello@example.com",
"shipping_company": "string",
"shipping_phone": "string",
"shipping_address1": "string",
"shipping_address2": "string",
"shipping_city": "string",
"shipping_state": "string",
"shipping_country": "string",
"shipping_zip": "string",
"billing_name": "string",
"billing_email": "hello@example.com",
"billing_company": "string",
"billing_phone": "string",
"billing_address1": "string",
"billing_address2": "string",
"billing_city": "string",
"billing_state": "string",
"billing_country": "string",
"billing_zip": "string",
"payment_status": "Paid",
"transaction_fee": 0.26,
"billing_payment_method_type": "instant:card",
"billing_payment_method_instruction_pay_to": "string",
"billing_payment_method_instruction_send_to_address": "string",
"billing_payment_method_instruction_memo": "string",
"billing_payment_method_instruction_other": "string",
"order_line_items": [
{
"item_id": "string",
"title": "string",
"variant": "string",
"sku": "string",
"quantity": 1,
"unit_price": 99.99,
"total_price": 99.99,
"discount_amount": "string",
"categoy_name": "string",
"vendor_name": "string"
}
],
"created_at": "2025-05-04T09:42:00Z",
"updated_at": "2025-05-04T09:42:00Z",
"po_number": "string",
"order_line_items_discount_amount": "string",
"order_comments": [
{}
]
}
Response examples (401)
{
"error": "string",
"details": "string"
}
Response examples (404)
{
"error": "string",
"details": "string"
}