---
title: "List Time Tracking Import Rows"
method: GET
path: "/api/v1/time-tracking/imports/{id}/rows"
tags: ["Time Tracking", "Public API"]
---

# List Time Tracking Import Rows

`GET /api/v1/time-tracking/imports/{id}/rows`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/time-tracking/imports/{id}/rows`
- 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/:id/rows/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of the rows of a time tracking import, in the order they appear in the uploaded file. Rows of a soft-deleted import are not returned.

OAuth Scopes: time_tracking:imports

## Path parameters

- `id` integer, required

## Query parameters

- `errorsOnly` boolean
- `page` integer
- `pageSize` integer

## Response `200`

Successfully retrieved the rows.

- object
  - `data` TimeTrackingTimeTrackingImportRowV1[], required: Collection of time tracking import rows.
    - `id` integer: Identifier for the row.
    - `importId` integer: Identifier of the import the row belongs to.
    - `rowNumber` integer: Position of the row in the uploaded file, counting the data rows from 1.
    - `employeeNumber` string: Employee number the hours belong to.
    - `dateWorked` string: Date the hours were worked, as `YYYY-MM-DD`. A row failing date validation keeps the value the file supplied.
    - `hoursWorked` string: Hours worked, to at most four decimal places.
    - `rateType` 'REGULAR' | 'OVERTIME' | 'DOUBLE_TIME', nullable: How the hours are paid. Null when the file supplied a value that is not a recognized rate type.
    - `payRate` string, nullable: Hourly rate the hours are paid at.
    - `payCode` string, nullable: Pay code applied to the hours.
    - `projectName` string, nullable: Project the hours are tracked against.
    - `taskName` string, nullable: Task the hours are tracked against.
    - `shiftDifferentialName` string, nullable: Shift differential applied to the hours.
    - `holidayName` string, nullable: Company holiday the hours are attributed to.
    - `qualifiedOvertimeHours` string, nullable: Hours that qualify for overtime, to at most four decimal places.
    - `errors` object, nullable: Validation failures keyed by the field that failed, or null when the row is valid.
    - `corrections` object, nullable: Values the import corrected on the caller's behalf, keyed by field, or null when nothing was corrected. Each entry carries the value the file supplied and the corrections applied to it.
    - `timeTrackingId` string, nullable: Identifier of the time tracking record the row created. Null until the import is executed.
  - `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.
- `404`: Import not found, or soft-deleted.
- `422`: The provided import ID or 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/:id/rows/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)