> ## Documentation Index
> Fetch the complete documentation index at: https://resend.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Learn how to view and troubleshoot API logs.

## Overview

Logs are a powerful tool for monitoring activity and troubleshooting issues.

<Tabs>
  <Tab title="Using the dashboard">
    Access your logs from the [Logs page](https://resend.com/logs) in the dashboard.

    <img alt="Logs" src="https://mintcdn.com/resend/jNLP19MmH13tZf-I/images/logs-page.png?fit=max&auto=format&n=jNLP19MmH13tZf-I&q=85&s=c6255bb12281961d20606de92a778b99" width="3360" height="2100" data-path="images/logs-page.png" />

    Each log entry shows:

    * **Endpoint** - The API endpoint called (e.g., `/domains`, `/api-keys`, `/contacts`)
    * **Status** - The HTTP response status code (200, 201, etc.)
    * **Method** - The HTTP method used (GET, POST, DELETE, etc.)
    * **Created** - When the request was made (displayed as relative time)

    ## Searching Logs

    Use the search bar to find specific logs. This is useful when tracking down a particular request or debugging an issue.

    ## Filtering Logs

    Filter logs by response status to quickly identify issues:

    * **All Statuses** - View all logs
    * **Successes** - Show only successful requests (2xx status codes)
    * **Errors** - Show only failed requests (4xx and 5xx status codes)
    * **Specific codes** - Select one or more specific HTTP status codes (200, 201, 403, 429, etc.)

    You can select multiple status codes to create custom filters.

    * **Date range** - Adjust the time period for logs (e.g., Last 15 days)
    * **User Agents** - Filter by SDK or client
    * **API Keys** - Filter by specific API key

    ## Log details

    Click any log entry to view complete details.

    <img alt="Logs" src="https://mintcdn.com/resend/jNLP19MmH13tZf-I/images/logs-page-details.png?fit=max&auto=format&n=jNLP19MmH13tZf-I&q=85&s=dd6d948f384d6b90e8a5bed33ec237f0" width="3360" height="2100" data-path="images/logs-page-details.png" />

    ### Request information

    * **Request body** - The full JSON payload sent to the API (with copyable code blocks)
    * **HTTP method** - GET, POST, etc.
    * **Endpoint** - The API endpoint called
    * **User-Agent** - The client or SDK used, with automatic SDK detection showing name and version

    ### Response information

    * **Response body** - The complete API response (with copyable code blocks)
    * **Status code** - The HTTP status code returned
    * **Timestamp** - When the request was processed

    ### SDK detection

    The dashboard automatically detects and displays Resend SDK information from the User-Agent header, showing:

    * SDK name (e.g., "Resend Node.js")
    * Version number

    ## Troubleshooting errors

    For supported error types, click the **Help me fix** button to open a troubleshooting drawer.

    <img alt="Logs" src="https://mintcdn.com/resend/jNLP19MmH13tZf-I/images/logs-page-error.png?fit=max&auto=format&n=jNLP19MmH13tZf-I&q=85&s=60e6190acbb51c2d97a08f0bac177d74" width="3360" height="2100" data-path="images/logs-page-error.png" />

    The drawer includes:

    * **Raw response** - The complete API response
    * **Detailed guidance** - Step-by-step instructions to resolve the issue
    * **Relevant links** - Documentation and knowledge base articles
    * **Contextual information** - Your current rate limits, verified domains, and other relevant data

    ## Copy for AI

    For error logs (4xx and 5xx status codes), use the **Copy for AI** dropdown to get help debugging:

    * **Copy log** - Copy the log details as Markdown formatted for AI tools
    * **Open in ChatGPT** - Open ChatGPT with the log prefilled for analysis
    * **Open in Claude** - Open Claude with the log prefilled for analysis

    The copied content includes the request method, endpoint, request body, response status, and response body to help AI assistants understand and troubleshoot the issue.
  </Tab>

  <Tab title="Using the API">
    The Logs API allows you to **programmatically retrieve logs**. This is useful for integrating with your own systems, automating tasks, and equipping your AI agents with the ability to troubleshoot issues.

    ## List logs

    Retrieve a list of API request logs.

    The response includes details such as:

    * The **endpoint** called
    * The response **status code**
    * The **user agent**

    <CodeGroup>
      ```ts Node.js theme={"theme":{"light":"github-light","dark":"vesper"}}
      import { Resend } from 'resend';

      const resend = new Resend('re_xxxxxxxxx');

      const { data, error } = await resend.logs.list();
      ```

      ```php PHP theme={"theme":{"light":"github-light","dark":"vesper"}}
      $resend = Resend::client('re_xxxxxxxxx');

      $resend->logs->list();
      ```

      ```python Python theme={"theme":{"light":"github-light","dark":"vesper"}}
      import resend

      resend.api_key = "re_xxxxxxxxx"

      resend.Logs.list()
      ```

      ```ruby Ruby theme={"theme":{"light":"github-light","dark":"vesper"}}
      Resend.api_key = "re_xxxxxxxxx"

      logs = Resend::Logs.list
      puts logs
      ```

      ```go Go theme={"theme":{"light":"github-light","dark":"vesper"}}
      package main

      import (
        "context"

        "github.com/resend/resend-go/v3"
      )

      func main() {
        ctx := context.TODO()
        client := resend.NewClient("re_xxxxxxxxx")

        logs, err := client.Logs.ListWithOptions(ctx, nil)
        if err != nil {
          panic(err)
        }

        if logs.HasMore {
          opts := &resend.ListOptions{
            After: &logs.Data[len(logs.Data)-1].Id,
          }
          client.Logs.ListWithOptions(ctx, opts)
        }
      }
      ```

      ```rust Rust theme={"theme":{"light":"github-light","dark":"vesper"}}
      use resend_rs::{Resend, Result, list_opts::ListOptions};

      #[tokio::main]
      async fn main() -> Result<()> {
        let resend = Resend::new("re_xxxxxxxxx");

        let _logs = resend
          .logs
          .list(ListOptions::default())
          .await?;

        Ok(())
      }
      ```

      ```java Java theme={"theme":{"light":"github-light","dark":"vesper"}}
      import com.resend.*;

      public class Main {
          public static void main(String[] args) {
              Resend resend = new Resend("re_xxxxxxxxx");

              resend.logs().list();
          }
      }
      ```

      ```csharp .NET theme={"theme":{"light":"github-light","dark":"vesper"}}
      // C# SDK is not available yet
      ```

      ```bash cURL theme={"theme":{"light":"github-light","dark":"vesper"}}
      curl -X GET 'https://api.resend.com/logs' \
          -H 'Authorization: Bearer re_xxxxxxxxx'
      ```

      ```bash CLI theme={"theme":{"light":"github-light","dark":"vesper"}}
      resend logs list
      ```
    </CodeGroup>

    ## Retrieve log

    Once you're ready to inspect a log in greater detail, you can use the [Retrieve Log](/api-reference/logs/retrieve-log) endpoint.

    This endpoint returns the full request body and response, as well as the endpoint, status code, and user agent.

    <CodeGroup>
      ```ts Node.js theme={"theme":{"light":"github-light","dark":"vesper"}}
      import { Resend } from 'resend';

      const resend = new Resend('re_xxxxxxxxx');

      const { data, error } = await resend.logs.get(
        '37e4414c-5e25-4dbc-a071-43552a4bd53b',
      );
      ```

      ```php PHP theme={"theme":{"light":"github-light","dark":"vesper"}}
      $resend = Resend::client('re_xxxxxxxxx');

      $resend->logs->get('37e4414c-5e25-4dbc-a071-43552a4bd53b');
      ```

      ```python Python theme={"theme":{"light":"github-light","dark":"vesper"}}
      import resend

      resend.api_key = "re_xxxxxxxxx"

      resend.Logs.get("37e4414c-5e25-4dbc-a071-43552a4bd53b")
      ```

      ```ruby Ruby theme={"theme":{"light":"github-light","dark":"vesper"}}
      Resend.api_key = "re_xxxxxxxxx"

      log = Resend::Logs.get("37e4414c-5e25-4dbc-a071-43552a4bd53b")
      puts log
      ```

      ```go Go theme={"theme":{"light":"github-light","dark":"vesper"}}
      package main

      import "github.com/resend/resend-go/v3"

      func main() {
        client := resend.NewClient("re_xxxxxxxxx")

        client.Logs.Get("37e4414c-5e25-4dbc-a071-43552a4bd53b")
      }
      ```

      ```rust Rust theme={"theme":{"light":"github-light","dark":"vesper"}}
      use resend_rs::{Resend, Result};

      #[tokio::main]
      async fn main() -> Result<()> {
        let resend = Resend::new("re_xxxxxxxxx");

        let _logs = resend
          .logs
          .get("37e4414c-5e25-4dbc-a071-43552a4bd53b")
          .await?;

        Ok(())
      }
      ```

      ```java Java theme={"theme":{"light":"github-light","dark":"vesper"}}
      import com.resend.*;

      public class Main {
          public static void main(String[] args) {
              Resend resend = new Resend("re_xxxxxxxxx");

              resend.logs().get("37e4414c-5e25-4dbc-a071-43552a4bd53b");
          }
      }
      ```

      ```csharp .NET theme={"theme":{"light":"github-light","dark":"vesper"}}
      // C# SDK is not available yet
      ```

      ```bash cURL theme={"theme":{"light":"github-light","dark":"vesper"}}
      curl -X GET 'https://api.resend.com/logs/37e4414c-5e25-4dbc-a071-43552a4bd53b' \
          -H 'Authorization: Bearer re_xxxxxxxxx'
      ```

      ```bash CLI theme={"theme":{"light":"github-light","dark":"vesper"}}
      resend logs get 37e4414c-5e25-4dbc-a071-43552a4bd53b
      ```
    </CodeGroup>
  </Tab>
</Tabs>

***

<Note>
  View a comprehensive list of error codes and their meanings in the [Resend API
  Reference](/api-reference/errors).
</Note>

## Export your data

Admins can download your data in CSV format for the following resources:

* Emails
* Broadcasts
* Contacts
* Segments
* Domains
* Logs
* API keys

<Info>Currently, exports are limited to admin users of your team.</Info>

To start, apply filters to your data and click on the "Export" button. Confirm your filters before exporting your data.

<video autoPlay muted loop playsinline className="w-full aspect-video" src="https://mintcdn.com/resend/OWNnQaVDyqcGyhhN/images/exports.mp4?fit=max&auto=format&n=OWNnQaVDyqcGyhhN&q=85&s=1149ee4e83b4414e75a0ecaa92774c38" data-path="images/exports.mp4" />

If your exported data includes 1,000 items or less, the export will download immediately. For larger exports, you'll receive an email with a link to download your data.

All admins on your team can securely access the export for 7 days. Unavailable exports are marked as "Expired."

<Note>
  All exports your team creates are listed in the
  [Exports](https://resend.com/exports) page under **Settings** > **Team** >
  **Exports**. Select any export to view its details page. All members of your
  team can view your exports, but only admins can download the data.
</Note>