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

**Responses**

- `200` — Opens and clicks in the range by the country the reader's address is registered in, most engaged first (BillionSend extension). \`country\` is an ISO 3166-1 alpha-2 code, or \`unknown\` when the address cannot be placed or the fetch came through a mail provider's image proxy (Gmail, Yahoo, Apple Mail Privacy Protection), whose address is the provider's, not the reader's. Only the country is kept, never the address. People's opens and clicks are counted apart from machines' (\`bot\_opened\`, \`bot\_clicked\`). Counts cover whole UTC hours like GET /emails/metrics, and opens and clicks are counted by country from 2026-11-16 on. IP geolocation by DB-IP (db-ip.com), CC BY 4.0. 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": [
    {
      "country": "string",
      "opened": 0,
      "unique_opened": 0,
      "bot_opened": 0,
      "clicked": 0,
      "unique_clicked": 0,
      "bot_clicked": 0
    }
  ]
}
```
