---
title: "List payslips"
method: GET
path: "/v1/payslips"
tags: ["Payslips"]
---

# List payslips

`GET /v1/payslips`

Lists all payslips belonging to a company. Can also filter for a single employment belonging
to that company.


## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage employment documents (`employment_documents`) | View payslips (`payslip:read`) | - |

## Query parameters

- `employment_id` string
- `start_date` string
- `end_date` string
- `expected_payout_start_date` string
- `expected_payout_end_date` string
- `page` integer
- `page_size` integer

## Response `200`

Success

- ListPayslipsResponse — Response schema listing many payslips
  - `data` object
    - `current_page` integer — The current page among all of the total_pages
    - `payslips` Payslip[]
      - `employment_id` string, required — The unique identifier (UUID) of the employment this payslip belongs to.
      - `expected_payout_date` string, date — UTC date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format
      - `id` string, required — The unique identifier (UUID) of the payslip.
      - `issued_at` string, date, required — The date the payslip was issued.
      - `net_pay_converted_amount` integer — The net pay amount converted to the company's billing currency, in cents. Only shown if available.
      - `net_pay_source_amount` integer — The net pay amount in the source (local) currency, in cents. Only shown if available.
    - `total_count` integer — The total number of records in the result
    - `total_pages` integer — The total number of pages the user can go through

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too many requests

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)