Skip to content Skip to navigation Skip to topbar

Get a Bulk Email Address Validation Job by ID

API Overview

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:

Request an upload URL for the email list you wish to verify.
Get all Bulk Email Address Validation Jobs.
Get a specific Bulk Email Address Validation Job.
This API reference page should be used in conjunction with the Email Address Validation Overview page and the Bulk Email Validation Integration Guide .

Operation overview

GET/v3/validations/email/jobs/{job_id}

Base url: https://api.sendgrid.com

This endpoint returns a specific Bulk Email Validation Job. You can use this endpoint to check on the progress of a Job.

Operation details

Authentication

API Key

Headers

Property nameTypeRequiredDescription

Authorizationstringrequired

Default: Bearer <<YOUR_API_KEY_HERE>>

Path parameters

Property nameTypeRequiredDescription

job_idstringrequired

The ID of the Bulk Email Address Validation Job you wish to retrieve.

Responses

200404500

SchemaExample

Property nameTypeRequiredDescriptionChild properties

resultobject

Show child properties for result

SchemaExample

Property nameTypeRequiredDescriptionChild properties

errorsarray[object]

Show child properties for errors

idstring

ID representing the error.

Get a specific bulk email address validation job by ID

Node.js

Python

Java

PHP

Ruby

curl


_19const client = require('@sendgrid/client');
_19client.setApiKey(process.env.SENDGRID_API_KEY);
_19
_19const job_id = "ZGkrHSypTsudrGkmdpJJ";
_19
_19const request = {
_19  url: `/v3/validations/email/jobs/${job_id}`,
_19  method: 'GET',
_19  
_19}
_19
_19client.request(request)
_19  .then(([response, body]) => {
_19    console.log(response.statusCode);
_19    console.log(response.body);
_19  })
_19  .catch(error => {
_19    console.error(error);
_19  });