> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get products

> List the products selected in a discovery session

`GET /api/v2/buyer/discovery/{discoveryId}/products`

Returns the products currently selected in the session, with their per-product budget allocations and budget context. This is the selection you build with [Add products](/v2/buyer/discovery/tasks/add-products) and [Apply proposal](/v2/buyer/discovery/tasks/apply-proposal) — distinct from the browsable discovery results.

## Request

```bash theme={null}
curl -X GET "https://api.interchange.io/api/v2/buyer/discovery/disc_01HZX3YQ7K9R6V3M2P1E0F8B2T/products" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

| Field         | Type   | Required | Notes                        |
| ------------- | ------ | -------- | ---------------------------- |
| `discoveryId` | string | Yes      | Path param — session to read |

## Response

```json theme={null}
{
  "discoveryId": "disc_01HZX3YQ7K9R6V3M2P1E0F8B2T",
  "products": [
    {
      "productId": "prod_acme_ctv_sports",
      "salesAgentId": "agent_acme_media",
      "bidPrice": 32.5,
      "budget": 150000,
      "groupId": "ctx_disc_01HZX3-group-0",
      "groupName": "Acme Media Connected TV",
      "selectedAt": "2026-06-07T15:04:00Z"
    }
  ],
  "totalProducts": 1,
  "budgetContext": { "sessionBudget": 250000, "allocatedBudget": 150000, "remainingBudget": 100000 }
}
```

`budgetContext.remainingBudget` is the session budget minus the sum of selected `budget` allocations. An empty `products` array means nothing has been added yet.

## Errors

* `404 NOT_FOUND` — `discoveryId` does not exist or is not visible to the authenticated account.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Discovery overview" href="/v2/guides/discovery" icon="rocket">
    Sessions and selection model
  </Card>

  <Card title="Add products" href="/v2/buyer/discovery/tasks/add-products" icon="plus">
    Add products to the selection
  </Card>

  <Card title="Remove products" href="/v2/buyer/discovery/tasks/remove-products" icon="trash">
    Drop products from the selection
  </Card>

  <Card title="Apply proposal" href="/v2/buyer/discovery/tasks/apply-proposal" icon="wand-magic-sparkles">
    Accept a seller's full allocation
  </Card>
</CardGroup>