For the complete documentation index, see llms-docs.txt or the site index llms.txt. Full docs corpus: llms-full-docs.txt. Prefer the markdown version of this page at /docs/api/tools/get-api-tools-v1email-health-check-batch-by-token.md. Product capabilities: skill.md. Docs MCP: /docs/mcp. Site MCP: /mcp.

Poll batch results

GET
/api/tools/v1/email-health-check/batch/:token
1const response = await fetch("https://reloop.sh/api/tools/v1/email-health-check/batch/{token}", {
2 method: "GET",
3 headers: {
4 "Authorization": "Bearer re_123456789",
5 },
6});
7
8const data = await response.json();
1{
2 "token": "example_token",
3 "status": "queued",
4 "createdAt": "2026-03-23T10:00:00.000Z",
5 "completedAt": "2026-03-23T10:00:00.000Z",
6 "totalUploaded": 0,
7 "totalUnique": 0,
8 "duplicatesRemoved": 0,
9 "results": [
10 {
11 "email": "john.doe@example.com",
12 "rowNumber": 0,
13 "domain": "send.example.com",
14 "verdict": "invalid",
15 "isValidSyntax": true,
16 "isDisposable": true,
17 "isRoleAddress": true,
18 "isFreeProvider": true,
19 "mxRecords": [
20 "example_mxRecords"
21 ],
22 "confidence": 0,
23 "riskScore": 0,
24 "flags": [
25 "example_flags"
26 ],
27 "health": {
28 "status": "pass",
29 "summary": "example_summary",
30 "state": "deliverable",
31 "score": 0,
32 "reason": "accepted_email",
33 "user": "example_user",
34 "domain": "send.example.com",
35 "tag": "example_tag",
36 "attributes": {
37 "free": true,
38 "role": true,
39 "disposable": true,
40 "acceptAll": true,
41 "tag": true,
42 "numericalCharacters": 0,
43 "alphabeticalCharacters": 0,
44 "unicodeSymbols": 0,
45 "mailboxFull": true,
46 "noReply": true,
47 "secureEmailGateway": true
48 },
49 "mailServer": {
50 "smtpProvider": "example_smtpProvider",
51 "mxRecord": "example_mxRecord",
52 "mxRecords": [
53 "example_mxRecords"
54 ],
55 "implicitMxRecord": true,
56 "hasMx": true
57 }
58 }
59 }
60 ],
61 "summary": {
62 "totalUploaded": 0,
63 "totalUnique": 0,
64 "duplicatesRemoved": 0,
65 "deliverableCount": 0,
66 "riskyCount": 0,
67 "disposableCount": 0,
68 "invalidCount": 0,
69 "noMxCount": 0,
70 "avgRiskScore": 0,
71 "healthyPct": 0
72 },
73 "error": "example_error"
74}

Path Parameters

tokenstringRequired

The unique batch job token returned from /batch.

Was this page helpful?