---
title: "List mailbox warmup scores"
method: GET
path: "/api/v1/analytics/warmup-scores"
tags: ["Analytics"]
---

# List mailbox warmup scores

`GET /api/v1/analytics/warmup-scores`

## Request

- Base URL: `https://api.aerosend.io`
- URL: `https://api.aerosend.io/api/v1/analytics/warmup-scores`
- Auth: API key in header `X-API-Key`

Returns the warmup score and warmup start date for each mailbox belonging to the authenticated client.

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Successfully retrieved warmup scores

- WarmupScoreListApiResponse
  - `success` boolean: Success flag
  - `data` WarmupScore[]: List of items
    - `email` string: Mailbox email address
    - `score` integer: Warmup score
    - `warmup_start_date` string: Domain warmup start date (YYYY-MM-DD)
  - `pagination` Pagination: Pagination metadata
    - `offset` integer: Current offset
    - `limit` integer: Items per page
    - `total` integer: Total number of items
    - `has_more` boolean: Whether there are more items
  - `timestamp` string: Response timestamp

## Other responses

- `400`: Invalid pagination parameters
- `401`: Unauthorized - Invalid or expired API key
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/aerosend/apis/aerosend-developer-api.md) · [All operations](https://skmtc.dev/aerosend/apis/aerosend-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aerosend/apis/aerosend-developer-api/revisions/9828eeb89b1f?raw)