---
title: "*GET Payruns"
method: GET
path: "/payroll/payruns"
---

# \*GET Payruns

`GET /payroll/payruns`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/payroll/payruns`
- Auth: API key in query parameter `access_token`

/payroll/payruns
Permission Level: 2

## Response `200`

200

- object
  - `status` integer
  - `data` object[]
    - `id` integer
    - `company_id` integer
    - `name` string
    - `from` string
    - `to` string
    - `source_type` integer
    - `status` integer
    - `applies_to` unknown[]
      - unknown
    - `total_cost` integer
    - `employees` integer
    - `created_by` integer
    - `updated_by` unknown
    - `deleted_by` unknown
    - `created_at` string
    - `updated_at` unknown
    - `deleted_at` unknown
  - `error` unknown

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/payroll/payruns/get.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
