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

List your company's data imports, most recent first.

An import is one run of Qobra pulling data in — a CRM/integration refresh, a CSV
upload or an API push — into a data table, a quota or the user directory. Each
row summarizes one run: its status, what triggered it, which resource types it
touched, an overall progress and an error flag. Combine the filters (AND) to
zoom in, e.g. resource\_type='quota' + status='finished', or error=True to triage
failed runs. Fetch get\_import for the per-batch breakdown (record counters,
error detail) of a single run. Only the last 12 months are queryable — older
imports are stale and not returned.

## Parameters

<Accordion title="Body" defaultOpen>
  <ParamField body="resource_type" type="string">
    Keep only imports that touched this resource type: 'data\_table', 'quota' or
    'user'. Omit for every type.
  </ParamField>

  <ParamField body="status" type="string">
    Keep only imports in this state: 'scheduled', 'started' or 'finished'. Omit
    for every state.
  </ParamField>

  <ParamField body="created_after" type="string">
    Keep only imports created at or after this instant. Accepts an absolute
    ISO-8601 date/time ('2026-07-01') or a duration relative to now ('-P7D' for
    the last 7 days). Omit for no lower bound.
  </ParamField>

  <ParamField body="created_before" type="string">
    Keep only imports created at or before this instant. Same accepted forms as
    created\_after. Omit for no upper bound.
  </ParamField>

  <ParamField body="error" type="boolean">
    True keeps only imports with at least one failed batch; False keeps only
    imports where every batch succeeded. Omit for both.
  </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="imports" type="object[]">
    <Expandable title="object properties">
      <ResponseField name="id" type="string" />

      <ResponseField name="status" type="string">
        Overall status: 'scheduled', 'started' or 'finished'. One of:
        `scheduled`, `started`, `finished`.
      </ResponseField>

      <ResponseField name="trigger" type="string">
        What kicked the import off, e.g. 'scheduled\_refresh',
        'integration\_refresh' or 'quota\_sync'. Null when unknown. One of:
        `scheduled_refresh`, `integration_refresh`,
        `integrations_with_frequency_refresh`, `braqoffice_refresh`,
        `data_table_refresh`, `data_table_settings_update`, `field_creation`,
        `quota_creation`, `quota_sync`, `quota_refresh`,
        `quota_settings_update`.
      </ResponseField>

      <ResponseField name="progress" type="integer">
        Overall completion 0–100, averaged across the import's batches (100 when
        it has no batch).
      </ResponseField>

      <ResponseField name="error" type="boolean">
        True when any batch in the import ended in error.
      </ResponseField>

      <ResponseField name="resource_types" type="string[]">
        Distinct resource types the import touched — any of 'data\_table',
        'quota', 'user'.
      </ResponseField>

      <ResponseField name="author_email" type="string">
        Email of the user who triggered the import; null for a system or
        scheduled import.
      </ResponseField>

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

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

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

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