# Get aggregate birthday statistics
URL: /docs/api-reference/birthdays-milestones/getBirthdayStats

## GET `/api/v1/public/birthdays/stats`

**Summary:** Get aggregate birthday statistics
**Operation ID:** `getBirthdayStats`

Returns upcoming birthday counts for the current week and month, and active celebration template status.

**Authentication:** `X-Api-Key: sk_live_...` or `Authorization: Bearer sk_live_...`

### Responses

- **`200`**: Birthday counts and active automation status

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "example": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "thisWeek": {
          "type": "integer",
          "example": 8
        },
        "thisMonth": {
          "type": "integer",
          "example": 34
        },
        "automationActive": {
          "type": "boolean",
          "example": true
        }
      }
    }
  }
}
```
- **`401`**: Authentication failed or API key missing