---
title: "Get background history-import progress"
method: GET
path: "/api/assistant/backfill"
tags: ["Mailzero Assistant"]
---

# Get background history-import progress

`GET /api/assistant/backfill`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/assistant/backfill`
- Auth: HTTP bearer

Returns scanning/analysis phase, processed and total messages, percentage, adaptive ETA, pause state, and whether the app may close. Requires the assistant:read scope.

## Response `200`

Latest history-import progress, or null when none exists

- object
  - `backfill` object, nullable
    - `id` string
    - `status` 'queued' | 'scanning' | 'processing' | 'completed' | 'cancelled'
    - `phase` string
    - `paused` boolean
    - `processed` integer
    - `total` integer
    - `failed` integer
    - `percent` number, nullable
    - `estimated_seconds_remaining` integer, nullable
    - `estimated_completion_at` string, nullable
    - `can_close_app` boolean
    - `started_at` string
    - `completed_at` string, nullable

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)