> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluidehr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Description

> Payroll runs, payslips, validators, and async payroll processing.

The **Payroll API** processes payroll runs and generates payslips. Employee records live in HR — create employees there before running payroll.

## Base path

`/api/v1/payroll`

## Authorization

Developer JWT + API key on every request. See [Authorization](/getting-started/authorization).

## Operations and monitoring

| Endpoint                      | Purpose                  |
| ----------------------------- | ------------------------ |
| `GET /api/v1/payroll`         | Service root             |
| `GET /api/v1/payroll/metrics` | Prometheus scrape target |

## Typical integration flow

1. Ensure employees exist in HR
2. Create a payroll run for a pay period
3. Process the run and fetch payslips
4. Optionally trigger payslip PDF generation via [Utils](/utils/overview)

<CardGroup cols={2}>
  <Card title="Payroll product guide" icon="wallet" href="/payroll/overview">
    Runs, payslips, and integration patterns.
  </Card>

  <Card title="How-to guides" icon="book-open" href="/guides/payroll/run-payroll">
    Configure settings, run payroll, and GL mappings.
  </Card>
</CardGroup>