# Investment List Flexible, list-based investment data retrieval for grids, watchlists, and comparison tables. {.sub-title___devsite} ## Overview The **Investment List API** allows you to retrieve tabular, list-based investment data for multiple securities in a single synchronous request. It is designed to power grid and list-based views such as watchlists, comparison tables, and dashboards, by returning a flat, consistent dataset across funds, ETFs, and equities. ## Key Capabilities * Submit up to **100 investments per request** and receive all results in one response. * Request **up to 50 data points** to control exactly which columns are returned. * Receive a **flat, tabular response** optimized for grids, watchlists, and comparison views. * **Sort results** by one or more data point fields in ascending or descending order. ## How It Works **1. Define Your Investment List** Provide a list of investment identifiers—supporting performance IDs, ISINs, CUSIPs, trading symbols, and more—along with optional lookup parameters such as exchange country, domicile, and base currency. **2. Select Output Data Points** Specify the attributes you want returned for each investment to control payload size and tailor the response to your use case. **3. Submit the Request** POST your list and data point selection to the endpoint. The API returns a flat dataset for all matched investments in a single response. **4. Render and Refresh** Use the structured response to populate sortable, filterable investment grids. Unmatched identifiers are surfaced in the response metadata so your application can handle them gracefully. ## Related Content * [Getting Started](/direct-web-services/documentation/direct-web-services/investment-list/getting-started) * [API Requests](/direct-web-services/documentation/direct-web-services/investment-list/api-requests) * [OpenAPI Specification](/direct-web-services/documentation/direct-web-services/investment-list/openapi-specification)