---
title: "Get an import"
method: GET
path: "/import/runs/{workspaceId}/{runId}"
tags: ["Import"]
---

# Get an import

`GET /import/runs/{workspaceId}/{runId}`

## Request

- Base URL: `https://cloud.kaneo.app/api`
- URL: `https://cloud.kaneo.app/api/import/runs/{workspaceId}/{runId}`
- Auth: HTTP bearer

Progress and outcome of one import, including each project's status, counts and warnings.

## Path parameters

- `workspaceId` string, required
- `runId` string, required

## Response `200`

The import

- ImportRunEnvelope
  - `run` ImportRun, required
    - `id` string, required
    - `workspaceId` string, required
    - `source` 'planka' | 'plane' | 'linear' | 'jira' | 'trello' | 'kaneo', required
    - `status` 'running' | 'completed' | 'failed', required: completed once every selected project was attempted, even if some failed; check each project's status. failed means the run itself stopped.
    - `includeComments` boolean, required
    - `message` string, nullable, required: Latest progress line while the run is running.
    - `error` string, nullable, required
    - `projects` ImportRunProject[], required
      - `sourceId` string, required
      - `name` string, required
      - `status` 'pending' | 'running' | 'completed' | 'failed', required
      - `projectId` string, nullable, required: The Kaneo project created by the import, once completed.
      - `projectSlug` string, nullable, required
      - `counts` ImportCounts, required
        - `columns` integer, required
        - `tasks` integer, required
        - `labels` integer, required
        - `comments` integer, required
        - `assignees` integer, required: Tasks that were assigned to a workspace member.
        - `relations` integer, required
      - `warnings` string[], required
      - `error` string, nullable, required
    - `createdAt` string, date-time, required
    - `finishedAt` string, date-time, nullable, required

## Other responses

- `401`: Missing or invalid credentials
- `403`: Missing workspace:manage_settings or project:create permission
- `404`: Workspace or import not found
- `429`: The API key exceeded its rate limit or usage quota. Wait the number of seconds in Retry-After before retrying. The X-RateLimit headers are sent only when the rate limit was hit.

## Changes

- **2026-10-11** `269feaac2cc4`: 1 info
  - endpoint added
- **2026-10-11** `4cb086e51a1a`: 1 breaking
  - api path removed without deprecation
- **2026-10-11** `f701bf7cf2d9`: 1 warning
  - added the new `jira` enum value to the `run/source` response property for the response status `200`
- **2026-10-11** `ec2dabb1d0cc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/import/runs/:workspaceId/:runId/get.md)

---

[API](https://skmtc.dev/usekaneo/apis/kaneo-api.md) - [All operations](https://skmtc.dev/usekaneo/apis/kaneo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usekaneo/apis/kaneo-api/revisions/93f78789100c?raw)