{ "info": { "_postman_id": "a5c3d21d-3a65-40b2-ba1a-f980f0d526ca", "name": "Twilio SendGrid Email Address Validation API", "description": "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.\n\nEmail Address Validation is available to [Email API Pro and Premier level accounts](https://sendgrid.com/pricing) 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.\n\nYou can use this API to:\n- Indicate to users that the address they have entered into a form is invalid.\n- Drop invalid email addresses from your database.\n- Suppress invalid email addresses from your sending to decrease your bounce rate.\n\nSee [**Email Address Validation**](https://docs.sendgrid.com/ui/managing-contacts/email-address-validation) for more information.\n\nYou can also view your Email Validation results and metrics in the Validation section of the [Twilio SendGrid application user interface](https://docs.sendgrid.com/ui/managing-contacts/email-address-validation).\n\nContact Support:\n Name: Twilio SendGrid Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-06-05T15:16:35.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "lastUpdatedBy": "35240", "uid": "35240-a5c3d21d-3a65-40b2-ba1a-f980f0d526ca" }, "item": [ { "name": "v3", "item": [ { "name": "validations", "item": [ { "name": "email", "item": [ { "name": "jobs", "item": [ { "name": "{job_id}", "item": [ { "name": "This request returns a single Bulk Email Validation Job.", "id": "ca982f24-f183-427d-bd96-0600c0bd0f82", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs/:job_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs", ":job_id" ], "variable": [ { "id": "b3c2b05e-c0b0-4698-8068-c9e32c28261c", "key": "job_id", "value": "", "description": "(Required) The ID of the Bulk Email Address Validation Job you wish to retrieve." } ] }, "description": "**This endpoint returns a specific Bulk Email Validation Job. You can use this endpoint to check on the progress of a Job.**\n" }, "response": [ { "id": "d527e66b-2f58-4db3-bff1-d38428a234d0", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs/:job_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs", ":job_id" ], "variable": [ { "key": "job_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"result\": {\n \"id\": \"\",\n \"status\": \"Ready\",\n \"segments\": \"\",\n \"segments_processed\": \"\",\n \"is_download_available\": \"\",\n \"started_at\": \"\",\n \"finished_at\": \"\",\n \"errors\": [\n {\n \"message\": \"\"\n },\n {\n \"message\": \"\"\n }\n ]\n }\n}", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-d527e66b-2f58-4db3-bff1-d38428a234d0" }, { "id": "c42f428e-c413-4145-a169-f4138a9edfd7", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs/:job_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs", ":job_id" ], "variable": [ { "key": "job_id" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-c42f428e-c413-4145-a169-f4138a9edfd7" }, { "id": "56cb96f9-8d4b-444a-ac97-1e22c096ecca", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs/:job_id", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs", ":job_id" ], "variable": [ { "key": "job_id" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-56cb96f9-8d4b-444a-ac97-1e22c096ecca" } ], "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-ca982f24-f183-427d-bd96-0600c0bd0f82" } ], "id": "e01249bf-9127-4483-acca-15c10119a976", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-e01249bf-9127-4483-acca-15c10119a976" }, { "name": "Request a presigned URL and headers for Bulk Email Address Validation list upload.", "id": "be4c094d-5de2-42ed-a59e-c455d911d1fa", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"file_type\": \"zip\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs" ] }, "description": "**This endpoint returns a presigned URL and request headers. Use this information to upload a list of email addresses for verification.**\n\nNote that in a successful response the `content-type` header value matches the provided `file_type` parameter in the `PUT` request.\n\nOnce you have an `upload_uri` and the `upload_headers`, you're ready to upload your email address list for verification. For the expected format of the email address list and a sample upload request, see the [Bulk Email Address Validation Overview page](https://www.twilio.com/docs/sendgrid/ui/managing-contacts/email-address-validation/bulk-email-address-validation-overview).\n" }, "response": [ { "id": "ca37c904-cc3f-4242-9863-cf637f82a203", "name": "The request was successful. The response contains the URI and headers where you will upload your email address list.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"file_type\": \"zip\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"job_id\": \"\",\n \"upload_uri\": \"\",\n \"upload_headers\": [\n {\n \"header\": \"\",\n \"value\": \"\"\n },\n {\n \"header\": \"\",\n \"value\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-ca37c904-cc3f-4242-9863-cf637f82a203" }, { "id": "87fd31a9-1e9e-4b16-aaa5-89f05106948e", "name": "Bad request. Invalid or missing `file_type` or malformed request.", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"file_type\": \"zip\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-87fd31a9-1e9e-4b16-aaa5-89f05106948e" }, { "id": "261032e8-86b6-4cea-a063-bb908d95a5e8", "name": "response", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"file_type\": \"zip\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-261032e8-86b6-4cea-a063-bb908d95a5e8" } ], "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-be4c094d-5de2-42ed-a59e-c455d911d1fa" }, { "name": "This request lists all of a user's Bulk Email Validation Jobs.", "id": "a24adbe5-5cdf-48a5-a7c9-eeada24aa672", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs" ] }, "description": "**This endpoint returns a list of all of a user's Bulk Email Validation Jobs.**" }, "response": [ { "id": "ec45e06a-badf-4b5f-8d96-34c788541e50", "name": "The request was successful. The response contains a list of all of your Bulk Email Validation Jobs.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"result\": [\n {\n \"id\": \"\",\n \"status\": \"Initiated\",\n \"started_at\": \"\",\n \"finished_at\": \"\"\n },\n {\n \"id\": \"\",\n \"status\": \"Error\",\n \"started_at\": \"\",\n \"finished_at\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-ec45e06a-badf-4b5f-8d96-34c788541e50" }, { "id": "6038494f-771e-479b-86d0-4416bba9b2ea", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs" ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-6038494f-771e-479b-86d0-4416bba9b2ea" }, { "id": "52d9d158-f713-4741-976e-911c26c4acef", "name": "response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/v3/validations/email/jobs", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email", "jobs" ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n },\n {\n \"message\": \"\",\n \"field\": \"\",\n \"help\": {}\n }\n ],\n \"id\": \"\"\n}", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-52d9d158-f713-4741-976e-911c26c4acef" } ], "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-a24adbe5-5cdf-48a5-a7c9-eeada24aa672" } ], "id": "d7c2256a-cf17-4a3c-8ba2-992b9a2493f3", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-d7c2256a-cf17-4a3c-8ba2-992b9a2493f3" }, { "name": "Validate an email", "id": "2a713248-00b0-497b-8484-ea29f07be87f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"source\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/validations/email", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email" ] }, "description": "**This endpoint allows you to validate an email address.**" }, "response": [ { "id": "b474122f-8554-4391-b6e0-1e5aed395534", "name": "response", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"email\": \"\",\n \"source\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v3/validations/email", "host": [ "{{baseUrl}}" ], "path": [ "v3", "validations", "email" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"result\": {\n \"email\": \"\",\n \"verdict\": \"Invalid\",\n \"score\": \"\",\n \"local\": \"\",\n \"host\": \"\",\n \"checks\": {\n \"domain\": {\n \"has_valid_address_syntax\": \"\",\n \"has_mx_or_a_record\": \"\",\n \"is_suspected_disposable_address\": \"\"\n },\n \"local_part\": {\n \"is_suspected_role_address\": \"\"\n },\n \"additional\": {\n \"has_known_bounces\": \"\",\n \"has_suspected_bounces\": \"\"\n }\n },\n \"ip_address\": \"\",\n \"suggestion\": \"\",\n \"source\": \"\"\n }\n}", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-b474122f-8554-4391-b6e0-1e5aed395534" } ], "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-2a713248-00b0-497b-8484-ea29f07be87f" } ], "id": "ab61097d-c9ac-4f09-a084-34cf443f4d7f", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-ab61097d-c9ac-4f09-a084-34cf443f4d7f" } ], "id": "9653c5d9-a1fc-48f2-a9f5-07fc1e09ca4f", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-9653c5d9-a1fc-48f2-a9f5-07fc1e09ca4f" } ], "id": "835ae1b2-ab7e-44f4-b59f-53d9fedb9937", "createdAt": "2026-06-05T15:16:36.000Z", "updatedAt": "2026-06-05T15:16:36.000Z", "uid": "35240-835ae1b2-ab7e-44f4-b59f-53d9fedb9937" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.sendgrid.com" } ] }