---
title: "Poll batch results"
full: true
_openapi:
  method: GET
  toc: []
  structuredData:
    headings: []
    contents:
      - content: "Returns job status (queued, running, done, failed) and complete per-address evaluation results with list health summary once completed."
_apiData:
  document: "https://reloop.sh/api/tools/openapi/json"
  operationData: [{"path":"/api/tools/v1/email-health-check/batch/{token}","method":"get"}]
  parameterList: [{"name":"token","type":"string","required":true,"description":"The unique batch job token returned from /batch.","location":"path"}]
  responseMap: {"200":{"description":"Response for status 200","schema":{"token":"example_token","status":"queued","createdAt":"2026-03-23T10:00:00.000Z","completedAt":"2026-03-23T10:00:00.000Z","totalUploaded":0,"totalUnique":0,"duplicatesRemoved":0,"results":[{"email":"john.doe@example.com","rowNumber":0,"domain":"send.example.com","verdict":"invalid","isValidSyntax":true,"isDisposable":true,"isRoleAddress":true,"isFreeProvider":true,"mxRecords":["example_mxRecords"],"confidence":0,"riskScore":0,"flags":["example_flags"],"health":{"status":"pass","summary":"example_summary","state":"deliverable","score":0,"reason":"accepted_email","user":"example_user","domain":"send.example.com","tag":"example_tag","attributes":{"free":true,"role":true,"disposable":true,"acceptAll":true,"tag":true,"numericalCharacters":0,"alphabeticalCharacters":0,"unicodeSymbols":0,"mailboxFull":true,"noReply":true,"secureEmailGateway":true},"mailServer":{"smtpProvider":"example_smtpProvider","mxRecord":"example_mxRecord","mxRecords":["example_mxRecords"],"implicitMxRecord":true,"hasMx":true}}}],"summary":{"totalUploaded":0,"totalUnique":0,"duplicatesRemoved":0,"deliverableCount":0,"riskyCount":0,"disposableCount":0,"invalidCount":0,"noMxCount":0,"avgRiskScore":0,"healthyPct":0},"error":"example_error"}},"400":{"description":"Response for status 400","schema":{"message":"Contact already exists","why":"A contact with this email already exists in your organization.","fix":"Use a different email address or update the existing contact instead.","link":"https://reloop.sh/docs/api/contacts"}},"404":{"description":"Response for status 404","schema":{"message":"Contact already exists","why":"A contact with this email already exists in your organization.","fix":"Use a different email address or update the existing contact instead.","link":"https://reloop.sh/docs/api/contacts"}}}
  codeSamples: []
---
> For the complete documentation index, see [llms-docs.txt](/llms-docs.txt) or the site index [llms.txt](/llms.txt). Full docs corpus: [llms-full-docs.txt](/llms-full-docs.txt). Prefer markdown URLs (append `.md`) for agent consumption. Product skill: [skill.md](/skill.md).


{/* This file was generated by the OpenAPI doc generator. Do not edit this file directly. Run `bun run generate:api-docs` to regenerate. */}

<APIPage />