Responses
-
A list of orders 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 OrderSummary includes basic information about each order, like Order Number, Status, Sub Total, Total, Vendor Name, Buyer Company Name, and Invoice Status.
-
Unauthorized
GET
/orders
curl \
--request GET 'https://app.getfoundation.com/api/external/v1/orders' \
--header "X-API-Key: $API_KEY"
Response examples (200)
{
"pagination": {
"current": 42,
"previous": 42,
"next": 42,
"limit": 42,
"total_pages": 42,
"total_count": 42
},
"data": [
{
"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",
"created_at": "2025-05-04T09:42:00Z",
"updated_at": "2025-05-04T09:42:00Z"
}
]
}
Response examples (401)
{
"error": "string",
"details": "string"
}