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

List the requests you can see, with simple filters and pagination.

A request can gather members, an assignee and a topic, and link statements. You
only see the requests you have access to — those you're a member of, plus any
shared with you. Rows are ordered by most recent activity first (last
modification date).

## Parameters

<Accordion title="Body" defaultOpen>
  <ParamField body="view" type="string">
    View to filter by. Either a built-in view — "assigned to me", "my requests"
    (the requests you created), or "all requests" (every request in the company)
    — or the name (case-insensitive substring) or id of a request view shared
    with you. Omit to return every request you can access.
  </ParamField>

  <ParamField body="search" type="string">
    Free-text filter matched against the request name, its full id, or its
    reference (the # reference shown in the UI is the last 8 characters of the
    id; a leading # is accepted).
  </ParamField>

  <ParamField body="status" type="string">
    Status filter. One of open or closed. One of: `open`, `closed`.
  </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="requests" type="object[]">
    <Expandable title="object properties">
      <ResponseField name="id" type="string" />

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

      <ResponseField name="reference" type="string">
        The #-style reference shown in the UI.
      </ResponseField>

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

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

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

      <ResponseField name="topic" type="string">
        Admin-configured category used to classify the request; null if none.
      </ResponseField>

      <ResponseField name="status" type="string">
        open (awaiting handling) or closed (resolved). One of: `open`, `closed`.
      </ResponseField>

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

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

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

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

      <ResponseField name="member_emails" type="string[]" />

      <ResponseField name="linked_statements" type="object[]">
        <Expandable title="object properties">
          <ResponseField name="user_email" type="string" />

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

          <ResponseField name="record_name" type="string">
            The linked deal/record's name when the statement is record-based;
            null otherwise.
          </ResponseField>
        </Expandable>
      </ResponseField>
    </Expandable>
  </ResponseField>

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