---
title: "Get an archive import's status and live digest"
method: GET
path: "/v1/imports/{id}"
tags: ["Imports"]
---

# Get an archive import's status and live digest

`GET /v1/imports/{id}`

## Request

- Base URL: `https://api.memestack.ai`
- URL: `https://api.memestack.ai/v1/imports/{id}`
- Auth: HTTP bearer

Owner or admin only (404 for anyone else — imports have no public visibility tier). The digest is computed live from `images.import_id` (per-status counts), not a denormalized counter, combined with the job row's own cursor/skip/error counters.

## Path parameters

- `id` string, uuid, required

## Response `200`

Import detail + digest.

- object
  - `import` ArchiveImport
    - `id` string, uuid
    - `creator_id` string, uuid
    - `kind` 'zip' | 'url_list'
    - `status` 'awaiting_transfer' | 'transferring' | 'queued' | 'running' | 'draining' | 'completed' | 'failed' | 'cancelled' | 'reverting' | 'reverted'
    - `archive_size_bytes` integer, nullable
    - `total_entries` integer, nullable: Set once the transfer is validated (zip: central directory entry count; url_list: url count).
    - `cursor` integer: Next entry index the consumer will process.
    - `error_count` integer
    - `skip_count` integer: Non-image entries, oversized entries, and dedup skips.
    - `errors` object[]: Capped at 200; overflow only increments error_count.
      - `entry` string
      - `reason` string
    - `last_error` string, nullable
    - `user_context` string, nullable
    - `created_at` string, date-time
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
  - `digest` object
    - `by_status` object: Per-image-status counts, e.g. {"approved": 120, "needs_review": 4}.
    - `skip_count` integer
    - `error_count` integer
    - `errors` object[]
      - `entry` string
      - `reason` string
    - `cursor` integer
    - `total_entries` integer, nullable

## Other responses

- `404`: Import not found, or caller is neither the owner nor an admin.

---

[API](https://skmtc.dev/memestack/apis/memestack-api.md) · [All operations](https://skmtc.dev/memestack/apis/memestack-api/llms.txt) · [OpenAPI document](https://skmtc.dev/memestack/apis/memestack-api/revisions/9d3a19565f75?raw)