> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Push Import

> Status, progress and results of a push import

Returns one import. Poll it while the import runs. Requires the `subscribers:read` scope.

`status` moves from `draft` to `queued`, `exporting` (reading devices from the source), `importing` (writing them), then `completed`, `failed` or `canceled`. `stalled` is true when a running import has not reported progress for 15 minutes; failed and stalled imports have `canResume: true`. `progress.csvParts` is `{ received, expected }` for a `csv` draft created with `csvParts`, and null otherwise; such a draft starts only once `received` equals `expected`.

Counts: `imported` new devices, `matched` opted-in devices Sequenzy already had, `unsubscribed` opted-out devices (stored, never pushed), `skipped` and `invalid` with reasons in `skippedReasons` and `invalidReasons`, and `subscribersCreated`.

## Request

**importId** `string` *required*

The import ID.

```bash theme={null}
curl https://api.sequenzy.com/api/v1/push/imports/pimp_123 \
  --header "Authorization: Bearer $SEQUENZY_API_KEY"
```

## Responses

```json 200 theme={null}
{
  "success": true,
  "import": {
    "id": "pimp_123",
    "status": "completed",
    "counts": { "imported": 41200, "matched": 950, "unsubscribed": 5100, "skipped": 860, "invalid": 100, "subscribersCreated": 12000 },
    "skippedReasons": { "web_push_not_portable": 610, "no_contact_identity": 250 },
    "invalidReasons": { "firebase_installation_id": 100 }
  },
  "message": "Import completed: 41200 imported, 950 matched, 5100 unsubscribed, 860 skipped, 100 invalid."
}
```

```json 401 theme={null}
{
  "error": "Invalid API key"
}
```

```json 403 theme={null}
{
  "error": "API key is missing required scope: subscribers:read"
}
```

```json 404 theme={null}
{
  "error": "Push import not found."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.