---
title: "Get one InboxKit import run"
method: GET
path: "/mailboxes/inboxkit/imports/{run_id}/"
tags: ["senders"]
---

# Get one InboxKit import run

`GET /mailboxes/inboxkit/imports/{run_id}/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/mailboxes/inboxkit/imports/{run_id}/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

The run plus every requested mailbox and its outcome, failure reasons included.

## Path parameters

- `run_id` string, uuid, required

## Response `200`

Successful Response

- InboxkitImportRunDetailReadSchema
  - `failed_count` integer, required
  - `finished_at` string, date-time, nullable, required
  - `id` string, uuid, required
  - `imported_count` integer, required
  - `items` InboxkitImportRunItemReadSchema[], required
    - `domain_name` string, required
    - `email_address` string, required
    - `reason` string, nullable, required
    - `status` 'pending' | 'authorizing' | 'imported' | 'skipped_unlisted' | 'failed', required: One requested mailbox's outcome within an import run. PENDING items sit on an already-authorized domain awaiting the synchronous import; AUTHORIZING items wait on their domain's delegation handshake. The terminal states: IMPORTED connected, SKIPPED_UNLISTED vanished from InboxKit's inventory between request and import, FAILED carries a reason.
  - `requested_count` integer, required
  - `skipped_count` integer, required
  - `started_at` string, date-time, required
  - `status` 'running' | 'succeeded' | 'partial' | 'failed', required: Where one import request stands. RUNNING until every item reaches a terminal state; then SUCCEEDED when everything imported, FAILED when nothing did, PARTIAL for the mix. Status and counts are always derived from items. Three independent paths (the synchronous import, the authorize workflow's import, and its failure branches) finalize items, so denormalized counters would drift.
  - `trigger` 'manual' | 'auto', required: Who asked for the import: a person in the picker, or the hourly sweep.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found.
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)