> For the complete documentation index, see [llms.txt](https://knowledge.rollcredits.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.rollcredits.io/payroll/review-payroll-runs/payroll-history.md).

# View payroll history

See past payroll runs and the timecards they paid, and download a run's paystubs, reports and CAPS export on the Payroll History tab.

The **Payroll History** tab lists every payroll run on the production and the timecards each run paid. Open **Payroll > Review Payroll Runs** in the sidebar and select the tab, which Owners, Super Admins and Managers see and Department Heads don't.

{% hint style="info" %}
This tab appears only if RollCredits payroll is turned on for your production. If your company uses the CAPS export, a run's panel also has **Download CAPS style export**.
{% endhint %}

## Read the payroll history table

Runs are grouped by pay date, newest first. Select the arrow next to a pay date to show the timecards that run paid. When more than one run has the same pay date, the date row shows **Multiple payrolls** and opens to **Payroll Run 1**, **Payroll Run 2** and so on, each with its own timecards.

| Column                          | On a run row                                                         | On a timecard row                                                                       |
| ------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| **Pay Date**                    | The run's pay date                                                   | The person's name. If their RollCredits name differs from their payroll name, both show |
| **Status**                      | The run's status                                                     | The status of the person's check                                                        |
| **Start Date** and **End Date** | Blank                                                                | The week the timecard covers                                                            |
| **Gross Wage**                  | The total of every check in the run, expense reimbursements included | The total of the person's wage checks                                                   |
| **Expenses**                    | Blank                                                                | The timecard's kit fees, mileage and other expenses                                     |

A run's status is one of these:

* **Pending**: the run was submitted and is still being processed.
* **Processed**: the run is finished, and its paystubs and reports are ready.
* **Failed**: the run didn't go through.

A check's status is one of these:

* **Pending**: not paid yet. On **All Timesheets**, the timecard shows **Submitted for Payroll**.
* **Processed**: paid. On **All Timesheets**, the timecard shows **Paid**.
* **Voided** or **Failed**: the payment didn't go through.

If a run or a check shows **Failed**, contact RollCredits support.

To find a person or a pay date, type in **Quick filter...** above the table. **Export** downloads the table as an Excel file.

## Open a payroll run

1. Find the run's row. If its pay date has more than one run, select the arrow next to the date first.
2. Select the eye icon at the end of the row.
3. The **Payroll Run** panel opens next to the table. To close it, select the **X** at the top of the panel.

The panel shows:

* **Pay Date** and **Status**.
* **Run Cost**: the combined total for the run's employees and loanouts, including expenses, employer taxes and fees, less any escrow credit.
* **No. Timesheets submitted**: how many timecards the run includes.
* **View Associated Transaction**, once the run's payroll invoice has been created. It opens the invoice on the **Vendors & Contractors** tab of the Transactions page. See [Review and edit a transaction](/transactions/transactions/edit-a-transaction.md).

Below these, the **Employees** card totals the run's W-2 employees and the **Loanouts** card totals its loanouts. Each card shows **Gross Wages**, **Expenses**, **Net Wages**, **Total Employer Taxes**, each employer tax by name, **Workers Compensation Fee** and **Platform Fee**. When they apply, a card also shows **PH\&W Fee**, employer contributions such as **P\&H**, **IAP**, **CSATF**, **TTF**, **NBF** and **AD\&D**, and **Escrow Credit**, in parentheses because it comes off the cost.

## Download paystubs

1. Open the run.
2. Select **Download Paystubs**. A ZIP file downloads with a paystub for each timecard in the run.
3. To stop while it's downloading, select the **X** next to the button.

**Download Paystubs** is greyed out until the run's status is **Processed**. To get one person's paystub, open their timecard instead, as described in [Review and approve timecards](/payroll/review-payroll-runs/review-timecards.md).

## Download a run's reports

1. Open the run.
2. Select **Payroll Run Reports**.
3. Choose a report. Each one downloads as a PDF.
   * **Export Audit**: the audit report for this run.
   * **Fringe Recap**: the fringes for this run.
   * **Final Employee List**: the end-of-show employee list for the whole production, across every processed run, not only this one.

**Payroll Run Reports** is greyed out until the run's status is **Processed**. For reports over a range of pay periods or the entire production, see [Download payroll reports](/payroll/reports.md).

## Download a CAPS style export

If your company uses the CAPS export, you can download a run as an Excel file to import into CAPS.

1. Open the run, and check that **View Associated Transaction** shows in the panel.
2. Select **Download CAPS style export**. The Excel file downloads.

{% hint style="info" %}
The export is built from the run's payroll invoice, so until **View Associated Transaction** appears it fails with "Failed to generate CAPS export". The file's description reads PAYROLL UPLOAD: 99999. Replace it with your own before you import the file.
{% endhint %}

## Open a timecard from a run

1. Select the arrow next to the pay date to show the run's timecards. If the date has more than one run, select the arrow next to the run too.
2. Select the eye icon at the end of a timecard row.
3. The timecard opens over the table. Review it as described in [Review and approve timecards](/payroll/review-payroll-runs/review-timecards.md).
4. Select the **X** at the top of the timecard to go back to **Payroll History**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://knowledge.rollcredits.io/payroll/review-payroll-runs/payroll-history.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.