CIcint
Reports

List report requests

Retrieves a paginated list of report requests. This endpoint is the starting point for managing report workflows.

:::note Data and Timeframe Limitations

  • A single report request can cover a maximum duration of six months.
  • Data is available for the last 12 months.
  • Reporting data is near-real-time but should not be used for live management of target groups, as latency cannot be guaranteed. :::

You will need one of the following roles to access this endpoint:

  • Buyer Admin (buy_admin)
  • Buyer Manager (buy_mgr)
  • Buy Analyst (buy_anlyst)
get/demand/accounts/{account_id}/reports

Request

Response

Returns a paginated list of report requests.

next_cursorstring nullable

An identifier for pagination that indicates there are more items available. When present, use this value to retrieve the next page of results.

Example response

{
  "next_cursor": "bff6a669-a469-409d-8c94-dcf92258043a",
  "reports_requests": [
    {
      "account_name": "Lucid Marketplace Services",
      "create_date": "2023-01-01T23:00:00.000Z",
      "create_params": {
        "start_date": "2023-08-01",
        "end_date": "2023-08-30",
        "filter": "business_unit",
        "filter_ids": [
          "id1",
          "id2",
          "id3"
        ]
      },
      "requestor": {
        "id": "96C65204-90C2-4DCB-9393-B8226DD50C76",
        "name": "John Doe",
        "email": "JohnDoe@cint.com"
      },
      "report_id": "01HY3NF37B6J2ABPA3H49C92YZ",
      "report_type": "sample-bought",
      "report_url": "https://example.com/completes-buyside-{accountname}.csv",
      "status": "completed",
      "level": "Account"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.