# Get Windfall coverage stats

> Source: /api-reference/partner/explorer/windfall/get-stats
> Aggregate counts of how much of the guest base Windfall has matched. Requires both `partner:guests:read` (declared on the controller) and `partner:guests:pii:read` (on the handler) — the guard ANDs them.
> Full spec: https://docs.journey.com/openapi/partner.v1.json

## `GET /v1/partner/windfall/stats`

```json
{
  "description": "Aggregate counts of how much of the guest base Windfall has matched. Requires both `partner:guests:read` (declared on the controller) and `partner:guests:pii:read` (on the handler) — the guard ANDs them.",
  "operationId": "windfallPartner_getStats",
  "parameters": [],
  "responses": {
    "200": {
      "description": "Windfall coverage statistics."
    },
    "401": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerErrorResponse"
          }
        }
      },
      "description": "No usable credential. Send `Authorization: Bearer <jwt>` or `X-API-Key: jny_...`."
    },
    "403": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerErrorResponse"
          }
        }
      },
      "description": "The credential authenticated but lacks the scopes in `x-required-scopes`, or the resource belongs to another organization."
    },
    "404": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PartnerErrorResponse"
          }
        }
      },
      "description": "No such resource, or it is outside the organization the credential resolves to."
    }
  },
  "security": [
    {
      "partnerBearer": []
    },
    {
      "partnerApiKey": []
    }
  ],
  "summary": "Get Windfall coverage stats",
  "tags": [
    "partner/windfall"
  ],
  "x-required-scopes": [
    [
      "partner:guests:read"
    ],
    [
      "partner:guests:pii:read"
    ]
  ]
}
```