Skip to main content

​
Overview

Check the current processing status for a file upload and the batch verification task created from it.

​
GET /api/v1/tasks/batch/uploads/

Purpose: fetch the current status of a file upload and its task. Access: Non-admins can only access their own uploads. Path parameter:
  • upload_id (UUID)
Example request: 
curl -X GET \
  'https://api.example.com/api/v1/tasks/batch/uploads/7d3df4c6-9a7d-4d16-9f2b-2a5ddf4f4f53'

​
Response

Status: 200 OK Example response: 
{
  "upload_id": "7d3df4c6-9a7d-4d16-9f2b-2a5ddf4f4f53",
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "filename": "emails.csv",
  "email_count": 123,
  "user_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "created_at": "2025-01-01T12:00:00Z",
  "updated_at": "2025-01-01T12:05:00Z",
  "task": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "user_id": "550e8400-e29b-41d4-a716-446655440000",
    "webhook_url": "https://example.com/webhook",
    "created_at": "2025-01-01T12:00:00Z",
    "updated_at": "2025-01-01T12:05:00Z"
  }
}
Response fields:
  • upload_id, task_id, filename, email_count, status.
  • user_id: owner of the upload (omitted for dev keys).
  • created_at, updated_at: upload timestamps.
  • task: task record created for this upload.
Errors:
  • 400 invalid UUID.
  • 401 unauthorized.
  • 403 forbidden.
  • 404 upload not found.
  • 500 internal error.