Skip to navigation

Get New Payroll Batch Status

View as Markdown

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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

companyIdstringRequired

Paylocity company identifier (COID): up to 9 alphanumeric characters for the target company.

timeImportFileTrackingIdstringRequired

Payroll batch / import tracking identifier returned by the create-import operation.

Headers

AcceptstringOptional

Media type(s) the client can accept in the response (typically application/json).

Response

Successful response

Errors

401
Unauthorized Error