Get Orders

GET /orders

Get a list of orders

Query parameters

  • verbose boolean

    Get Verbose Response

  • page integer(int32)

    Page Number

  • limit integer(int32)

    Number of items per page

Responses

  • 200 application/json

    A list of orders 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 OrderSummary includes basic information about each order, like Order Number, Status, Sub Total, Total, Vendor Name, Buyer Company Name, and Invoice Status.

    Hide response attributes Show response attributes object
    • pagination object
      Hide pagination attributes Show pagination attributes object
      • current integer(int32)
      • previous integer(int32)
      • next integer(int32)
      • limit integer(int32)
      • total_pages integer(int32)
      • total_count integer(int32)
    • data array[object]
      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

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"
}