Skip to main content
GET
/
discovery
/
{discoveryId}
/
products
Get selected products
curl --request GET \
  --url https://api.interchange.io/api/v2/buyer/discovery/{discoveryId}/products \
  --header 'Authorization: Bearer <token>'
{
  "discoveryId": "<string>",
  "products": [
    {
      "productId": "<string>",
      "salesAgentId": "<string>",
      "selectedAt": "<string>",
      "groupId": "<string>",
      "groupName": "<string>",
      "bidPrice": 123,
      "budget": 123
    }
  ],
  "totalProducts": 0,
  "budgetContext": {
    "sessionBudget": 123,
    "allocatedBudget": 123,
    "remainingBudget": 123,
    "budgetWarning": "<string>"
  },
  "campaignBound": true,
  "campaignWarning": "<string>"
}

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

discoveryId
string
required

Discovery ID

Minimum string length: 1
Example:

"abc123-def456-ghi789"

Response

Get selected products

Response containing selected products

discoveryId
string
required

Discovery ID

products
object[]
required

Selected products in the discovery session

totalProducts
integer
required

Total number of selected products

Required range: -9007199254740991 <= x <= 9007199254740991
budgetContext
object

Budget allocation context

campaignBound
boolean

Whether this discovery session is attached to an active campaign. When false, the products are saved to the session but no active campaign reflects them yet.

campaignWarning
string

Guidance shown only when campaignBound is false: either the session is not attached to any campaign, or the campaign it was attached to has been archived. Pass campaignId for an active campaign (or restore the archived one) so the campaign reflects the products.