Retrieve a list of emails

GET/emailsRetrieve a list of emails

Parameters

limitintegerquery

Number of items to return.

maximum 100 · minimum 1

afterstringquery

Return items after this cursor.

beforestringquery

Return items before this cursor.

Responses

objectListEmailsResponse

dataarray of object

Array containing email information.

Show child attributes

Show array items

bccarray of string

The email addresses of the blind carbon copy recipients.

Show child attributes

ccarray of string

The email addresses of the carbon copy recipients.

Show child attributes

created_atstring · date-time

The date and time the email was created.

fromstring

The email address of the sender.

htmlstring

The HTML body of the email.

idstring

The ID of the email.

last_eventstring

The status of the email.

objectstring

The type of object.

reply_toarray of string

The email addresses to which replies should be sent.

Show child attributes

subjectstring

The subject line of the email.

textstring

The plain text body of the email.

toarray of string

Show child attributes

has_moreboolean

Indicates if there are more results available.

objectstring

Type of the response object.

Example response

{
  "data": [
    {
      "bcc": [
        "string"
      ],
      "cc": [
        "string"
      ],
      "created_at": "2023-04-03T22:13:42.674981+00:00",
      "from": "Acme <onboarding@resend.dev>",
      "html": "Congrats on sending your <strong>first email</strong>!",
      "id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
      "last_event": "delivered",
      "object": "email",
      "reply_to": [
        "string"
      ],
      "subject": "Hello World",
      "text": "string",
      "to": [
        "delivered@resend.dev"
      ]
    }
  ],
  "has_more": false,
  "object": "list"
}

Examples

limitquery parameter

afterquery parameter

beforequery parameter

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

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

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

import requests

response = requests.request("GET", "https://api.resend.com/emails?after=string&before=string&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?after=string&before=string&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?after=string&before=string&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?after=string&before=string&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?after=string&before=string&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?after=string&before=string&limit=0");
using var response = await client.SendAsync(request);

{
  "data": [
    {
      "bcc": [
        "string"
      ],
      "cc": [
        "string"
      ],
      "created_at": "2023-04-03T22:13:42.674981+00:00",
      "from": "Acme <onboarding@resend.dev>",
      "html": "Congrats on sending your <strong>first email</strong>!",
      "id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
      "last_event": "delivered",
      "object": "email",
      "reply_to": [
        "string"
      ],
      "subject": "Hello World",
      "text": "string",
      "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 emails

Parameters

Responses

Emails

Domains

Audiences

Contacts

Receiving Emails

Webhooks

Templates

Broadcasts

Segments

Topics

Contact Properties

Logs

Automations

Events

API keys