---
search:
  tags:
    - Emails
    - GET
seo:
  description: >-
    Get opens by mail client. Reference for the GET /emails/metrics/clients
    endpoint in the BillionSend API.
sidebar:
  label: Get opens by mail client
  badge: GET
title: Get opens by mail client
type: openapi-operation
---
`GET /emails/metrics/clients`

**Responses**

- `200` — Opens in the range by the mail client that fetched the message's images, most opened first (BillionSend extension). \`client\` is one of \`gmail\`, \`apple\_mail\`, \`outlook\`, \`yahoo\`, \`thunderbird\`, \`other\` (a web browser, which webmail and clients without markers look like) or \`unknown\` (no user agent). Clicks are not counted by client: a click arrives from the browser the client hands the link to. Only the client is kept, never the user agent. Counts cover whole UTC hours like GET /emails/metrics, and opens are counted by client from 2026-11-16 on. A key held to one domain always reads that domain only.
- `401` — Missing, malformed, unknown or revoked API key
- `403` — Restricted API key: a sending\_access key, or a key held to one domain that named another domain in domain\_id
- `422` — Validation error
- `429` — Over the rate limit (rate\_limit\_exceeded, with Retry-After)
- `503` — The statistics store is not answering; sending is unaffected. Retry shortly.

Response example, 200:

```json
{
  "object": "list",
  "start_date": "string",
  "end_date": "string",
  "has_more": true,
  "data": [
    {
      "client": "gmail",
      "opened": 0,
      "unique_opened": 0,
      "bot_opened": 0
    }
  ]
}
```
