---
title: "Fetch multiple IOMs in one call"
method: POST
path: "/v1/products/batch"
tags: ["Products"]
---

# Fetch multiple IOMs in one call

`POST /v1/products/batch`

## Request

- Base URL: `https://api.alpinedataworks.com`
- URL: `https://api.alpinedataworks.com/v1/products/batch`
- Auth: HTTP bearer

## Request body

- object
  - `product_ids` string[], required: Max 20 for Free/Gold; max 100 for Platinum

## Response `200`

Array of IOM objects

- object
  - `results` IntelligenceObject[]
    - `product_id` string, required
    - `entity` string, required
    - `score` union, required: Headline metric
      - number
      - string
    - `trend` string: Direction vs prior period
    - `confidence` number, required
    - `top_drivers` Driver[], required: Ranked factors explaining the score (Gold+ only)
      - `factor` string, required: Named driver of the score
      - `contribution` union, required: Numeric weight or label contribution
        - number
        - string
    - `prediction_horizon` string
    - `recommended_use` string
    - `methodology_version` string, required
    - `freshness` string, date-time, required
    - `coverage` string
    - `source_lineage` string[]
    - `allowed_use` string

---

[API](https://skmtc.dev/alpinedataworks/apis/alpinedataworks-ai-intelligence-object-api.md) · [All operations](https://skmtc.dev/alpinedataworks/apis/alpinedataworks-ai-intelligence-object-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alpinedataworks/apis/alpinedataworks-ai-intelligence-object-api/revisions/2047a24a8648?raw)