List the caller's recent generative export reports |

Operation

GET /exports

Returns the caller's most recent generative export reports (chunked Excel/CSV jobs created via this API or the /reports UI), newest first. Scoped through Pundit; admins see all of their own scope, non-admins see their own reports.

Operation ID: listExportReports · Tags: Reports

Parameters

Name	In	Required	Type	Description
`limit`	query	No	integer	Maximum number of reports to return.

Request Body

No request body is defined for this operation.

Responses

Content Types

application/json

{
  "description": "Recent export reports",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "exports": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Generative export report (chunked Excel/CSV) summary.",
              "properties": {
                "id": {
                  "type": "integer"
                },
                "report_type": {
                  "type": "string",
                  "enum": [
                    "advertisers_csv",
                    "deals_excel",
                    "hot_advertisers_excel",
                    "clicks_details_excel"
                  ]
                },
                "display_name": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "pending",
                    "processing",
                    "completed",
                    "failed"
                  ]
                },
                "status_display": {
                  "type": "string"
                },
                "parameters": {
                  "type": "object",
                  "additionalProperties": true
                },
                "filename": {
                  "type": "string",
                  "nullable": true
                },
                "download_url": {
                  "type": "string",
                  "format": "uri",
                  "nullable": true,
                  "description": "Presigned S3 GET URL valid for download_expires_in_seconds."
                },
                "download_expires_in_seconds": {
                  "type": "integer",
                  "nullable": true
                },
                "error_message": {
                  "type": "string",
                  "nullable": true
                },
                "progress": {
                  "type": "object",
                  "nullable": true,
                  "description": "Set on chunked export parents; reports completed-vs-total chunk counts.",
                  "properties": {
                    "parts_ready": {
                      "type": "integer"
                    },
                    "total_parts": {
                      "type": "integer"
                    }
                  }
                },
                "parent_report_id": {
                  "type": "integer",
                  "nullable": true
                },
                "chunked_export": {
                  "type": "boolean"
                },
                "created_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "updated_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "started_at": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "completed_at": {
                  "type": "string",
                  "format": "date-time",
                  "nullable": true
                },
                "status_url": {
                  "type": "string",
                  "format": "uri",
                  "nullable": true
                }
              },
              "required": [
                "id",
                "report_type",
                "status"
              ]
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "count": {
                "type": "integer"
              },
              "limit": {
                "type": "integer"
              }
            }
          }
        },
        "required": [
          "exports",
          "meta"
        ]
      }
    }
  }
}

{
  "$ref": "#/components/responses/Unauthorized"
}

API Playground

Run this GET request with your API key, or open it in a new tab. Path uses sample IDs where the OpenAPI path has {parameters}. Sign in to enable live testing with your API key.

Action	Method	Endpoint	Description
List the caller's recent generative export reports	`GET`	`/api/v1/exports`	OpenAPI operationId: listExportReports.

GET /api/v1/exports OpenAPI

List the caller's recent generative export reports

Open