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