---
title: "Get subscriber import"
method: GET
path: "/subscribers/imports/{importId}"
tags: ["Subscribers"]
---

# Get subscriber import

`GET /subscribers/imports/{importId}`

Returns progress, counts, and failure summaries by import ID or batch ID. Every excluded row is explained - skippedReasons sums to skippedCount and failedReasons sums to failedCount.

## Path parameters

- `importId` string, required

## Response `200`

Import status returned

- object
  - `success` boolean
  - `import` SubscriberImport
    - `id` string
    - `batchId` string
    - `fileName` string
    - `status` 'running' | 'completed'
    - `totalRows` integer
    - `emailCount` integer
    - `duplicateRows` integer
    - `addedCount` integer
    - `updatedCount` integer
    - `skippedCount` integer
    - `failedCount` integer
    - `processedCount` integer
    - `totalChunks` integer
    - `completedChunks` integer
    - `failedChunks` integer
    - `skippedReasons` object — Count per reason a row was skipped. The values sum to skippedCount.
    - `failedReasons` object
    - `failedChunkReasons` object
    - `startedAt` string, date-time
    - `completedAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `401` — Unauthorized
- `404` — Subscriber import not found
- `503` — The database was temporarily unavailable. The request may be retried after the delay in Retry-After.

## Changes

- **2026-08-19** `ba3a29c6eb33` — 3 info
  - added the optional property `retryable` to the response with the `401` status
  - added the optional property `retryable` to the response with the `404` status
  - added the optional property `retryable` to the response with the `503` status
- **2026-08-18** `8fbabe82a04d` — 1 info
  - added the non-success response with the status `503`
- **2026-08-16** `6fd2903b91ce` — 2 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `404` status
- **2026-08-02** `36f92fc0caa2` — 2 breaking
  - the response property `success` became optional for the status `401`
  - the response property `success` became optional for the status `404`
- **2026-07-17** `a555705535c7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/subscribers/imports/:importId/get.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/0a7fab9aeda6/schema)