Menu

Blocks API

Blocks happen when your email is rejected because of an issue with the message itself rather than an issue with the recipient's address.

There are several causes for blocked emails. For example, your mail server IP address may be blocked by an ISP, or the receiving server may flag the message content using a filter. Twilio SendGrid will not suppress future messages to blocked addresses by default.

For more information, please see our Blocks documentation.

You can also see your Blocks in the Suppressions settings menu of the Twilio SendGrid App.

Retrieve all blocks

Retrieve all blocks

GET /suppression/blocks

This endpoint allows you to retrieve all email addresses that are currently on your blocks list.

Authentication

  • API Key

Headers

Authorization
string
default: Bearer <<YOUR_API_KEY_HERE>>
required
on-behalf-of
string
default: The subuser's username. This header generates the API call as if the subuser account was making the call.

Query String

start_time
integer

The start of the time range when a blocked email was created (inclusive). This is a unix timestamp.

end_time
integer

The end of the time range when a blocked email was created (inclusive). This is a unix timestamp.

limit
integer

The number of results to return.

offset
integer

The point in the list to begin retrieving results.

Responses

array[object]
created
integer

A Unix timestamp indicating when the email address was added to the blocks list.

email
string

The email address that was added to the block list.

format: email
reason
string

An explanation for the reason of the block.

status
string

The status of the block.

[
  {
    "created": 1443651154,
    "email": "example@example.com",
    "reason": "error dialing remote address: dial tcp 10.57.152.165:25: no route to host",
    "status": "4.0.0"
  }
]

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.