Salary Item

These endpoints let you manage salary items in the system. It allows you to retrieve, create, update, and delete salary item records.

Get Salary Items

get

Get salary items with optional pagination and search.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pageintegerOptional

Page number

Default: 0Example: 0

sizeinteger · min: 1 · max: 50Optional

Page size

Default: 10Example: 10

includeDefaultTypebooleanOptionalDefault: falseExample: false

querystringOptional

Search Query

Supported Keys	Supported Operators	Notes
code	:	Like operator
name	:	Like operator

Example: name:Salary

Responses

200

OK

application/json

totalPagesintegerRequired

Total number of pages available

lastbooleanRequired

Indicates whether this is the last page

totalElementsintegerRequired

Total number of elements across all pages

numberOfElementsintegerRequired

Number of elements in the current page

firstbooleanRequired

Indicates whether this is the first page

sizeintegerRequired

Size of the page (number of elements per page)

numberintegerRequired

Current page number (zero-indexed)

400

Bad Request

get

/core/v1/salary-items

cURLPython SDK

curl -X GET \
  "https://api.catapa.com/core/v1/salary-items?page=0&size=10&includeDefaultType=False&query=name%3ASalary" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "e18f5618-bc6c-11e6-80f5-76304dec7eb1",
      "code": "001",
      "name": "Basic Salary",
      "payslipName": "Gaji Pokok",
      "salaryItemCategory": "INCOME",
      "pph21Method": "GROSS",
      "pph21Item": "ITEM_01_BASIC_SALARY"
    }
  ],
  "totalPages": 1,
  "last": true,
  "totalElements": 1,
  "numberOfElements": 1,
  "sort": [
    {
      "direction": "DESC",
      "property": "name",
      "ignoreCase": false,
      "nullHandling": "NATIVE",
      "ascending": false,
      "descending": true
    }
  ],
  "first": true,
  "size": 10,
  "number": 0
}

Get Salary Item by Id

get

Return the salary item by Id.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: f47ac10b-58cc-4372-a567-0e02b2c3d479

Responses

200

OK

application/json

idstring · uuidOptional

codestringOptional

namestringOptional

payslipNamestringOptional

salaryItemCategorystringOptional

pph21MethodstringOptional

pph21ItemstringOptional

400

Bad Request

get

/core/v1/salary-items/{id}

cURLPython SDK

curl -X GET \
  "https://api.catapa.com/core/v1/salary-items/f47ac10b-58cc-4372-a567-0e02b2c3d479" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "id": "e18f5618-bc6c-11e6-80f5-76304dec7eb1",
  "code": "001",
  "name": "Basic Salary",
  "payslipName": "Gaji Pokok",
  "salaryItemCategory": "INCOME",
  "pph21Method": "GROSS",
  "pph21Item": "ITEM_01_BASIC_SALARY"
}