Home
Home
  1. Payroll Provider Reference Implementation
  • Welcome
  • Getting started
    • Availability and Onboarding
      • Light Availability Check
      • Full Availability Check
      • Onboarding
    • Salary Deduction
      • Deduction Instruction
      • Re-running Payroll
      • Deduction Payments and Reconciliation
      • Changes to Employee Status
  • API Reference
    • Authentication
    • Idempotency
    • Webhooks
      • Webhooks
    • Salary Deduction
      • Salary Deduction Data Request
      • Salary Deduction Confirmation Submission
  • Payroll Provider Reference Implementation
    • Light Availability Check
      POST
    • Full Availability Check
      POST
    • Salary Deduction Enablement
      POST
    • Payroll Information
      GET
    • Salary Deduction Employee Data Push
      POST
  • Schemas
    • Availability Check
      • Full Availability Check Request
      • Full Availability Check Response
      • Light Availability Check Request
      • Light Availability Check Response
    • Core
      • ProblemDetails
      • MetaData
      • Paged Response
    • Deduction Instructions
      • Salary Deduction Request
      • Salary Deduction
      • Confirmation Deduction Response
      • Salary Deduction Enablement Response
      • Employee Deduction Push Response
      • Employee Deduction Push Request
      • Salary Deduction Push
      • InstructionFile
      • InstructionItem
    • Payment Account
      • Payment Account
      • Payment Information
    • Payroll
      • Employee
      • Availability Payroll
      • Availability Employment
      • Availability Employer
      • BeneficiaryAccountResponse
      • Salary Deduction Confirmation Data Submission
      • Salary Deduction Confirmation Data Submission Response
      • Salary Deduction Data Request
      • Salary Deduction Data Response
      • Payroll
      • Employee Payroll
      • Employment
      • Employer
      • Pay Date
      • Salary Deduction Enablement Request
      • PayrollScheduleResponse
    • Webhooks
      • Employee Update Payload
      • WebHook
  1. Payroll Provider Reference Implementation

Payroll Information

GET
/payrolls/{payroll_id}
OperationId:get_payroll_information
Called by Ontime to retrieve information about the Payroll specified by the payroll_id.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Path Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '/payrolls/{{$string.uuid}}' \
--header 'Idempotency-Key: {{$string.uuid}}'

Responses

๐ŸŸข200
application/json
Indicates the request was successfully processed by the server and a valid response is included in the body.
Bodyapplication/json

Example
{
    "payroll_response": {
        "payroll": {
            "id": "e886b6bd-a98f-49df-80fa-f8e4b882b823",
            "payment_run_frequency": "four_weekly",
            "pay_dates": [
                {
                    "pay_date": "2026-09-29T20:01:16.581Z",
                    "payroll_cutoff_date": "2027-01-25T11:25:22.426Z"
                },
                {
                    "pay_date": "2026-05-14T05:16:12.444Z",
                    "payroll_cutoff_date": "2026-11-10T06:47:18.758Z"
                }
            ]
        }
    }
}
๐ŸŸ 400
๐ŸŸ 401Unauthorised
๐ŸŸ 403Forbidden
๐ŸŸ 404Not Found
๐ŸŸ 409Conflict
๐ŸŸ 422Unprocessable Entity
Previous
Salary Deduction Enablement
Next
Salary Deduction Employee Data Push