---
title: "Spam complaints"
method: GET
path: "/v1/domains/{domain}/reputation"
tags: ["Reputation"]
---

# Spam complaints

`GET /v1/domains/{domain}/reputation`

## Request

- Base URL: `https://data.inboxpro.io`
- URL: `https://data.inboxpro.io/v1/domains/{domain}/reputation`
- Auth: HTTP bearer

Daily spam complaint signals reported by Gmail and Yahoo for the domain. Mailbox providers use these to decide whether your email reaches the inbox.

## Path parameters

- `domain` string, required

## Query parameters

- `from` string, date
- `to` string, date

## Response `200`

Default Response

- object
  - `domain` string, required
  - `period` object, required: The days these numbers cover (UTC, both inclusive).
    - `from` string, date, required
    - `to` string, date, required
  - `data_as_of` string, date-time, required: Numbers include activity up to this moment. Recent hours may still change slightly.
  - `summary` object, required
    - `gmail_spam_rate_latest` number, nullable, required: Share of Gmail recipients who marked your email as spam, as a percentage (Gmail asks senders to stay below 0.3). Gmail publishes it with a delay of one to two days. The most recent value in the period; null when Gmail reported none, which is normal for low volume.
    - `yahoo_complaints` integer, required: Yahoo and AOL spam complaints in the period.
  - `days` object[], required: One row per day, oldest first.
    - `date` string, date, required
    - `gmail_spam_rate` number, nullable, required: Share of Gmail recipients who marked your email as spam, as a percentage (Gmail asks senders to stay below 0.3). Gmail publishes it with a delay of one to two days. The latest value Gmail had reported at the start of this day; null when none was available.
    - `yahoo_complaints` integer, required: Yahoo and AOL recipients who marked your email as spam that day.

## Other responses

- `400`: A parameter is missing or invalid.
- `401`: The API key is missing, invalid, or revoked.
- `404`: The domain is not one of your sending domains.
- `429`: Too many requests in a short time, or the daily request quota is used up.
- `503`: Stats are briefly unavailable. Retry after a short wait.

---

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