Retrieve a list of received emails

GET/emails/receivingRetrieve a list of received emails

Parameters

limitintegerquery

Maximum number of received emails to return.

afterstring · uuidquery

Pagination cursor to fetch results after this email ID. Cannot be used with 'before'.

beforestring · uuidquery

Pagination cursor to fetch results before this email ID. Cannot be used with 'after'.

Responses

objectListReceivedEmailsResponse

dataarray of object

Array containing received email information.

Show child attributes

Show array items

attachmentsarray of object

Array of attachments for this email.

Show child attributes

Show array items

content_dispositionstring

How the attachment should be displayed.

one of "inline", "attachment"

content_idstring

The content ID for inline attachments.

content_typestring

The MIME type of the attachment.

filenamestring

The filename of the attachment.

idstring · uuid

The ID of the attachment.

sizeinteger

Size of the attachment in bytes.

bccarray of string

The BCC recipients.

Show child attributes

ccarray of string

The CC recipients.

Show child attributes

created_atstring · date-time

Timestamp when the email was received.

fromstring

The sender email address.

idstring · uuid

The ID of the received email.

message_idstring

The unique message ID from the email headers.

reply_toarray of string

The reply-to addresses.

Show child attributes

subjectnull | string

The email subject.

toarray of string

The recipient email addresses.

Show child attributes

has_moreboolean

Indicates if there are more results available.

objectstring

Type of the response object.

Example response

{
  "data": [
    {
      "attachments": [
        {
          "content_disposition": "attachment",
          "content_id": "string",
          "content_type": "string",
          "filename": "string",
          "id": "00000000-0000-0000-0000-000000000000",
          "size": 0
        }
      ],
      "bcc": [
        "string"
      ],
      "cc": [
        "string"
      ],
      "created_at": "2023-10-06T23:47:56.678Z",
      "from": "sender@example.com",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "message_id": "<message-id@example.com>",
      "reply_to": [
        "string"
      ],
      "subject": "Hello World",
      "to": [
        "delivered@resend.dev"
      ]
    }
  ],
  "has_more": false,
  "object": "list"
}

Examples

limitquery parameter

afterquery parameter

beforequery parameter

curl -X GET 'https://api.resend.com/emails/receiving?after=00000000-0000-0000-0000-000000000000&before=00000000-0000-0000-0000-000000000000&limit=0'

const response = await fetch('https://api.resend.com/emails/receiving?after=00000000-0000-0000-0000-000000000000&before=00000000-0000-0000-0000-000000000000&limit=0', { method: 'GET' });
const data = await response.json();

const response = await fetch('https://api.resend.com/emails/receiving?after=00000000-0000-0000-0000-000000000000&before=00000000-0000-0000-0000-000000000000&limit=0', { method: 'GET' });
console.log(await response.json());

import requests

response = requests.request("GET", "https://api.resend.com/emails/receiving?after=00000000-0000-0000-0000-000000000000&before=00000000-0000-0000-0000-000000000000&limit=0")
print(response.json())

package main

import (
	"context"
	"net/http"
)

func main() {
	ctx := context.Background()
	req, err := http.NewRequestWithContext(ctx, "GET", "https://api.resend.com/emails/receiving?after=00000000-0000-0000-0000-000000000000&before=00000000-0000-0000-0000-000000000000&limit=0", nil)
	if err != nil {
		panic(err)
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

<?php
$request = curl_init("https://api.resend.com/emails/receiving?after=00000000-0000-0000-0000-000000000000&before=00000000-0000-0000-0000-000000000000&limit=0");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("https://api.resend.com/emails/receiving?after=00000000-0000-0000-0000-000000000000&before=00000000-0000-0000-0000-000000000000&limit=0"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://api.resend.com/emails/receiving?after=00000000-0000-0000-0000-000000000000&before=00000000-0000-0000-0000-000000000000&limit=0")
request = Net::HTTPGenericRequest.new("GET", false, true, uri)
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.resend.com/emails/receiving?after=00000000-0000-0000-0000-000000000000&before=00000000-0000-0000-0000-000000000000&limit=0");
using var response = await client.SendAsync(request);

{
  "data": [
    {
      "attachments": [
        {
          "content_disposition": "attachment",
          "content_id": "string",
          "content_type": "string",
          "filename": "string",
          "id": "00000000-0000-0000-0000-000000000000",
          "size": 0
        }
      ],
      "bcc": [
        "string"
      ],
      "cc": [
        "string"
      ],
      "created_at": "2023-10-06T23:47:56.678Z",
      "from": "sender@example.com",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "message_id": "<message-id@example.com>",
      "reply_to": [
        "string"
      ],
      "subject": "Hello World",
      "to": [
        "delivered@resend.dev"
      ]
    }
  ],
  "has_more": false,
  "object": "list"
}

Search documentation

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys

Retrieve a list of received emails

Parameters

Responses

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys