Email Validation
Get List Status
Get the current progress of a deliverable list
GET
Get deliverable list progress
Authorizations
API key for authentication
Path Parameters
List ID
Response
Successfully retrieved list progress
List ID
Example:
12345
Current list status
Available options:
pending, processing, completed, failed Example:
"processing"
Processing progress percentage
Required range:
0 <= x <= 100Example:
75
Total number of emails in list
Example:
1000
Number of emails processed
Example:
750
Estimated completion time
Example:
"2024-01-15T10:30:00Z"
Previous
Get List ResultsRetrieve the verification results for a completed deliverable list. Results are paginated — pass `page` and `limit` as query parameters to control which slice of data you receive.
To retrieve all results, start at page 1 and keep incrementing the page number until `metadata.has_more` is `false`.
**Example pagination loop:**
1. `GET /validate/deliverable/{listId}/results?page=1&limit=100`
2. Check `metadata.has_more` in the response.
3. If `true`, request the next page: `?page=2&limit=100`
4. Repeat until `has_more` is `false`.
Next
Get deliverable list progress
