---
title: "List InboxKit import runs"
method: GET
path: "/mailboxes/inboxkit/imports/"
tags: ["senders"]
---

# List InboxKit import runs

`GET /mailboxes/inboxkit/imports/`

## 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/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

The import history: every request, who triggered it, and its per-mailbox counts.

## Query parameters

- `limit` integer: The number of items to return.
- `order_by` 'id' | 'created_at' | 'started_at'
- `order_direction` 'asc' | 'desc'
- `cursor` string, nullable: Set the cursor to the next or previous page. You can get the cursor from the previous page's response.

## Response `200`

Successful Response

- PaginatedResponseInboxkitImportRunReadSchema
  - `data` InboxkitImportRunReadSchema[]: The list of ResponseItems.
    - `failed_count` integer, required
    - `finished_at` string, date-time, nullable, required
    - `id` string, uuid, required
    - `imported_count` integer, required
    - `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.
  - `next_page_cursor` string, nullable: The cursor to the next page. If there are no more pages, this is None.
  - `previous_page_cursor` string, nullable: The cursor to the previous page. If there are no previous pages, this is None.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `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)