# README
Go API client for
The Twilio SendGrid Email Address Validation API provides real-time detailed information on the validity of email addresses. You can integrate this validation process into your platform's signup form and customize the best use of email address validation for your use case.
Email Address Validation is available to Email API Pro and Premier level accounts only. Prior to upgrading your account to Pro or Premier, you will not see the option to create an Email Validation API key. An Email Validation API key is separate from and in addition to your other keys, including Full Access API keys.
You can use this API to:
- Indicate to users that the address they have entered into a form is invalid.
- Drop invalid email addresses from your database.
- Suppress invalid email addresses from your sending to decrease your bounce rate.
See Email Address Validation for more information.
You can also view your Email Validation results and metrics in the Validation section of the Twilio SendGrid application user interface.
Overview
This API client was generated by the OpenAPI Generator project from the OpenAPI specs located at twilio/sendgrid-oai. By using the OpenAPI-spec from a remote server, you can easily generate an API client.
- API version: 1.0.0
- Package version:
- Build date: 2025-08-18T08:58:25.489242Z[Etc/UTC]
- Build package: com.sendgrid.oai.go.SendgridGoGenerator For more information, please visit https://support.sendgrid.com/hc/en-us
Installation
Install the following dependencies:
go get github.com/stretchr/testify/assert
go get golang.org/x/net/context
Put the package under your project folder and add the following in import:
import "./"
Documentation for API Endpoints
All URIs are relative to https://api.sendgrid.com
Class | Method | HTTP request | Description |
---|---|---|---|
GetEmailJobForVerification | GetEmailJobForVerification | Get /v3/validations/email/jobs/{JobId} | This request returns a single Bulk Email Validation Job. |
GetValidationsEmailJobs | GetValidationsEmailJobs | Get /v3/validations/email/jobs | This request lists all of a user's Bulk Email Validation Jobs. |
ListEmailJobForVerification | ListEmailJobForVerification | Put /v3/validations/email/jobs | Request a presigned URL and headers for Bulk Email Address Validation list upload. |
ValidateEmail | ValidateEmail | Post /v3/validations/email | Validate an email |
Documentation For Models
- ErrorResponse
- ErrorResponseErrorsInner
- FileType
- GetValidationsEmailJobs200Response
- GetValidationsEmailJobs200ResponseResultInner
- GetValidationsEmailJobsJobId200Response
- GetValidationsEmailJobsJobId200ResponseResult
- GetValidationsEmailJobsJobId200ResponseResultErrorsInner
- ListEmailJobForVerificationRequest
- PutValidationsEmailJobs200Response
- PutValidationsEmailJobs200ResponseUploadHeadersInner
- Status
- Status1
- ValidateEmail200Response
- ValidateEmail200ResponseResult
- ValidateEmail200ResponseResultChecks
- ValidateEmail200ResponseResultChecksAdditional
- ValidateEmail200ResponseResultChecksDomain
- ValidateEmail200ResponseResultChecksLocalPart
- ValidateEmailRequest
- Verdict
Documentation For Authorization
BearerAuth
- Type: HTTP basic authentication
Example
auth := context.WithValue(context.Background(), sw.ContextBasicAuth, sw.BasicAuth{
UserName: "username",
Password: "password",
})
r, err := client.Service.Operation(auth, args)