Completed Steps Positive Feedback Negative Feedback Positive Feedback Negative Feedback The Sender Verification API exposes multiple endpoints that allow you to programmatically manage the Sender Identities that are authorized to send email for your account. You can also manage Sender Identities in the SendGrid app by selecting Sender Authentication under Settings in the navigation bar(link takes you to an external page) Sender Verification .
The Sender Verification API provides a RESTful interface for creating new Sender Identities, retrieving a list of existing Sender Identities, checking the status of a Sender Identity, updating a Sender Identity, and deleting a Sender Identity.
This API offers additional endpoints to check for domains known to implement DMARC, and resend verification emails to Sender Identities that have yet to complete the verification process.
Positive Feedback Negative Feedback GET /v3/verified_senders/steps_completed Base url: https://api.sendgrid.com (for global users and subusers) Base url: https://api.eu.sendgrid.com (for EU regional subusers) This endpoint allows you to determine which of SendGrid’s verification processes have been completed for an account .
This endpoint returns boolean values, true and false, for Domain Authentication , domain_verified, and Single Sender Verification , sender_verified, for the account.
An account may have one, both, or neither verification steps completed. If you need to authenticate a domain rather than a Single Sender, see the "Authenticate a domain" endpoint.
Positive Feedback Negative Feedback Positive Feedback Negative Feedback Positive Feedback Negative Feedback Property name Type Required Description Child properties
results object
Show child properties
for results Property name Type Required Description Child properties
{
"results" : {
"domain_verified" : true ,
"sender_verified" : true
}
}
Property name Type Required Description Child properties
errors array[object]
Show child properties
for errors Property name Type Required Description Child properties
field string or null
When applicable, this property value will be the field that generated the error.
help object
When applicable, this property value will be helper text or a link to documentation to help you troubleshoot the error.
id string
When applicable, this property value will be an error ID.
{
"errors" : [
{
"field" : "field_name" ,
"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
field string or null
When applicable, this property value will be the field that generated the error.
help object
When applicable, this property value will be helper text or a link to documentation to help you troubleshoot the error.
id string
When applicable, this property value will be an error ID.
{
"errors" : [
{
"field" : "field_name" ,
"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
field string or null
When applicable, this property value will be the field that generated the error.
help object
When applicable, this property value will be helper text or a link to documentation to help you troubleshoot the error.
id string
When applicable, this property value will be an error ID.
{
"errors" : [
{
"field" : "field_name" ,
"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
1 const client = require ( "@sendgrid/client" );
2 client. setApiKey (process.env. SENDGRID_API_KEY );
5 url: `/v3/verified_senders/steps_completed` ,
11 . then (([ response , body ]) => {
12 console. log (response.statusCode);
13 console. log (response.body);