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

# Payroll quickstart

> Create a payroll run and retrieve payslips through the Payroll API.

# Payroll quickstart

**Fluide Payroll** processes pay runs and payslips. Employees must already exist in [HR](/hr/overview) before you run payroll.

## Prerequisites

* Developer credentials and access token — [Authorization](/getting-started/authorization)
* At least one employee in HR — [HR quickstart](/hr/quickstart)

## 1. List payroll runs

Confirm you can reach the Payroll API:

<CodeGroup>
  ```bash curl theme={null}
  curl -X GET "$FLUIDE_BASE_URL/api/v1/payroll/payroll" \
    -H "Authorization: Bearer $FLUIDE_ACCESS_TOKEN" \
    -H "X-Fluide-Api-Key: $FLUIDE_API_KEY" \
    -H "X-Fluide-Client-Id: fluide-developer"
  ```

  ```javascript Node.js theme={null}
  const res = await fetch(`${baseUrl}/api/v1/payroll/payroll`, {
    headers: {
      Authorization: `Bearer ${accessToken}`,
      'X-Fluide-Api-Key': process.env.FLUIDE_API_KEY!,
      'X-Fluide-Client-Id': 'fluide-developer',
    },
  });

  if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
  const runs = await res.json();
  ```
</CodeGroup>

## 2. Create and process a run

Create a payroll run for your pay period, then process it. Exact fields depend on your organization's payroll configuration.

<Tip>
  Open the **Payroll** group in [API reference](/api-reference/payroll) for create/process endpoints, request bodies, and status codes.
</Tip>

## 3. Fetch payslips

After a run completes, retrieve payslips for employees in that period. You can generate PDF artifacts through [Utils](/utils/overview) when your integration needs downloadable payslips.

## Typical flow

<Steps>
  <Step title="Sync employees in HR">
    Create or update employee records via `/api/v1/hr/employees`.
  </Step>

  <Step title="Create a payroll run">
    POST a run for the target period.
  </Step>

  <Step title="Process the run">
    Trigger processing and poll until the run reaches a terminal status.
  </Step>

  <Step title="Deliver payslips">
    Fetch payslip data via the API or generate PDFs through Utils.
  </Step>
</Steps>

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

  <Card title="Payroll API reference" icon="code" href="/api-reference/payroll">
    Full endpoint list and playground.
  </Card>
</CardGroup>