# Start a grid data export

POST /v3/reports/grid/{gridEntityType}/exports

Use this endpoint to start an export for a Grid request. After calling this endpoint, use the  endpoint to poll the status of
the export until it's finished. Then, you can download the results with the URL given by the  endpoint.

Learn how to use the Grid export API


Endpoint: POST /v3/reports/grid/{gridEntityType}/exports
Security: API_Key

## Path parameters:

  - `gridEntityType` (string, required)
    grid entity type
    Enum: "web-audit-runs", "web-journey-runs", "pages", "cookies", "tags", "tag-variables", "links", "accessibility-issues", "network-requests"

## Request fields (application/json):

  - `size` (integer)
    how many rows to include in the paginated response

  - `page` (integer)
    paginated response page number, starts with 0

  - `filters` (object)

  - `filters.conditions` (array)

  - `filters.conditions.negated` (boolean)
    If true, the filter will match entities where the value does not match

  - `filters.conditions.operator` (string, required)
    Enum: "string_contains", "string_contains_multi", "string_regex", "integer_in", "integer_list_contains", "number_between", "date_time_between", "date_time_relative", "is_present", "metric_alert_any"

  - `filters.conditions.filteredColumn` (any, required)

  - `filters.conditionMatchMode` (string)
    Specifies how to combine results of multiple conditions when determining if a row should be included in the result:
-  - all conditions must be met;
-  - at least one condition must be met.
Default is .
    Enum: "all", "any"

  - `columns` (array)

  - `sortBy` (array)
    Sorts the result by the specified columns, in the same order as in the columns array.

  - `sortBy.columnIndex` (integer, required)
    Index of the column in the columns array

  - `sortBy.sortDesc` (boolean)
    If true, the column will be sorted in descending order. Default is ascending

  - `itemName` (string)

  - `customExportFileName` (string)
    Override for export file name (without file extension)

  - `fileFormat` (string)
    Format of the exported file
    Enum: "csv", "tsv", "xlsx", "parquet"

## Response 200 fields (application/json):

  - `exportId` (integer, required)
    Unique ID of a grid export

## Response 400 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 401 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 403 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)