{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/greenlake/services/flex/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Flex Solutions API for HPE GreenLake","keywords":"HPE enterprise services cloud services, infrastructure cloud services, application services, enterprise-grade cloud solutions","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"__idx":0,"id":"flex-solutions-api-for-hpe-greenlake"},"children":["Flex Solutions API for HPE GreenLake"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page provides an introduction and quick start guide for the HPE Flex Solutions API:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"#overview"},"children":["Overview"]},"—See a high-level description of the API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"#developer-guide"},"children":["Developer guide"]},"—Review a quick start guide that helps you get started with the API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":1,"id":"overview"},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With the HPE Flex Solutions API you can view and manage Flex orders and devices in your workspace. The API allows you to programmatically access Flex order and device data that is available through the HPE GreenLake UI."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":2,"id":"features"},"children":["Features"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With the HPE Flex Solutions API you can:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["View and search for Flex orders with filtering, sorting, and pagination"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve distinct transformative data for orders (for example, group by SOW ID, customer, partner)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["View and search for Flex devices with filtering, sorting, and pagination"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve individual device details by resource ID"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":3,"id":"use-cases"},"children":["Use cases"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Automated billing reconciliation:"]}," Retrieve Flex orders and devices programmatically to reconcile billing account data with internal systems, eliminating manual data entry."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fleet visibility and reporting:"]}," Query devices across your workspace to build custom dashboards and reports that track device types, models, and billing tiers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Partner order management:"]}," Use the orders transform endpoint to aggregate order data by partner, customer, or SOW ID for partner-level reporting and analysis."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":4,"id":"whats-new"},"children":["What's new"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Date: May 2026"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Initial release of the HPE Flex Solutions API (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v1beta1"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/greenlake/services/flex/public/openapi/changelog"},"children":["View the changelog for more information"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":5,"id":"related-documentation"},"children":["Related documentation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://support.hpe.com/hpesc/public/docDisplay?docId=a00120892en_us&page=GUID-B0DEB89D-DE1E-4DD0-AD6F-215DF213E986.html"},"children":["HPE GreenLake Cloud User Guide"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"__idx":6,"id":"developer-guide"},"children":["Developer guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The examples in this guide help you start using the Flex APIs to view and manage Flex orders and devices."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":7,"id":"prerequisites"},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":8,"id":"hostname"},"children":["Hostname"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://us-west.api.greenlake.hpe.com"},"children":["https://us-west.api.greenlake.hpe.com"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":9,"id":"uris"},"children":["URIs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unique Resource Identifiers (URIs) identify a server or resource used in the Flex API. A URI is a full API path ending with a specific endpoint. For example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/flex/v1beta1/orders"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/flex/v1beta1/orders/transform"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/flex/v1beta1/devices"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/flex/v1beta1/devices/{id}"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":10,"id":"access-and-permissions"},"children":["Access and permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You need the correct permissions to use the HPE Flex Solutions APIs."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Permission"},"children":["Permission"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Resource"},"children":["Resource"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /flex/v1beta1/orders"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["View"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Orders"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /flex/v1beta1/orders/transform"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["View"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Orders"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /flex/v1beta1/devices"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["View"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Devices"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /flex/v1beta1/devices/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["View"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Devices"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[":::info"," ","Learn more about configuring roles and permissions in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://support.hpe.com/hpesc/public/docDisplay?docId=a00120892en_us&page=GUID-FF77BFEC-79AB-4FBC-8684-FADB9FAE138A.html"},"children":["HPE GreenLake Cloud User Guide"]},"."," ",":::"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":11,"id":"rate-limits"},"children":["Rate limits"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"HTTP method and path"},"children":["HTTP method and path"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Limit"},"children":["Limit"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Get and search for orders"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /flex/v1beta1/orders"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["100 requests per minute"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Get distinct transformative data for orders"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /flex/v1beta1/orders/transform"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["100 requests per minute"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Get and search for devices"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /flex/v1beta1/devices"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["100 requests per minute"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Get a single device by resource ID"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /flex/v1beta1/devices/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["100 requests per minute"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":12,"id":"getting-an-access-token"},"children":["Getting an access token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must create a personal API client and generate an access token to make API calls. HPE GreenLake APIs use OAuth-based access tokens used as an authorization bearer token. To do this:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.greenlake.hpe.com/docs/greenlake/guides/public/authentication/authentication/#creating-a-personal-api-client"},"children":["Create a personal API client."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HPE GreenLake Cloud Platform"]}," service."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.greenlake.hpe.com/docs/greenlake/guides/public/authentication/authentication/#generating-an-access-token"},"children":["Generate an access token."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.greenlake.hpe.com/docs/greenlake/guides/public/authentication/authentication/#viewing-code-samples-for-generating-an-access-token"},"children":["View code samples for generating an access token."]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the access token as an authorization bearer token to make secure REST API calls."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":13,"id":"making-it-all-work"},"children":["Making it all work"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following examples demonstrate common usage patterns. The complete ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API reference"]}," includes additional query parameters, response schemas, error codes, and advanced filtering options."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":14,"id":"get-orders"},"children":["Get orders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," API request to retrieve and search for Flex orders. You can filter, sort, and paginate the results."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example API call:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sh","header":{"controls":{"copy":{}}},"source":"GET 'https://us-west.api.greenlake.hpe.com/flex/v1beta1/orders?limit=2'\n","lang":"sh"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sample API response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"items\": [\n    {\n      \"id\": \"3b741a59-a22b-432f-b2cf-b72cc1a04c2d\",\n      \"createdAt\": \"2023-01-01T00:00:00Z\",\n      \"updatedAt\": \"2023-01-01T00:00:00Z\",\n      \"type\": \"flex/orders\",\n      \"generation\": 1,\n      \"billingAccountId\": \"HP-123456789\",\n      \"sowId\": \"OPE-123456789\",\n      \"billingAccountName\": \"Hewlett Packard Enterprise Cloud Storage\",\n      \"orderStartDate\": \"2025-01-01T00:00:00Z\",\n      \"orderEndDate\": \"2035-01-01T00:00:00Z\",\n      \"customerName\": \"Some Company Inc.\",\n      \"resellerName\": \"1st Street Resellers\",\n      \"distributorName\": \"HPE Distributions\",\n      \"partnerName\": \"Friendly Reseller LLC\",\n      \"isFlexPartner\": true\n    }\n  ],\n  \"count\": 1,\n  \"offset\": 0,\n  \"total\": 1\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response contains a paginated list of Flex orders, including billing account details, SOW information, customer and partner names, and order start and end dates. Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}," parameters to paginate through large result sets."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":15,"id":"get-distinct-transformative-data-for-orders"},"children":["Get distinct transformative data for orders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," API request to retrieve distinct values for orders grouped by a specific field. This is useful for building filter dropdowns or aggregating data by partner, customer, or billing account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example API call:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sh","header":{"controls":{"copy":{}}},"source":"GET 'https://us-west.api.greenlake.hpe.com/flex/v1beta1/orders/transform?group-by=partnerName'\n","lang":"sh"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sample API response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"items\": [\n    {\n      \"partnerName\": \"HPE Distributions\"\n    },\n    {\n      \"partnerName\": \"Friendly Reseller LLC\"\n    }\n  ],\n  \"count\": 2,\n  \"offset\": 0,\n  \"total\": 2\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supported ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["group-by"]}," fields: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sowId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerName"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingAccountName"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingAccountId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partnerName"]},". The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partnerName"]}," field is a unique combined set of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resellerName"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["distributorName"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":16,"id":"get-devices"},"children":["Get devices"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," API request to retrieve and search for Flex devices. You can filter, sort, and paginate the results."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example API call:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sh","header":{"controls":{"copy":{}}},"source":"GET \"https://us-west.api.greenlake.hpe.com/flex/v1beta1/devices?filter=make eq 'HPE'&limit=1\"\n","lang":"sh"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sample API response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"items\": [\n    {\n      \"id\": \"3b741a59-a22b-432f-b2cf-b72cc1a04c2d\",\n      \"createdAt\": \"2023-01-01T00:00:00Z\",\n      \"updatedAt\": \"2023-01-01T00:00:00Z\",\n      \"type\": \"flex/devices\",\n      \"generation\": 1,\n      \"macAddress\": \"CA:35:DC:4F:5D:FE\",\n      \"serialNumber\": \"CN134FD36\",\n      \"resourceId\": \"3b741a59-a22b-432f-b2cf-b72cc1a04c2d\",\n      \"partNumber\": \"JK130GT\",\n      \"name\": \"custom-device-name\",\n      \"deviceType\": \"DHCI_STORAGE\",\n      \"model\": \"HPE Compute 6030X\",\n      \"make\": \"HPE\",\n      \"billingAccountName\": \"Hewlett Packard Enterprises\",\n      \"billingTier\": \"HPE Distributions\",\n      \"tags\": [\n        {\n          \"name\": \"category1\",\n          \"value\": \"value1\"\n        }\n      ]\n    }\n  ],\n  \"count\": 1,\n  \"offset\": 0,\n  \"total\": 1\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response contains device details including MAC address, serial number, part number, device type, and associated billing information. Devices can be tagged with key-value metadata for categorization."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":17,"id":"get-a-specific-device"},"children":["Get a specific device"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get details of a specific device by its resource ID."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example API call:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sh","header":{"controls":{"copy":{}}},"source":"GET 'https://us-west.api.greenlake.hpe.com/flex/v1beta1/devices/3b741a59-a22b-432f-b2cf-b72cc1a04c2d'\n","lang":"sh"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sample API response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"3b741a59-a22b-432f-b2cf-b72cc1a04c2d\",\n  \"createdAt\": \"2023-01-01T00:00:00Z\",\n  \"updatedAt\": \"2023-01-01T00:00:00Z\",\n  \"type\": \"flex/devices\",\n  \"generation\": 1,\n  \"macAddress\": \"CA:35:DC:4F:5D:FE\",\n  \"serialNumber\": \"CN134FD36\",\n  \"resourceId\": \"3b741a59-a22b-432f-b2cf-b72cc1a04c2d\",\n  \"partNumber\": \"JK130GT\",\n  \"name\": \"custom-device-name\",\n  \"deviceType\": \"DHCI_STORAGE\",\n  \"model\": \"HPE Compute 6030X\",\n  \"make\": \"HPE\",\n  \"billingAccountName\": \"Hewlett Packard Enterprises\",\n  \"billingTier\": \"HPE Distributions\",\n  \"tags\": [\n    {\n      \"name\": \"category1\",\n      \"value\": \"value1\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response contains the full device record for the requested resource ID, including all properties from the Device schema."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"__idx":18,"id":"filtering"},"children":["Filtering"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Filters provide the ability to limit the resources returned by a REST call. When a REST call includes a filter, the GET action is restricted to a response that meets the filter requirements. Specify filters using the query parameter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filter"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":19,"id":"filtering-example"},"children":["Filtering example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example of filtering, the query's resources are limited to results where the customer name is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Some Company Inc."]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sh","header":{"controls":{"copy":{}}},"source":"GET https://us-west.api.greenlake.hpe.com/flex/v1beta1/orders?filter=customerName%20eq%20%27Some%20Company%20Inc.%27\n","lang":"sh"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":20,"id":"filtering-on-a-single-property"},"children":["Filtering on a single property"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sh","header":{"controls":{"copy":{}}},"source":"filter = <propertyName> <comparison operation> <literal>\n","lang":"sh"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Property"]}," is the name of an attribute in the requested resource type. The property name is always to the left of the operation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For orders, the following properties support filtering:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Filter"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["id"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id eq '3b741a59-a22b-432f-b2cf-b72cc1a04c2d'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters orders by their unique ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["billingAccountId"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingAccountId eq '3b741a59-a22b-432f-b2cf-b72cc1a04c2d'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters orders by billing account ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["sowId"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sowId eq 'OPE-0011261086'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters orders by Statement of Work ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["billingAccountName"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingAccountName eq 'Hewlett Packard Enterprise Cloud Storage'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters orders by billing account name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["customerName"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerName eq 'Some Company Inc.'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters orders by customer name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["resellerName"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resellerName eq '1st Street Resellers'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters orders by reseller name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["partnerName"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partnerName eq 'Friendly Reseller LLC'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters orders by partner name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["distributorName"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["distributorName eq 'HPE Distributions'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters orders by distributor name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["isFlexPartner"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isFlexPartner eq true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters orders by Flex Partner status."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For devices, the following properties support filtering:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Filter"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["id"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id eq '3b741a59-a22b-432f-b2cf-b72cc1a04c2d'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters devices by their unique ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["macAddress"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["macAddress eq 'CA:35:DC:4F:5D:FE'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters devices by MAC address."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["serialNumber"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["serialNumber eq 'CN134FD36'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters devices by serial number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["resourceId"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resourceId eq '3b741a59-a22b-432f-b2cf-b72cc1a04c2d'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters devices by resource ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["partNumber"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partNumber eq 'JK130GT'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters devices by part number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["name"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name eq 'custom-device-name'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters devices by name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["type"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type eq 'flex/devices'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters devices by resource type."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["model"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["model eq 'HPE Compute 6030X'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters devices by model."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["make"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["make eq 'HPE'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters devices by maker."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["billingAccountName"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingAccountName eq 'Hewlett Packard Enterprises'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters devices by billing account name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["billingTier"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingTier eq 'HPE Distributions'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Filters devices by billing tier."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Operation"]}," evaluated. Operations compare properties against literals, for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eq"]},". All parameters except ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in"]}," require the property on the left and the literal on the right. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in"]}," parameter allows the property on either side."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Examples of operations:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Example"},"children":["Example"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["eq"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerName eq 'Some Company Inc.'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The property exactly matches the literal."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["ne"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["make ne 'HPE'"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The property does not equal the literal."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["in"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingAccountId in ('HP-APJ-999-JPN-00104', 'HP-APUS-787-EN-00100')"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The property matches one of the values in the list."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["literal"]},", for example, true, is what an operation compares a property to. For a successful matching operation, the data types must match, and the syntax determines the data type of the literals. Due to URL encoding, reserved characters ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["!"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["#"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["&"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["("]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[")"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["+"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[","]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[":"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[";"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["="]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["["]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["]"]}," in string literals must be replaced with percent-encoded equivalents."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following are examples of literals."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["String"]},": Anything in 'single quotes'. Reserved characters in string literals must be URL encoded."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integer"]},": -100, -1, 0, 1, 100"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Boolean"]},": true, false"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":21,"id":"filtering-on-multiple-properties"},"children":["Filtering on multiple properties"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Logical operations facilitate filtering using multiple queries. Combine multiple operations using the operator ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["and"]},", for example:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Require both (and):"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sowId eq 'OPE-0011261086' and customerName eq 'HPE Tech Care'"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"__idx":22,"id":"odata-filtering-reference"},"children":["OData filtering reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This filtering is a subset of ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html#_Toc31358949"},"children":["OData 4.0 filtering"]},"."]}]},"headings":[{"value":"Flex Solutions API for HPE GreenLake","id":"flex-solutions-api-for-hpe-greenlake","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Features","id":"features","depth":3},{"value":"Use cases","id":"use-cases","depth":3},{"value":"What's new","id":"whats-new","depth":3},{"value":"Related documentation","id":"related-documentation","depth":3},{"value":"Developer guide","id":"developer-guide","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":3},{"value":"Hostname","id":"hostname","depth":4},{"value":"URIs","id":"uris","depth":4},{"value":"Access and permissions","id":"access-and-permissions","depth":4},{"value":"Rate limits","id":"rate-limits","depth":4},{"value":"Getting an access token","id":"getting-an-access-token","depth":4},{"value":"Making it all work","id":"making-it-all-work","depth":3},{"value":"Get orders","id":"get-orders","depth":4},{"value":"Get distinct transformative data for orders","id":"get-distinct-transformative-data-for-orders","depth":4},{"value":"Get devices","id":"get-devices","depth":4},{"value":"Get a specific device","id":"get-a-specific-device","depth":4},{"value":"Filtering","id":"filtering","depth":3},{"value":"Filtering example","id":"filtering-example","depth":4},{"value":"Filtering on a single property","id":"filtering-on-a-single-property","depth":4},{"value":"Filtering on multiple properties","id":"filtering-on-multiple-properties","depth":4},{"value":"OData filtering reference","id":"odata-filtering-reference","depth":4}],"frontmatter":{"markdown":{"toc":{"depth":5}},"seo":{"title":"Flex Solutions API for HPE GreenLake"}},"lastModified":"2026-05-07T21:44:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/greenlake/services/flex/public","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}