> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qobra.co/llms.txt
> Use this file to discover all available pages before exploring further.

# list_dashboards

List your company's reporting dashboards, with an optional name filter and
pagination.

Each row summarizes one dashboard: its name, description, and when it was last
updated. Dashboards live under the reports section; a dashboard groups
visualizations of existing reports — call `get_dashboard` for a dashboard's
tiles, their layout, and the reports they render.

Dashboards have no per-dashboard sharing — you either see all of the company's
dashboards or none, depending on your reporting access.

## Parameters

<Accordion title="Body" defaultOpen>
  <ParamField body="search" type="string">
    Filter matched against the dashboard name (case- and accent-insensitive
    substring) or, when it is a valid ObjectId, against the dashboard id.
  </ParamField>

  <ParamField body="limit" type="integer">
    Page size, between 1 and 250. Defaults to 50.
  </ParamField>

  <ParamField body="offset" type="integer">
    Row offset into the result set — the number of rows to skip before this
    page. Pass the next\_offset returned by the previous call, or None for the
    first page.
  </ParamField>
</Accordion>

## Response

<Accordion title="Body" defaultOpen>
  <ResponseField name="dashboards" type="object[]">
    <Expandable title="object properties">
      <ResponseField name="id" type="string" />

      <ResponseField name="resource_url" type="string">
        Deep link to open this dashboard in the Qobra web app.
      </ResponseField>

      <ResponseField name="name" type="string" />

      <ResponseField name="description" type="string" />

      <ResponseField name="updated_at" type="string" />
    </Expandable>
  </ResponseField>

  <ResponseField name="next_offset" type="integer" />
</Accordion>
