General

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

You will be able to send us several CampaignIds or LineItemIds, with a maximum of 50 ids per call. To do so, please use the following attributes and terminology in one or the other endpoint (example below for the POST |/report/campaigns endpoint, same applies to the line-item endpoint):

When requesting a single Id, then:

id : CampaignId1

OR

When requesting several Ids then:

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

❗️

IMPORTANT

Do not use id and ids in the same call, this will lead to an invalid request response.
For more details, refer to our Report Request Attributes.

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