---
updatedAt: 2025-07-23T10:24:56.000Z
agentTools:
projectIndex: https://developers.kayzen.io/llms.txt
---
# Report Results CSV
Submits a CSV URL request for a given Report
To poll status of the submitted request call [Show CSV request](https://developers.kayzen.io/reference/show-report-csv-request) endpoint.
To cancel a request call [Delete CSV request](https://developers.kayzen.io/reference/delete-report-csv-request) endpoint.
⚠️ Processing Request Limits: Maximum 3 concurrent **processing requests** are allowed per client.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "kayzen-oauth",
"version": "1.3.1"
},
"servers": [
{
"url": "https://api.kayzen.io"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "oauth2",
"flows": {}
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/v1/reports/{id}/report_results/download": {
"get": {
"description": "",
"operationId": "get_v1report_resultsdownload",
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"examples": {
"Success": {
"summary": "Success",
"value": {
"id": 189,
"status": "processing",
"url": null,
"created_at": "2025-06-26T13:17:59.282Z",
"updated_at": "2025-06-26T13:17:59.282Z",
"recommendation": null
}
}
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"examples": {
"Limit": {
"value": "{ \n error: 'max_processing_requests_exceeded', \n recommendation: \"Maximum 3 processing requests per client are allowed.\" \n} ",
"summary": "Limit"
}
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"examples": {
"Internal error": {
"value": "{ \n error: 'internal_server_error', \n recommendation: 'Try again later' \n}",
"summary": "Internal error"
}
}
}
}
}
},
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"description": "Report ID",
"schema": {
"type": "integer",
"default": ""
}
},
{
"name": "sort_field[column]",
"in": "query",
"required": false,
"description": "Sort by column. Required when sorting",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "sort_field[source]",
"in": "query",
"required": false,
"description": "Attribution source of the column to sort by when it's an attributed metric. Required when sorting",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "sort_field[type]",
"in": "query",
"required": false,
"description": "Attribution type of the column to sort by when it's an attributed metric. Required when sorting",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "sort_direction",
"in": "query",
"required": false,
"description": "Sort result in ascending (asc) or descending (desc) order. Required when sorting",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "date_macro",
"in": "query",
"required": false,
"description": "Select specific day or range of days.
Optional.
The report's date macro will be used if left blank
Possible values: today, yesterday, last_three_days, last_seven_days, this_month, last_three_days_with_today, last_seven_days_with_today, this_month_with_today, last_month, last_30_days",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "start_date",
"in": "query",
"required": false,
"description": "Start date of report, e.g.: `2025-06-21`.
Optional.
Will be ignored if you send date_macro",
"schema": {
"type": "string",
"format": "date",
"default": ""
}
},
{
"name": "end_date",
"in": "query",
"required": false,
"description": "End date of report, e.g.: `2025-06-25`.
Optional.
This is ignored in case of use of date_macro",
"schema": {
"type": "string",
"format": "date",
"default": ""
}
},
{
"name": "filters",
"in": "query",
"required": false,
"description": "JSON object with filters.
Optional.
The report's filters will be used if left blank.
Please refer to [Supported Parameters](/reference/supported-parameters/).
For example: `{\"campaign_id\": [108993,108994]}`
",
"schema": {
"type": "string",
"default": ""
}
},
{
"name": "metrics[]",
"in": "query",
"required": false,
"description": "Array of supported metrics.
**In-App Events** are considered metrics.
The report's metrics will be used if left blank.
Please refer to [Supported Parameters](/reference/supported-parameters/)",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "cohort_days[]",
"in": "query",
"required": false,
"description": "Cohort day dimensions.
Optional.
The report's cohort days will be used if left blank.
Required if cohort metrics are selected.
Possible values for **cohort_days** are: 0, 1, 3, 7, 14, 30",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "integer",
"format": "int32"
}
}
},
{
"name": "cohort_user_segments[]",
"in": "query",
"required": false,
"description": "Cohort user segment.
Optional.
The report's cohort user segments will be used if left blank.
Required if cohort metrics are selected
Possible values:
- \"ua\"
- \"rt\"",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "attribution_sources[]",
"in": "query",
"required": false,
"description": "Sources for attributed metrics.
Optional.
The report's attribution sources will be used if left blank.
Possible values: `mmp`, `self`, `assisted`, `skan`",
"schema": {
"type": "array",
"default": "",
"items": {
"type": "string"
}
}
},
{
"name": "attribution_types[]",
"in": "query",
"required": false,
"description": "Types for attributed metrics.
Optional.
The report's attribution types will be used if left blank.
Possible values: `click`, `view`, `total`",
"schema": {
"type": "string",
"default": ""
}
}
]
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```