---
title: "Get Auto Enrolment documents 🇬🇧"
method: GET
path: "/companies/{companyId}/auto-enrolment-documents"
tags: ["Company"]
---

# Get Auto Enrolment documents 🇬🇧

`GET /companies/{companyId}/auto-enrolment-documents`

## Request

- Base URL: `https://partner-api.payfit.com`
- URL: `https://partner-api.payfit.com/companies/{companyId}/auto-enrolment-documents`
- Auth: OAuth 2
  - Authorization code: `https://oauth.payfit.com/authorize`
  - Token URL: `https://oauth.payfit.com/token` scopes: `pension:read`
- TypeScript: <https://skmtc.dev/payfit/apis/partner-api/docs/companies/:companyId/auto-enrolment-documents/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the all documents related to auto enrolment. This endpoint should only be used for UK companies.

\
**Required scopes**: *pension:read*

## Path parameters

- `companyId` string, required

## Response `200`

The Auto Enrolment documents

- object
  - `documents` object[]
    - `documentId` string, required: The id of the document
    - `createdAt` string, date-time, required: Date when the file has been created.
    - `contractId` string, required: The contractId linked to the document
    - `year` string, required: Legal year of the document
    - `month` string, required: Legal month of the document
    - `documentUrl` string, required: The Payfit api URL to download the document

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/payfit/apis/partner-api.md) - [All operations](https://skmtc.dev/payfit/apis/partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payfit/apis/partner-api/revisions/4ad2186afd5e?raw)