---
title: "List report requests"
method: GET
path: "/demand/accounts/{account_id}/reports"
tags: ["Reports"]
---

# List report requests

`GET /demand/accounts/{account_id}/reports`

## Request

- Base URL: `https://api.cint.com/v1`
- URL: `https://api.cint.com/v1/demand/accounts/{account_id}/reports`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cint/apis/demand-api/docs/demand/accounts/:account_id/reports/get.ts> (a function with typed inputs; its response is checked against the schema)

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`)

## Response `200`

Returns a paginated list of report requests.

- ReportRequestList: A paginated list of report requests.
  - `next_cursor` string, nullable: An identifier for pagination that indicates there are more items available. When present, use this value to retrieve the next page of results.
  - `reports_requests` ReportRequestListItem[], required: An array of report request objects.
    - `account_name` string, nullable: The name of the account.
    - `create_date` string, date-time: The timestamp the report was created.
    - `create_params` object: Create params of the request
      - `start_date` string: The start date for the report query. **Note:** The time is interpreted as 00:00 in the US/Central timezone.
      - `end_date` string: The end date for the report query. **Note:** The time is interpreted as 00:00 in the US/Central timezone.
      - `filter` 'account' | 'business_unit' | 'project' | 'target_group' | '': Filter to be used in report. An empty string (`""`) for an account-level report requested through the API, where `filter` was left out of the request.
      - `filter_ids` string[]: List of unique identifiers corresponding to the selected filter type.
      - `report_options` object, nullable
        - `include_respondent_answers` boolean, nullable: Include respondent answers in report.
        - `link_type` 'all' | 'api' | 'offer' | 'pass' | 'target' | 'yield', nullable: Link type
    - `requestor` object: Report Requestor Details
      - `id` string, uuid: ID of the requestor
      - `name` string: Name of the requestor
      - `email` string, email: Email of the requestor
    - `report_id` string: A unique identifier for the report in ULID format.
    - `report_type` string: Report Type
    - `report_url` string, nullable: Report URL
    - `status` 'processing' | 'completed' | 'failed' | 'null', nullable: Status of the report. `null` when the job is in a state the service doesn't recognize, such as a timed-out run.
    - `level` 'Account' | 'Project' | 'Target Group' | 'Business Unit': Filter level of the report

## Other responses

- `400`: A request is not valid and can't be processed.
- `401`: A request is unauthorized.
- `403`: A requested is forbidden.
- `404`: A requested resource isn't found.
- `500`: A request failed due to an internal error.

---

[API](https://skmtc.dev/cint/apis/demand-api.md) - [All operations](https://skmtc.dev/cint/apis/demand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cint/apis/demand-api/revisions/077a4bdda5cb?raw)