---
title: "List imports for a planning table"
method: GET
path: "/tables/{table_pk}/imports"
tags: ["Planning Table"]
---

# List imports for a planning table

`GET /tables/{table_pk}/imports`

Paginated import history for this table. Default sort is newest first (`-created_at`). Filter with `status`, `source_import_type`, and `error_code`. Sort with `ordering` (created_at, completed_at, status). Page with `page` and `limit`.

## Path parameters

- `table_pk` string, required

## Query parameters

- `limit` integer
- `ordering` string
- `page` integer

## Headers

- `X-Company-ID` string, required

## Response `200`

- PaginatedPlanningTableImportList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` PlanningTableImport[], required
    - `id` integer, required
    - `planning_table_id` integer, required
    - `status` 'ERROR' | 'IMPORTED' | 'PROCESSING' | 'CANCELLED', required — * `ERROR` - Error * `IMPORTED` - Imported * `PROCESSING` - Processing * `CANCELLED` - Cancelled
    - `status_message` string, nullable, required
    - `error_code` union, required
      - 'SOURCE_UNAVAILABLE' | 'SOURCE_RATE_LIMITED' | 'DUPLICATE_SOURCE_KEYS' | 'IMPORT_FAILED' | 'IMPORT_STALE' — * `SOURCE_UNAVAILABLE` - Source unavailable * `SOURCE_RATE_LIMITED` - Source rate limited * `DUPLICATE_SOURCE_KEYS` - Duplicate source keys * `IMPORT_FAILED` - Import failed * `IMPORT_STALE` - Import stale
      - unknown
    - `created_at` string, date-time, required
    - `completed_at` string, date-time, nullable, required
    - `source_import_type` 'USER' | 'SCHEDULED', required — * `USER` - User * `SCHEDULED` - Scheduled

## Changes

- **2026-08-31** `8ff8b401f791` — 2 breaking
  - added `#/components/schemas/ErrorCodeEnum, #/components/schemas/NullEnum` to the `results/items/error_code` response property `oneOf` list for the response status `200`
  - the `results/items/error_code` response's property type changed from `string` to no type for status `200`
- **2026-08-25** `2ef6e2cdfaef` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/cubesoftware/apis/cube-api/changes/tables/:table_pk/imports/get.md)

---

[API](https://skmtc.dev/cubesoftware/apis/cube-api.md) · [All operations](https://skmtc.dev/cubesoftware/apis/cube-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cubesoftware/cube-api/revisions/8ff8b401f791/schema)