---
title: "Return send metrics by domain or sender"
method: GET
path: "/v3/metrics/send"
tags: ["Send events"]
---

# Return send metrics by domain or sender

`GET /v3/metrics/send`

## Request

- Base URL: `https://api.us.nylas.com`
- URL: `https://api.us.nylas.com/v3/metrics/send`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nylas/apis/nylas-api/docs/v3/metrics/send/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns send counts and rates grouped by sending domain, sender address, or recipient domain.
Use it to find which of your domains or Agent Accounts has the highest bounce rate, or which
mailbox provider is rejecting your mail. Rows are sorted by sent volume by default.

## Query parameters

- `group_by` 'sending_domain' | 'agent_account' | 'recipient_domain'
- `sort` string
- `limit` integer
- `start` string, date
- `end` string, date
- `sending_domain` string

## Response `200`

Success. Returns one row per group.

- object
  - `request_id` string: The request ID.
  - `data` SendBreakdown
    - `group_by` 'sending_domain' | 'agent_account' | 'recipient_domain': What the rows are grouped by.
    - `window` Window: A date window. Both days are UTC dates and both are included.
      - `start` string, date: The first day of the window.
      - `end` string, date: The last day of the window.
    - `rows` object[]: One row per group, sorted by `sort`.
      - `key` string: The sending domain, sender email address, or recipient domain. `(others)` for the combined row.
      - `sent` integer: The number of messages Nylas accepted for delivery.
      - `delivered` integer: The number of messages the recipient's mail server accepted.
      - `bounced_hard` integer: The number of permanent bounces.
      - `complaints` integer: The number of recipients who marked the message as spam.
      - `delivery_rate` number, nullable: Delivered messages as a percentage of sent messages.
      - `bounce_rate` number, nullable: Hard bounces as a percentage of sent messages.
      - `complaint_rate` number, nullable: Complaints as a percentage of delivered messages.
      - `is_others` boolean: `true` for the final row that combines every group past `limit`.

## Other responses

- `400`: Bad request. A query parameter or the request body isn't valid.
- `401`: Unauthorized
- `403`: Forbidden. These endpoints need your application's API key, not a grant access token.

## Changes

- **2026-10-30** `7b9fe7c66c1c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nylas/apis/nylas-api/changes/v3/metrics/send/get.md)

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) - [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nylas/apis/nylas-api/revisions/7782a3e3ab70?raw)