v1
latestOpenAPI 3.1.02026-07-242735131.1 MBPay Codes
List Pay Codes
Lists pay codes available for a legal entity. Pay codes represent the allowed pay element types that can be submitted via POST /v1/pay-items/bulk.
Scopes
| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage payroll runs (payroll) | View pay items (pay_item:read) | Manage pay items (pay_item:write) |
get/v1/companies/{company_id}/legal-entities/{legal_entity_id}/pay-codes
Path parameters
company_idstring uuid required
Identifier of the employment being terminated.
Example:663e0b79-c893-45ff-a1b2-f6dcabc098b5
Company ID
legal_entity_idstring uuid required
Identifier of the employment being terminated.
Example:663e0b79-c893-45ff-a1b2-f6dcabc098b5
Legal entity ID
Query parameters
pageinteger
Starts fetching records after the given page
page_sizeinteger
Number of items per page
Response
Success
Example response
{
"current_page": 1,
"pay_codes": [
{
"category": "time_and_attendance",
"code": "overtime",
"description": "Hours worked beyond standard schedule",
"external_import_code": null,
"name": "Overtime",
"slug": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"type": "hours"
}
],
"total_count": 1,
"total_pages": 1
}