---
title: "List import runs (admin)"
method: GET
path: "/v1/admin/import_runs"
tags: ["Import Runs"]
---

# List import runs (admin)

`GET /v1/admin/import_runs`

## Request

- Base URL: `https://api.hify.club`
- URL: `https://api.hify.club/v1/admin/import_runs`
- Auth: API key in header `X-User-Token`

Admin only. Newest first, paginated. A partner reads its own run through GET /v1/import_runs/{id}, which is HMAC-authenticated.

## Query parameters

- `status` 'open' | 'in_progress' | 'completed' | 'failed' | 'staged'
- `kind` string
- `page` integer
- `per_page` integer

## Response `200`

List of import runs

- ImportRun[]
  - `id` string, uuid
  - `source` 'partner_api' | 'retool_upload': partner_api: sent by the partner's signed feed. retool_upload: submitted by ops from Retool on the partner's behalf.
  - `kind` string: Free-form; grows with each importer. e.g. tournament_import
  - `status` 'open' | 'in_progress' | 'completed' | 'failed' | 'staged'
  - `partner_integration_id` integer, nullable
  - `importable_type` string, nullable
  - `importable_id` string, uuid, nullable
  - `row_count` integer, nullable
  - `processed_count` integer
  - `approval_mappings` object: Ids ops attached when approving, e.g. a tournament_id uuid.
  - `summary` object
  - `pending_mappings` string[]: Lifted out of summary. What a staged run is waiting for ops to attach.
  - `error_details` object[]
  - `initiated_by_id` string, uuid, nullable
  - `started_at` string, date-time, nullable
  - `finished_at` string, date-time, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `422`: Unrecognised status filter

---

[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)