---
title: "Get New Payroll Batch Status"
method: GET
path: "/apihub/payroll/v2/companies/{companyId}/payEntryImport/{timeImportFileTrackingId}"
tags: ["Pay Entry"]
---

# Get New Payroll Batch Status

`GET /apihub/payroll/v2/companies/{companyId}/payEntryImport/{timeImportFileTrackingId}`

## Request

- Base URL: `https://dc1demogwext.paylocity.com`
- URL: `https://dc1demogwext.paylocity.com/apihub/payroll/v2/companies/{companyId}/payEntryImport/{timeImportFileTrackingId}`
- Auth: none declared. Required headers: `Authorization`

**Summary Description**

The Get New Payroll Batch Status endpoint is used to retrieve the current status and details of a previously submitted payroll batch. 

**Key Features:**
- Returns the processing status of the payroll batch (e.g., Pending, Completed, Error).
- Provides timestamp information for when the batch was created.
- Includes a summary of the data inserted into the batch.
- Highlights any validation issues or errors that need resolution.

**Important:**
When a payroll batch is successfully submitted using the Create New Payroll Batch endpoint, a `202 Accepted` response is returned. This response includes a `timeImportFileTrackingId`, which is required to query the status of that specific batch. Use this `timeImportFileTrackingId` as the `{timeImportFileTrackingId}` path parameter in the GET New Payroll Batch Status endpoint.

**Recommendation:**
API users should call this endpoint after submitting a batch to ensure the data was successfully processed. If errors are present, they should be addressed before payroll is finalized.

## Path parameters

- `companyId` unknown, required
- `timeImportFileTrackingId` unknown, required

## Headers

- `Authorization` unknown, required

## Response `202`

successful operation

- SuccessResponse
  - `fileName` string
  - `timeImportFileTrackingId` string
  - `status` string

## Other responses

- `400`: invalid body
- `401`: unauthorized
- `403`: forbidden

---

[API](https://skmtc.dev/paylocity/apis/pay-entry.md) - [All operations](https://skmtc.dev/paylocity/apis/pay-entry/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/pay-entry/revisions/c97a1bb2f2cf?raw)