---
title: "List Time Tracking Imports"
method: GET
path: "/api/v1/time-tracking/imports"
tags: ["Time Tracking", "Public API"]
---

# List Time Tracking Imports

`GET /api/v1/time-tracking/imports`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/time-tracking/imports`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `/authorize.php`
    - Token URL: `/token.php` scopes: `time_tracking:imports`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/time-tracking/imports/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of time tracking imports, newest first. Soft-deleted imports are never returned.

OAuth Scopes: time_tracking:imports

## Query parameters

- `status` 'DRAFT' | 'COMPLETE'
- `page` integer
- `pageSize` integer

## Response `200`

Successfully retrieved the imports.

- object
  - `data` TimeTrackingTimeTrackingImportV1[], required: Collection of time tracking imports.
    - `id` integer: Identifier for the import.
    - `status` 'DRAFT' | 'COMPLETE' | 'DELETED': Where the import is in its lifecycle. `DRAFT` imports have not been executed yet.
    - `fileSize` integer: Size of the stored file in bytes.
    - `rowCount` integer: Total number of data rows parsed out of the file.
    - `errorRowCount` integer: Number of rows currently failing validation.
    - `columnMapping` object: BambooHR field name to zero-indexed CSV column position. Unmapped optional fields are omitted.
    - `createdAt` string, date-time: When the import was created.
    - `updatedAt` string, date-time, nullable: When the import was last modified. Null if it has not been modified since creation.
    - `completedAt` string, date-time, nullable: When the import was executed. Null while `DRAFT`, and for imports completed before completion times were recorded.
    - `deletedAt` string, date-time, nullable: When the import was soft-deleted. Null for active imports.
  - `meta` object, required
    - `totalItems` integer, required
    - `page` integer, required
    - `pageSize` integer, required
    - `totalPages` integer, required
  - `_links` object, required
    - `prev` object, nullable, required: Link to the previous page, or null when on the first page.
      - `href` string, uri
    - `next` object, nullable, required: Link to the next page, or null when on the last page.
      - `href` string, uri

## Other responses

- `401`: Unauthorized. Missing or invalid authentication.
- `403`: Forbidden. Insufficient permissions.
- `422`: A query parameter is invalid.

## Changes

- **2026-11-03** `922fc15f43a7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bamboohr/apis/bamboohr-api/changes/api/v1/time-tracking/imports/get.md)

---

[API](https://skmtc.dev/bamboohr/apis/bamboohr-api.md) - [All operations](https://skmtc.dev/bamboohr/apis/bamboohr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bamboohr/apis/bamboohr-api/revisions/922fc15f43a7?raw)