Skip to main content

Overview

List batch verification tasks with pagination and optional filters, including whether tasks are file-backed.

GET /api/v1/tasks

Purpose: list batch verification tasks with optional filters, including file-backed status.

Request

Query parameters:
  • limit (int, default 10, max 100)
  • offset (int, default 0)
  • is_file_backed (bool, optional, true or false)
  • created_after (RFC3339 timestamp)
  • created_before (RFC3339 timestamp)
Example request:

Response

Status: 200 OK Example response:
Response fields:
  • tasks: array of batch verification summaries (see fields below).
  • source: optional overall batch verification source when all tasks share the same origin (frontend or api_key).
  • count, limit, offset: pagination metadata.
Batch verification summary fields:
  • id, user_id, webhook_url, source, created_at, updated_at.
  • is_file_backed: indicates whether the batch verification task originated from a file upload.
  • file: file upload metadata (present only when is_file_backed is true, otherwise omitted or null).
  • file.upload_id: UUID of the file upload.
  • file.task_id: UUID of the associated batch verification task.
  • file.filename: original filename of the uploaded file.
  • file.email_count: number of emails in the uploaded file.
  • file.status: upload processing status (processing, completed, failed).
  • file.created_at, file.updated_at: upload timestamps.
  • metrics: aggregated batch verification metrics (see Batch verification metrics fields).
Errors:
  • 400 invalid query parameters.
  • 401 unauthorized.
  • 429 rate limited.
  • 500 internal error.