Get Order By ID

GET /orders/{orderId}

Path parameters

  • orderId string(guid) Required

    ID of order to return

Query parameters

  • verbose boolean

    Get Verbose Response

Responses

  • 200 application/json

    A single order is returned, based on the verbose query 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.

    One of:
  • 401 application/json

    Unauthorized

    Hide response attributes Show response attributes object
    • error string

      401: Invalid Credentials

      404: Resource not found

      422: Unprocessable Entity

    • details string

      404: empty

      401: The credentials presented are not valid to access this resource

  • 404 application/json

    Not Found

    Hide response attributes Show response attributes object
    • error string

      401: Invalid Credentials

      404: Resource not found

      422: Unprocessable Entity

    • details string

      404: empty

      401: The credentials presented are not valid to access this resource

GET /orders/{orderId}
curl \
 --request GET 'https://app.getfoundation.com/api/external/v1/orders/{orderId}' \
 --header "X-API-Key: $API_KEY"
Response examples (200)
{
  "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"
}