Skip to main content
GET
List payroll runs
Preview. A contract we are building with design partners. It is not callable yet, and fields can still change. See Availability.

Authorizations

Authorization
string
header
required

Your partner secret key, mk_live_… for real companies or mk_test_… for test companies. Keep it on your servers. See Authentication.

Path Parameters

company_id
string<uuid>
required

The company's ID. Every company-scoped call works in exactly this company.

Query Parameters

limit
integer
default:50

Page size.

Required range: 1 <= x <= 200
cursor
string

The next_cursor of the previous page.

period
string

A year (2026), a quarter (2026-Q3), a month (2026-09) or an instalment (2026-1P).

Pattern: ^[0-9]{4}(-Q[1-4]|-(0[1-9]|1[0-2])|-[1-3]P)?$
Example:

"2026-Q3"

Response

Payroll runs.

data
object[]
required
next_cursor
string | null
required

Pass it as cursor for the next page. null on the last page.