Pay Entry

Get New Payroll Batch Status

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.

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

Path parameters

companyIdunknown required

The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity

timeImportFileTrackingIdunknown required

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

Headers

Authorizationunknown required

Bearer token

Response

successful operation

fileNamestring
timeImportFileTrackingIdstring
statusstring

Changes

No recorded changes to this operation across all 1 revision of this API.