Get Bulk Email Address Validation Jobs Positive Feedback Negative Feedback Positive Feedback Negative Feedback Email Address Validation is available to Email API Pro and Premier level accounts only. An Email Validation API key is required. See the Email Address Validation overview page for more information .
The Email Address Validation API provides detailed information about the validity of email addresses, which helps you create and maintain contact lists and reduce bounce rates.
The Bulk Email Address Validation API facilitates the asynchronous validation of up to one million email addresses.
With the Bulk Email Address Validation API, you can:
Positive Feedback Negative Feedback GET /v3/validations/email/jobs Base url: https://api.sendgrid.com (The Twilio SendGrid v3 API) This endpoint returns a list of all of a user's Bulk Email Validation Jobs.
Positive Feedback Negative Feedback Positive Feedback Negative Feedback Positive Feedback Negative Feedback The request was successful. The response contains a list of all of your Bulk Email Validation Jobs.
Property name Type Required Description Child properties
result array[object]
Show child properties
for result Property name Type Required Description Child properties
id string
The unique ID of the Bulk Email Address Validation Job.
status enum<string>
The status of the Bulk Email Address Validation Job.
Possible values: InitiatedQueuedReadyProcessingDoneError
started_at number
The ISO8601 timestamp when the Job was created. This is the time at which the upload request was sent to the upload_uri.
finished_at number
The ISO8601 timestamp when the Job was finished.
{
"result" : [
{
"id" : "01HV9ZZQAFEXW18KFEPTB9YD5E" ,
"status" : "Queued" ,
"started_at" : 1712954639 ,
"finished_at" : 0
}
]
}
Property name Type Required Description Child properties
errors array[object]
Show child properties
for errors Property name Type Required Description Child properties
message string
The message representing the error from the API.
field string
The field associated with the error.
help object
Helper text or docs for troubleshooting.
id string
ID representing the error.
{
"errors" : [
{
"message" : "error message"
}
]
}
Property name Type Required Description Child properties
errors array[object]
Show child properties
for errors Property name Type Required Description Child properties
message string
The message representing the error from the API.
field string
The field associated with the error.
help object
Helper text or docs for troubleshooting.
id string
ID representing the error.
1 const client = require ( '@sendgrid/client' );
2 client. setApiKey (process.env. SENDGRID_API_KEY );
6 url: `/v3/validations/email/jobs` ,
12 . then (([ response , body ]) => {
13 console. log (response.statusCode);
14 console. log (response.body);