# Get health score

Retrieve your account's email health score and engagement quality metrics.

Health Score (0-100) indicates your overall sending reputation based on:
- Delivery rate
- Engagement (opens/clicks)
- Bounce rate
- Complaint rate

Reputation Grades:
- A+ (95-100): Outstanding
- A (90-94): Excellent
- B+ (85-89): Good
- B (80-84): Above average
- C+ (75-79): Fair
- C (70-74): Below average
- D (60-69): Poor
- F (0-59): Critical

Endpoint: GET /api/customer/health-score
Version: 1.0.0
Security: ApiKeyAuth

## Response 200 fields (application/json):

  - `health_score` (object)

  - `health_score.overall_score` (number)
    Overall health score (0-100, higher is better)

  - `health_score.delivery_rate` (number)
    Percentage of emails successfully delivered

  - `health_score.open_rate` (number)
    Percentage of delivered emails opened

  - `health_score.click_rate` (number)
    Percentage of delivered emails clicked

  - `health_score.bounce_rate` (number)
    Percentage of emails bounced

  - `health_score.complaint_rate` (number)
    Percentage of emails marked as spam

  - `health_score.reputation_grade` (string)
    Letter grade representation of health score
    Enum: "A+", "A", "B+", "B", "C+", "C", "D", "F"

  - `health_score.last_calculated` (string)
    When this score was last calculated

  - `insights` (object)

  - `insights.status` (string)
    Enum: "excellent", "good", "fair", "poor", "critical"

  - `insights.summary` (string)

  - `insights.recommendations` (array)

  - `benchmarks` (object)

  - `benchmarks.delivery_rate` (object)

  - `benchmarks.delivery_rate.good` (number)

  - `benchmarks.delivery_rate.average` (number)

  - `benchmarks.delivery_rate.poor` (number)

  - `benchmarks.open_rate` (object)

  - `benchmarks.bounce_rate` (object)

  - `benchmarks.complaint_rate` (object)

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 404 fields (application/json):

  - `error` (string)

  - `message` (string)
    Example: "No data available yet. Send some emails first."