General

Our Reporting endpoints allow for bulk operations. Specifically, through the 2 following endpoints

Bulk reports can be requested for several CampaignIds or LineItemIds, with a maximum of 50 IDs per call. To do so, please use the attribute ids with an array of CampaignIds or LineItemIds instead of id for a single ID report request.

When requesting one Id:

id : CampaignId1

OR

When requesting more than one Id:

ids : ["CampaignId1", "CampaignId2",..."CampaignIdn",...]

❗️

IMPORTANT

• Do not use id and ids in the same call, this will lead to an invalid request response.
• There is a 100,000-row limit for report output to keep in mind when making a bulk report request.

Error Codes

When sending more than 50 ids, you will get the following 400 Bad request HTTP Response

{
  "errors": [
    {
      "code": "exceeded-ids-cap",
      "title": "Requests are capped for 50 unique ids, 51 were provided",
      "type": "validation",
      "traceId": "aa47dd83-8ca9-4a79-a179-ad5be6932ff1",
      "instance": "/api/v1/reports/line-item",
      "detail": "ids Requests are capped for 50 unique ids, 51 were provided (Value: \"1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51\")",
      "source": {
        "ids": "data/attributes/ids"
      }
    }
  ]
}

This Contains:

A traceId