# Get employee pension summary

**GET /employers/{employerId}/employees/{employeeId}/pension-summary**

Returns pension summary for a specific employee.

The employer must belong to your organisation. Returns 404 only if the
employee is genuinely not found. Opted-out employees return 200 with
`"status": "optedOut"` and null data fields.



## Servers
- Production: https://partner-api.getpenfold.com/v1 (Production)
- Staging: https://partner-api.getpenfold.dev/v1 (Staging)


## Authentication methods
- Bearer auth


## Parameters

### Path parameters
- **employerId** (string(uuid))
  Penfold employer UUID
- **employeeId** (string)
  Unique identifier for the employee



## Responses
### 200
Employee pension summary

#### Body: application/json (object)
- **provider** (string)
  Pension provider name
- **status** (string)
  - `active`: employee is enrolled, balance and contributions are populated
  - `optedOut`: employee opted out of the scheme, all data fields are null
- **balance** (object)

- **latestContributions** (object)
  Most recent contribution breakdown. Null if opted out or no contributions yet.
- **deepLink** (string(uri) | null)
  URL for "View & manage your pension" CTA. Null if opted out.

### 401
Missing or invalid authentication token

#### Body: application/json (object)
- **error** (string)


### 404
Resource not found

#### Body: application/json (object)
- **error** (string)


### 500
Internal server error

#### Body: application/json (object)
- **error** (string)



[Powered by Bump.sh](https://bump.sh)