# List Saved Reports

GET /v3/reports/grid/saved

Endpoint: GET /v3/reports/grid/saved
Security: API_Key

## Query parameters:

  - `name` (string)
    Filter by report name, works as "saved report name contains substring" case-insensitive filter

  - `isFavorite` (boolean)
    Filter by favorite status

  - `isOwnedByCurrentUser` (boolean)
    Filter by ownership status

  - `page` (integer)
    Page number, starts with 0

  - `size` (integer)
    Number of items per page

  - `sortBy` (string)
    Sort by field
    Enum: "type", "name", "creator", "lastViewed", "sequenceNumber"

  - `sortDesc` (boolean)
    Controls sorting order

  - `isManagedByOP` (boolean)
    Filter by managed by ObservePoint

## Response 200 fields (application/json):

  - `metadata` (object, required)
    Common metadata for iterable

  - `metadata.pagination` (object, required)

  - `metadata.pagination.totalCount` (integer, required)
    Total number of items available from all result pages combined

  - `metadata.pagination.totalPageCount` (integer, required)
    Total number of pages available

  - `metadata.pagination.pageSize` (integer, required)
    Page size - number of items per result page configured by  query parameter or default page size

  - `metadata.pagination.currentPageSize` (integer, required)
    Number of items in current result page

  - `metadata.pagination.currentPageNumber` (integer, required)
    Current page number/ordinal

  - `reports` (array, required)

  - `reports.id` (integer, required)
    ID of the saved report

  - `reports.name` (string, required)

  - `reports.visibility` (string, required)
    Enum: "private", "public"

  - `reports.gridEntityType` (string, required)
    Enum: "web_audit_runs", "web_journey_runs", "pages", "cookies", "tags", "tag_variables", "links", "accessibility_issues", "network_requests"

  - `reports.isFavorite` (boolean, required)
    Indicates if the saved report is marked as favorite by the current user

  - `reports.createdByUserId` (integer, required)

  - `reports.myLastViewed` (string, required)
    Date-time in [RFC3339 profile ISO 8601 format](https://www.ietf.org/rfc/rfc3339.txt) with
the following additional restrictions:
1. An uppercase T must separate the date and time portions.
2. An uppercase Z must denote that a numeric time zone offset isn't present.

In general, these timestamp requirements are the same in
[AWS Step Functions - Choice Rules](https://docs.aws.amazon.com/step-functions/latest/dg/amazon-states-language-choice-state.html)
    Example: "2016-08-18T17:33:00Z"

  - `reports.isEditable` (boolean, required)
    TRUE if specified  can be changed by the user who made the API request, FALSE otherwise

  - `reports.displayMetadata` (object, required)
    Display metadata for the saved report

  - `reports.queryDefinition` (object, required)
    Default Grid request body properties.
Default behaviour:
- if no page number is specified, default is 0 (the first results page)
- if no size is specified, default is 100
- if no filters are specified, default is to return all runs
Default behaviour for exports:
- if page and size are not specified, all available rows will be exported

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

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

  - `reports.queryDefinition.filters` (object)

  - `reports.queryDefinition.filters.conditions` (array)

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

  - `reports.queryDefinition.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"

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

  - `reports.queryDefinition.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"

  - `reports.queryDefinition.columns` (array)

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

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

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

  - `reports.isSharable` (boolean, required)
    TRUE if specified  does not use cross-account grid querying mode, FALSE otherwise

  - `reports.isManagedByOP` (boolean, required)
    TRUE if specified  is managed by ObservePoint, FALSE otherwise

  - `reports.scheduledExportCount` (integer, required)
    Number of Scheduled Exports associated with this report

  - `reports.sequenceNumber` (integer)
    Ordering sequence number for ObservePoint-managed reports. Only available for ObservePoint-managed reports.

  - `reports.isHighlighted` (boolean)
    Indicates if the report should be displayed in the top row. Only available for ObservePoint-managed reports.

  - `reports.isExperimental` (boolean)
    Indicates if the report is experimental and should only be visible to OpAdmin users. Only available for ObservePoint-managed reports.

  - `reports.visualizations` (array)

  - `reports.visualizations.name` (string, required)
    Name of the visualization

  - `reports.visualizations.definition` (object, required)
    JSON object containing FE definition for the visualization

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