# Get employer

**GET /employers/{employerId}**

Returns a single employer by ID. The employer must belong to your
organisation. Useful for polling onboarding status after creation.



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


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **employerId** (string(uuid))
  Penfold employer UUID




## Responses
### 200
Employer details

#### Body: application/json (object)
- **id** (string(uuid))
  Unique identifier for the employer

- **name** (string)
  Employer name

- **externalReference** (string)
  Penfold employer reference (`PEN` + Companies House number)

- **companyNumber** (string)
  Companies House number

- **status** (string)
  Current status of the employer:
  - `AwaitingAgreement`: Employer must complete onboarding on Penfold's platform (agreement, AML/KYB)
  - `Pending`: Onboarding complete, awaiting first payroll submission
  - `Active`: Fully operational, can process payroll
  - `Closed`: Employer account closed

- **defaultEmployeeContributionsPercent** (number)
  Default employee contribution percentage

- **defaultEmployerContributionsPercent** (number)
  Default employer contribution percentage

- **contributionBasis** (string)
  Basis on which pension contributions are calculated

- **allowsSalarySacrifice** (boolean)
  Whether the employer allows salary sacrifice

- **paymentMethod** (string)
  Payment method for pension contributions

- **createdAt** (string(date-time))
  When the employer was created (ISO 8601)


### 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)