Skip to main content
GET
Check Upload Status
This endpoint checks the status of a task upload operation using the upload task ID returned from the Upload Tasks endpoint.

Headers

string
required
Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

string
required
The upload task ID returned from Upload Tasks endpoint. Example: 427a7bfc54cf4ce483d83ba23425164b

Response Field Explanations

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

State Values

Poll this endpoint periodically until state is SUCCESS or FAILURE before running your squid.
Check meta.invalid to identify how many rows had issues. Review your CSV format if this number is high.
Don’t start a squid run until the upload state is SUCCESS, or you may miss tasks.

Code Examples

Response

200
202
404