Employee Actions
Payslips

List approved payslip files for the authenticated employee

Changed on

Returns a paginated list of payslip files belonging to the current employee.

Authentication

This endpoint requires the following token type:

  • Employee-scoped access token (OAuth2Assertion) — obtained through the urn:ietf:params:oauth:grant-type:jwt-bearer grant. See Authentication for partners.

Scopes

CategoryRead only ScopeWrite only Scope (read access implicit)
Manage employment documents (employment_documents)View payslips (payslip:read)-
get/v1/employee/payslips

Request

  • Base URL: https://gateway.remote.com
  • URL: https://gateway.remote.com/v1/employee/payslips
  • Auth: OAuth 2 (client credentials, token URL /auth/oauth2/token, scopes: https://gateway.remote.com/employment.manage, payslip:read, employment_documents, all:write, all:read)

Query parameters

pageinteger

Starts fetching records after the given page

page_sizeinteger

Number of items per page

Response

Success

Example response

{
  "current_page": 1,
  "payslips": [
    {
      "file": {
        "inserted_at": "2026-04-01T00:00:00Z",
        "name": "payslip.pdf",
        "slug": "663e0b79-c893-45ff-a1b2-f6dcabc098b5"
      },
      "has_employee_payroll_overviews": false,
      "payroll_output": null,
      "payroll_run": {
        "expected_payout_date": "2026-05-01",
        "period_end": "2026-04-30",
        "period_start": "2026-04-01",
        "type": "regular"
      },
      "payslip": {
        "active_compensation": null,
        "has_content_layout": false,
        "net_salary": null,
        "slug": "7f4bc535-3d7a-43f5-ab44-360ca91acc7a"
      }
    }
  ],
  "total_count": 1,
  "total_pages": 1
}

Changes

  • 09a7e24e0df5Revision changes
    • info

      the security scope employment_documents was added to the endpoint's security scheme OAuth2Assertion

    • info

      the security scope payroll was removed from the endpoint's security scheme OAuth2Assertion

  • 9302e7966d16Revision changes
    • info

      the security scope payroll was added to the endpoint's security scheme OAuth2Assertion

    • info

      the security scope employment_documents was removed from the endpoint's security scheme OAuth2Assertion