Get Batch Upload Status

🚧

Partner Restricted

All LMS API endpoints are restricted to LMS providers that have signed a Paylocity technology partnership agreement.
Please reach out to our team if you would like to discuss partnership opportunities.

Summary Description

Returns the status of a bulk upload operation, including overall progress, success/failure counts, and detailed status for each content item. Partners can call this endpoint at any time to monitor the progress of their bulk upload.

Use includeDetails=false (default) for lightweight polling and includeDetails=true when detailed per-item diagnostics are needed.

Use Cases

  • Partner wants to check the progress of a bulk upload operation.
  • Partner needs to identify which content items succeeded or failed.
  • Partner wants detailed error messages for failed items.

Status Values

  • Pending: Bulk upload request created, waiting for ZIP file upload
  • Downloading: ZIP file is being downloaded from File Access
  • Downloaded: ZIP file downloaded and extracted
  • Processing: Content items are being created in LMS
  • Uploading: Content files are being uploaded to LMS
  • Created: All content items created successfully (before upload)
  • PartialCreated: Some content items created, some failed (before upload)
  • CreationFailed: All content items failed to create
  • Completed: All content items successfully processed and uploaded
  • PartialSuccess: Some content items succeeded, some failed
  • Failed: All content items failed to process
Path Params
string
required

The Paylocity Company Identifier. Unique value provided by Paylocity.
Allowable Values: 9 char max.

string
required

Unique identifier for the bulk upload operation (GUID).

Query Params
boolean
Defaults to false

If true, includes detailed status for each content item. Default is false.

Headers
boolean

If true, responses are mocked and generated randomly.

Responses

Language
LoadingLoading…
Response
Choose an example:
application/json