Bulk jobsFree

list_jobs

List bulk verification jobs

List the account’s bulk jobs, newest first, with status and summary. Filter by status, paginate. Free.

Get an API key + 100 free credits Connect the MCP server

When an agent uses list_jobs

Use list_jobs to find past bulk jobs and their job_ids — for example to resume work after a restart, reconcile what has already been processed, or surface the most recent completed job to a user. It returns jobs newest-first with status, progress, and summary, and can filter by status and paginate. Costs no credits.

REST endpoint

GET /api/v1/jobs

Credit cost

Free

Input schema

Field	Type	Required	Description
`status`	enum	optional	Only return jobs in this status: pending, processing, completed, or failed.
`limit`	integer	optional	Max jobs to return (1-100, default 50).
`offset`	integer	optional	Pagination offset (default 0).

Call it over MCP

An MCP client invokes the tool with a tools/call request. Hosted clients send this to https://verifly.email/mcp with your Authorization: Bearer vf_… header; the verifly-mcp-server package does the same with VERIFLY_API_KEY set.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_jobs",
    "arguments": {
      "status": "completed",
      "limit": 10
    }
  }
}

Posting that same call straight to the hosted endpoint:

curl -s -X POST "https://verifly.email/mcp" \
  -H "Authorization: Bearer vf_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_jobs","arguments":{"status":"completed","limit":10}}}'

Equivalent raw REST call

Under the hood this tool calls GET /api/v1/jobs. If you are not using MCP, hit the REST API directly:

curl -s "https://verifly.email/api/v1/jobs?status=completed&limit=10" \
  -H "Authorization: Bearer vf_your_api_key"

What you get back

A JSON object with total and a jobs array — each with job_id, status, total_emails, progress, summary, credits_used, and timestamps.

Related tools

submit_bulk

Queue a large list (up to 1M) as an async job — returns a job_id to poll. Optional completion webhook.

Open get_job_status

Poll one bulk job by job_id for status, percent progress, and a running valid/invalid/risky summary. Free.

Open get_job_results

Fetch the full per-address results of a completed bulk job by job_id, plus the summary. Free.

Open

Use list_jobs in your agent

Verifly is the only email verifier with a hosted MCP server plus autonomous agent self-registration. An agent can call register_account for an instant key and 100 free credits, then start calling list_jobs — no human, no dashboard.

Connect the MCP server Read the agent guide