Stay organized with collections
Save and categorize content based on your preferences.
Version 4.0.25.14 (latest)
Search Reports
Returns an array of Report objects that match the specified search criteria.
If multiple search params are given and filter_or is FALSE or not specified,
search params are combined in a logical AND operation.
Only rows that match all search param criteria will be returned.
If filter_or is TRUE, multiple search params are combined in a logical OR operation.
Results will include rows that match any of the search criteria.
String search params use case-insensitive matching.
String search params can contain % and '_' as SQL LIKE pattern match wildcard expressions.
example="dan%" will match "danger" and "Danzig" but not "David"
example="D_m%" will match "Damage" and "dump"
Integer search params can accept a single value or a comma separated list of values. The multiple
values will be combined under a logical OR operation - results will match at least one of
the given values.
Most search params can accept "IS NULL" and "NOT NULL" as special expressions to match
or exclude (respectively) rows where the column is null.
Boolean search params accept only "true" and "false" as values.
Request
GET
/reports/search
Datatype
Description
Request
HTTP Request
query
HTTP Query
Expand HTTP Query definition...
folder_id
string
Select reports in a particular folder.
favorite
boolean
Select favorite reports.
recent
boolean
Select reports viewed recently.
id
string
Match report id.
title
string
Match report title.
sorts
string
One or more fields to sort results by.
limit
integer
Number of results to return.(used with next_page_token)
fields
string
Comma delimited list of field names. If provided, only the fields specified will be included in the response.
next_page_token
string
Contains a token that can be used to return up to Number of results to return.(used with next_page_token) additional results. A next_page_token will not be returned if there are no additional results to display.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[],[],null,["# Search Reports\n\nVersion 4.0.25.14 (latest)\n\n### Search Reports\n\nReturns an **array of Report objects** that match the specified search criteria.\n\nIf multiple search params are given and `filter_or` is FALSE or not specified,\nsearch params are combined in a logical AND operation.\nOnly rows that match *all* search param criteria will be returned.\n\nIf `filter_or` is TRUE, multiple search params are combined in a logical OR operation.\nResults will include rows that match **any** of the search criteria.\n\nString search params use case-insensitive matching.\nString search params can contain `%` and '_' as SQL LIKE pattern match wildcard expressions.\nexample=\"dan%\" will match \"danger\" and \"Danzig\" but not \"David\"\nexample=\"D_m%\" will match \"Damage\" and \"dump\"\n\nInteger search params can accept a single value or a comma separated list of values. The multiple\nvalues will be combined under a logical OR operation - results will match at least one of\nthe given values.\n\nMost search params can accept \"IS NULL\" and \"NOT NULL\" as special expressions to match\nor exclude (respectively) rows where the column is null.\n\nBoolean search params accept only \"true\" and \"false\" as values.\n\nRequest\n-------\n\nGET /reports/search \nDatatype \nDescription \nRequest \nHTTP Request \nquery \nHTTP Query \nExpand HTTP Query definition... \nfolder_id \nstring \nSelect reports in a particular folder. \nfavorite \nboolean \nSelect favorite reports. \nrecent \nboolean \nSelect reports viewed recently. \nid \nstring \nMatch report id. \ntitle \nstring \nMatch report title. \nsorts \nstring \nOne or more fields to sort results by. \nlimit \ninteger \nNumber of results to return.(used with next_page_token) \nfields \nstring \nComma delimited list of field names. If provided, only the fields specified will be included in the response. \nnext_page_token \nstring \nContains a token that can be used to return up to Number of results to return.(used with next_page_token) additional results. A next_page_token will not be returned if there are no additional results to display.\n\nResponse\n--------\n\n### 200: returns a list of reports.\n\nDatatype \nDescription \n(array) \n[Report](/looker/docs/reference/looker-api/latest/types/Report)\\[\\] \ncan \n*lock* \nobject \nOperations the current user is able to perform on this object \nid \nstring \nID of the report \ntitle \nstring \nTitle of the report \nuser_id \nstring \nUser Id of the owner of the report \ncreated_at \n*lock* \nstring \nCreated at \nupdated_at \n*lock* \nstring \nModified at \nlast_viewed_at \n*lock* \nstring \nLast viewed at \nfavorite \nboolean \nIs favorite report \nfavorite_count \n*lock* \ninteger \nFavorite count \nview_count \n*lock* \ninteger \nView count \nfolder \n*lock* \n[FolderBase](/looker/docs/reference/looker-api/latest/types/FolderBase) \nfolder where the report is stored\nExpand FolderBase definition... \nname \nstring \nUnique Name \nparent_id \nstring \nId of Parent. If the parent id is null, this is a root-level entry \nid \n*lock* \nstring \nUnique Id \ncontent_metadata_id \n*lock* \nstring \nId of content metadata \ncreated_at \n*lock* \nstring \nTime the folder was created \ncreator_id \n*lock* \nstring \nUser Id of Creator \nchild_count \n*lock* \ninteger \nChildren Count \nexternal_id \n*lock* \nstring \nEmbedder's Id if this folder was autogenerated as an embedding shared folder via 'external_group_id' in an SSO embed login \nis_embed \n*lock* \nboolean \nFolder is an embed folder \nis_embed_shared_root \n*lock* \nboolean \nFolder is the root embed shared folder \nis_embed_users_root \n*lock* \nboolean \nFolder is the root embed users folder \nis_personal \n*lock* \nboolean \nFolder is a user's personal folder \nis_personal_descendant \n*lock* \nboolean \nFolder is descendant of a user's personal folder \nis_shared_root \n*lock* \nboolean \nFolder is the root shared folder \nis_users_root \n*lock* \nboolean \nFolder is the root user folder \ncan \n*lock* \nobject \nOperations the current user is able to perform on this object \nfolder_id \nstring \nId of the folder where the report is stored \nurl \n*lock* \nstring \nRelative URL of the report \nuser_name \n*lock* \nstring \nName of User that created the Studio Report. \ndeleted_at \n*lock* \nstring \nDeleted at \nlast_accessed_at \n*lock* \nstring \nLast Accessed at \ndeleter_user_id \n*lock* \nstring \nUser Id of the deleter of the report \ndeleter_user_name \n*lock* \nstring \nName of User that deleted the Report. \nschedule_count \n*lock* \ninteger \nCount of schedules on the report.\n\n### 400: Bad Request\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 404: Not Found\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link\n\n### 429: Too Many Requests\n\nDatatype \nDescription \n(object) \n[Error](/looker/docs/reference/looker-api/latest/types/Error) \nmessage \n*lock* \nstring \nError details \ndocumentation_url \n*lock* \nstring \nDocumentation link"]]
