---
title: "Poll one import run (partner)"
method: GET
path: "/v1/import_runs/{id}"
tags: ["Import Runs"]
---

# Poll one import run (partner)

`GET /v1/import_runs/{id}`

## Request

- Base URL: `https://api.hify.club`
- URL: `https://api.hify.club/v1/import_runs/{id}`
- Auth: one of:
  - API key in header `X-Access-Key-Id` and API key in header `X-Signature`
  - API key in header `X-Access-Key-Id` and API key in header `X-Access-Secret`

The partner's read of its own run, scoped to the calling integration. Authenticated by the integration's credentials, not a user session: X-Access-Key-Id plus X-Signature for signing kinds, or X-Access-Key-Id plus X-Access-Secret for static_token kinds. The errors key here is the partner-facing alias for the admin payload's error_details.

## Response `200`

Import run status

- object
  - `id` string, uuid
  - `status` 'open' | 'in_progress' | 'completed' | 'failed' | 'staged'
  - `kind` string
  - `started_at` string, date-time, nullable
  - `finished_at` string, date-time, nullable
  - `errors` object[]
  - `summary` object

## Other responses

- `404`: No such run for this integration

---

[API](https://skmtc.dev/hify/apis/hify-apis.md) - [All operations](https://skmtc.dev/hify/apis/hify-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/hify/apis/hify-apis/revisions/b5920403538d?raw)