Skip to main content

Overview

List the email jobs for a batch verification task, including per-email results when available.

GET /api/v1/tasks//jobs

Purpose: get a paginated list of email jobs for a specific batch verification task, including nested verification results (when available). Path parameter:
  • id (UUID, required)
Query parameters:
  • limit (int, default 10, max 100)
  • offset (int, default 0)
Notes:
  • Each job includes email data when the job is associated with an emails record (i.e. when email_id is set). Otherwise email is omitted.
  • Results are ordered by created_at DESC.
Example request:

Response

Status: 200 OK Example response:
Email fields:
  • id, email, status, is_role_based.
  • is_disposable, has_mx_records, has_reverse_dns.
  • domain_name, host_name, server_type, is_catchall.
  • validated_at, unknown_reason, needs_physical_verify.
Errors:
  • 400 invalid ID or pagination parameters.
  • 401 unauthorized.
  • 404 batch verification task not found.
  • 500 internal error.