GET/v1/tasks/upload/{upload_task_id}

Check Upload Status

Monitor the status of a task upload operation

This endpoint checks the status of a task upload operation using the upload task ID returned from the Upload Tasks endpoint.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Response Field Explanations

id
string
Upload task identifier
Example: 427a7bfc54cf4ce483d83ba23425164b
object
string
Always "task_upload"
Example: task_upload
state
string
Current upload state (PENDING, PROGRESS, SUCCESS, FAILURE)
Example: SUCCESS
meta.duplicates
integer
Number of duplicate tasks skipped
Example: 0
meta.inserted
integer
Number of tasks successfully inserted
Example: 8
meta.invalid
integer
Number of invalid rows in the file
Example: 0
meta.valid
integer
Number of valid rows processed
Example: 8

State Values

PENDING
Description:
Upload task is queued and waiting to start
PROGRESS
Description:
File is being processed
SUCCESS
Description:
Upload completed successfully
FAILURE
Description:
Upload failed due to an error

Parameters

upload_task_idstring
Required
The upload task ID returned from Upload Tasks endpoint
Example: 427a7bfc54cf4ce483d83ba23425164b
Pro Tip

Pro Tip

Poll this endpoint periodically until state is SUCCESS or FAILURE before running your squid.
Note

Note

Check meta.invalid to identify how many rows had issues. Review your CSV format if this number is high.
Warning

Warning

Don't start a squid run until the upload state is SUCCESS, or you may miss tasks.