List Pay Items

Lists pay items for a company with optional filtering by employment, legal entity, date range, and pagination.
Recurring pay items are not included; the monthly payments generated from them are.

Authentication

This endpoint accepts any one of the following token types:

  • Company-scoped access token (OAuth2AuthorizationCode) — obtained by a company manager through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
  • Company-scoped access token (assertion) (OAuth2CompanyManagerAssertion) — obtained through the urn:ietf:params:oauth:grant-type:jwt-bearer grant for a company manager. See OAuth Assertion.
  • Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page, with the scopes they choose there. See Authorization for customers.

Scopes

Any one of the scopes in a token type's row is enough. all:read and all:write work too.

Token typeCategoryRead only ScopeWrite only Scope (read access implicit)
Company-scoped access tokenManage payroll runs (payroll)View pay items (pay_item:read)Manage pay items (pay_item:write)
Company-scoped access token (assertion)Manage payroll runs (payroll)View pay items (pay_item:read)Manage pay items (pay_item:write)
Customer API tokenManage payroll runs (payroll)View pay items (pay_item:read)Manage pay items (pay_item:write)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
uuid

Filter by employment slug

date

Filter pay items with effective_date >= given date (YYYY-MM-DD)

date

Filter pay items with effective_date <= given date (YYYY-MM-DD)

string
length between 1 and 64
\S

Filters the results by the partner_external_id value the calling integration holds
for the pay item; another integration's identifiers are never matched. Matching is
exact, including case. A value can be held by one live pay item at a time, per integration and company; editing a
pay item keeps its value on the new version.
See Your own IDs on Remote records.

integer
≥ 1
Defaults to 1

Starts fetching records after the given page

integer
1 to 100
Defaults to 20

Number of items per page

Responses

Callback
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json