Termination

These endpoints let you manage employee terminations in the system. It allows you to retrieve, create, update, and delete termination records.

Get Termination Entry

get

Return the termination entries.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

employeeIdstringRequiredExample: 0ab1c2d3-e4f5-6789-0123-456789abcdef

Responses

200

OK

application/json

idstringOptional

terminationCodestringOptional

effectiveDatestringOptional

payrollMethodstringOptional

bpjsManpowerEndDatestringOptional

bpjsHealthcareEndDatestringOptional

pph21MembershipEndDatestringOptional

requestDatestringOptional

servicePeriodBystringOptional

rehirebooleanOptional

approvalStatusstring · enumOptionalPossible values:

400

Bad Request

get

/core/v1/employees/{employeeId}/termination-entries

cURLPython SDK

curl -X GET \
  "https://api.catapa.com/core/v1/employees/0ab1c2d3-e4f5-6789-0123-456789abcdef/termination-entries" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "id": "78b10148-8624-488e-a13d-23fb853c1af3",
  "terminationCode": "001/TRM/09/2019",
  "effectiveDate": "2019-09-30",
  "payrollMethod": "PROPORTIONAL",
  "terminationReason": {
    "id": "2c685762-c0ef-11e6-a4a6-cec0c932ce01",
    "name": "Termination Reason 1",
    "terminationPph21Reason": "Pensiun",
    "terminationBpjsManpowerReason": "Mengundurkan diri",
    "terminationReasonCategory": "Force Majeur",
    "severance": false
  },
  "bpjsManpowerEndDate": "2019-09-30",
  "bpjsHealthcareEndDate": "2019-09-30",
  "pph21MembershipEndDate": "2019-09-30",
  "requestDate": "2019-09-29",
  "servicePeriodBy": "START_DATE",
  "rehire": true,
  "approvalStatus": "APPROVED"
}

Create Termination Entry

post

Create a termination entry.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

employeeIdstringRequiredExample: 0ab1c2d3-e4f5-6789-0123-456789abcdef

Body

application/json

terminationCodestringOptional

payrollMethodstring · enumRequiredPossible values:

terminationReasonIdstringRequired

requestDatestring · dateRequired

YYYY-MM-DD

bpjsManpowerEndDatestring · dateRequired

YYYY-MM-DD

servicePeriodBystring · enumOptionalPossible values:

pph21MembershipEndDatestring · dateRequired

YYYY-MM-DD

bpjsHealthcareEndDatestring · dateRequired

YYYY-MM-DD

effectiveDatestring · dateRequired

YYYY-MM-DD

rehirebooleanRequiredDeprecated

Deprecated field that no longer has any effect on terminated employee pages

Responses

200

OK

application/json

idstringOptional

terminationCodestringOptional

effectiveDatestringOptional

payrollMethodstringOptional

bpjsManpowerEndDatestringOptional

bpjsHealthcareEndDatestringOptional

pph21MembershipEndDatestringOptional

requestDatestringOptional

servicePeriodBystringOptional

rehirebooleanOptional

approvalStatusstring · enumOptionalPossible values:

400

Bad Request

post

/core/v1/employees/{employeeId}/termination-entries

cURLPython SDK

curl -X POST \
  "https://api.catapa.com/core/v1/employees/0ab1c2d3-e4f5-6789-0123-456789abcdef/termination-entries" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id" \
  -H "Content-Type: application/json" \
  -d '{
  "terminationCode": "001/TRM/09/2019",
  "payrollMethod": "PROPORTIONAL",
  "terminationReasonId": "2c685762-c0ef-11e6-a4a6-cec0c932ce01",
  "requestDate": "2019-09-29",
  "bpjsManpowerEndDate": "2019-09-30",
  "servicePeriodBy": "START_DATE",
  "pph21MembershipEndDate": "2019-09-30",
  "bpjsHealthcareEndDate": "2019-09-30",
  "effectiveDate": "2019-09-30",
  "rehire": true
}'

{
  "id": "78b10148-8624-488e-a13d-23fb853c1af3",
  "terminationCode": "001/TRM/09/2019",
  "effectiveDate": "2019-09-30",
  "payrollMethod": "PROPORTIONAL",
  "terminationReason": {
    "id": "2c685762-c0ef-11e6-a4a6-cec0c932ce01",
    "name": "Termination Reason 1",
    "terminationPph21Reason": "Pensiun",
    "terminationBpjsManpowerReason": "Mengundurkan diri",
    "terminationReasonCategory": "Force Majeur",
    "severance": false
  },
  "bpjsManpowerEndDate": "2019-09-30",
  "bpjsHealthcareEndDate": "2019-09-30",
  "pph21MembershipEndDate": "2019-09-30",
  "requestDate": "2019-09-29",
  "servicePeriodBy": "START_DATE",
  "rehire": true,
  "approvalStatus": "APPROVED"
}

Undo Termination Entry

delete

Undo the termination entry.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

employeeIdstringRequiredExample: 0ab1c2d3-e4f5-6789-0123-456789abcdef

Responses

200

OK

application/json

anyOptional

400

Bad Request

delete

/core/v1/employees/{employeeId}/termination-entries

cURLPython SDK

curl -X DELETE \
  "https://api.catapa.com/core/v1/employees/0ab1c2d3-e4f5-6789-0123-456789abcdef/termination-entries" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{}

Get Termination Reason

get

Search Query

Supported Keys	Supported Operators	Notes
name	:	Like operator

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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/termination-reasons

cURLPython SDK

curl -X GET \
  "https://api.catapa.com/core/v1/termination-reasons" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "name": "Termination reason for deleted template",
      "terminationPph21Reason": "Pensiun",
      "terminationBpjsManpowerReason": "Mengundurkan diri",
      "terminationReasonCategory": "Force Majeur",
      "taxReason": {
        "id": "60a2d8c2-b5ff-11e6-80f5-76304dec7eb7",
        "name": "Pensiun",
        "taxAnnualized": false
      },
      "bpjsManpowerReason": {
        "id": "60a2d8c2-b5ff-11e6-80f5-76304dec7eb1",
        "name": "Mengundurkan diri"
      },
      "reasonCategory": {
        "id": "60a2e07e-b5ff-11e6-80f5-76304dec7eb7",
        "name": "Force Majeur"
      },
      "severance": false
    },
    {
      "id": "fe0b217f-dd55-426a-b987-9a618ca794fe",
      "name": "Mengundurkan diri dengan permohonan 30 hari sebelumnya",
      "terminationPph21Reason": "PHK",
      "terminationBpjsManpowerReason": "PHK",
      "terminationReasonCategory": "PHK Atas Kehendak Karyawan",
      "taxReason": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK",
        "taxAnnualized": false
      },
      "bpjsManpowerReason": {
        "id": "7373bcba-85a0-467a-a36e-7ed8366b12f5",
        "name": "PHK"
      },
      "reasonCategory": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK Atas Kehendak Karyawan"
      },
      "severance": true
    },
    {
      "id": "f8c6557f-d265-46d7-b496-ae3d666a93ed",
      "name": "Penggabungan kepemilikan perusahaan dan karyawan tidak melanjutkan hubungan kerja",
      "terminationPph21Reason": "PHK",
      "terminationBpjsManpowerReason": "PHK",
      "terminationReasonCategory": "PHK Atas Kehendak Karyawan",
      "taxReason": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK",
        "taxAnnualized": false
      },
      "bpjsManpowerReason": {
        "id": "7373bcba-85a0-467a-a36e-7ed8366b12f5",
        "name": "PHK"
      },
      "reasonCategory": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK Atas Kehendak Karyawan"
      },
      "severance": true
    },
    {
      "id": "cc15dba5-b836-4e06-9067-abc63943d3aa",
      "name": "Karyawan mangkir tanpa keterangan tertulis dan telah dipanggil oleh perusahaan 2 (dua) kali",
      "terminationPph21Reason": "PHK",
      "terminationBpjsManpowerReason": "PHK",
      "terminationReasonCategory": "PHK Atas Kehendak Perusahaan",
      "taxReason": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK",
        "taxAnnualized": false
      },
      "bpjsManpowerReason": {
        "id": "7373bcba-85a0-467a-a36e-7ed8366b12f5",
        "name": "PHK"
      },
      "reasonCategory": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK Atas Kehendak Karyawan"
      },
      "severance": true
    },
    {
      "id": "cb87595f-843d-42d9-b523-7086145096b0",
      "name": "Karyawan ditahan pihak berwajib",
      "terminationPph21Reason": "PHK",
      "terminationBpjsManpowerReason": "PHK",
      "terminationReasonCategory": "PHK Atas Kehendak Perusahaan",
      "taxReason": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK",
        "taxAnnualized": false
      },
      "bpjsManpowerReason": {
        "id": "7373bcba-85a0-467a-a36e-7ed8366b12f5",
        "name": "PHK"
      },
      "reasonCategory": {
        "id": "60a2d8c2-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK Atas Kehendak Perusahaan"
      },
      "severance": true
    },
    {
      "id": "a8a54fc3-51e5-4ac2-9fcf-f2fb715d1ce2",
      "name": "Sakit berkepanjangan dan tidak dapat lanjut bekerja setelah 12 (dua belas) bulan",
      "terminationPph21Reason": "PHK",
      "terminationBpjsManpowerReason": "Cacat total tetap",
      "terminationReasonCategory": "PHK Atas Kehendak Perusahaan",
      "taxReason": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK",
        "taxAnnualized": false
      },
      "bpjsManpowerReason": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb2",
        "name": "Cacat total tetap"
      },
      "reasonCategory": {
        "id": "60a2d8c2-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK Atas Kehendak Perusahaan"
      },
      "severance": true
    },
    {
      "id": "7e7aaf65-7f77-43c0-ab53-5ad7c48e3a4f",
      "name": "Pensiun",
      "terminationPph21Reason": "Pensiun",
      "terminationBpjsManpowerReason": "Usia pensiun",
      "terminationReasonCategory": "PHK Atas Kehendak Perusahaan",
      "taxReason": {
        "id": "60a2d8c2-b5ff-11e6-80f5-76304dec7eb7",
        "name": "Pensiun",
        "taxAnnualized": false
      },
      "bpjsManpowerReason": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb3",
        "name": "Usia pensiun"
      },
      "reasonCategory": {
        "id": "60a2d8c2-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK Atas Kehendak Perusahaan"
      },
      "severance": true
    },
    {
      "id": "7aa6d7f4-8066-4ad3-b3c4-99a1c13e2fea",
      "name": "Perusahaan melakukan tindakan kurang menyenangkan",
      "terminationPph21Reason": "PHK",
      "terminationBpjsManpowerReason": "PHK",
      "terminationReasonCategory": "PHK Atas Kehendak Karyawan",
      "taxReason": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK",
        "taxAnnualized": false
      },
      "bpjsManpowerReason": {
        "id": "7373bcba-85a0-467a-a36e-7ed8366b12f5",
        "name": "PHK"
      },
      "reasonCategory": {
        "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
        "name": "PHK Atas Kehendak Karyawan"
      },
      "severance": true
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 8,
  "totalElements": 8,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Create Termination Reason

post

Create a termination reason.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestring · min: 1 · max: 255Required

severancebooleanOptionalDefault: false

Responses

201

OK

application/json

400

Bad Request

post

/core/v1/termination-reasons

cURLPython SDK

curl -X POST \
  "https://api.catapa.com/core/v1/termination-reasons" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Meninggalkan Indonesia selama-lamanya",
  "taxReason": {
    "id": "233ed3e1-3d8d-4138-99d2-b6d831247dad"
  },
  "bpjsManpowerReason": {
    "id": "60a2e07e-b5ff-11e6-80f5-76304dec7eb6"
  },
  "reasonCategory": {
    "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7"
  },
  "severance": false
}'

{
  "id": "02bcd3f5-a07b-4f6c-88aa-5474a604ba56",
  "name": "Meninggalkan Indonesia selama-lamanya",
  "terminationPph21Reason": "Meninggalkan Indonesia selama-lamanya",
  "terminationBpjsManpowerReason": "Meninggalkan wilayah NKRI selamanya",
  "terminationReasonCategory": "PHK Atas Kehendak Karyawan",
  "taxReason": {
    "id": "233ed3e1-3d8d-4138-99d2-b6d831247dad",
    "name": "Meninggalkan Indonesia selama-lamanya",
    "taxAnnualized": true
  },
  "bpjsManpowerReason": {
    "id": "60a2e07e-b5ff-11e6-80f5-76304dec7eb6",
    "name": "Meninggalkan wilayah NKRI selamanya"
  },
  "reasonCategory": {
    "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
    "name": "PHK Atas Kehendak Karyawan"
  },
  "severance": false
}

Update Termination Reason

put

Update the termination reason.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

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

Body

application/json

namestring · min: 1 · max: 255Required

severancebooleanOptionalDefault: false

Responses

200

OK

application/json

idstringOptional

namestringOptional

terminationPph21ReasonstringOptionalDeprecated

Use taxReason instead

terminationBpjsManpowerReasonstringOptionalDeprecated

Use bpjsManpowerReason instead

terminationReasonCategorystringOptionalDeprecated

Use reasonCategory instead

severancebooleanOptional

400

Bad Request

put

/core/v1/termination-reasons/{id}

cURLPython SDK

curl -X PUT \
  "https://api.catapa.com/core/v1/termination-reasons/f47ac10b-58cc-4372-a567-0e02b2c3d479" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Meninggalkan Indonesia selama-lamanya",
  "taxReason": {
    "id": "233ed3e1-3d8d-4138-99d2-b6d831247dad"
  },
  "bpjsManpowerReason": {
    "id": "60a2e07e-b5ff-11e6-80f5-76304dec7eb6"
  },
  "reasonCategory": {
    "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7"
  },
  "severance": false
}'

{
  "id": "02bcd3f5-a07b-4f6c-88aa-5474a604ba56",
  "name": "Meninggalkan Indonesia selama-lamanya",
  "terminationPph21Reason": "Meninggalkan Indonesia selama-lamanya",
  "terminationBpjsManpowerReason": "Meninggalkan wilayah NKRI selamanya",
  "terminationReasonCategory": "PHK Atas Kehendak Karyawan",
  "taxReason": {
    "id": "233ed3e1-3d8d-4138-99d2-b6d831247dad",
    "name": "Meninggalkan Indonesia selama-lamanya",
    "taxAnnualized": true
  },
  "bpjsManpowerReason": {
    "id": "60a2e07e-b5ff-11e6-80f5-76304dec7eb6",
    "name": "Meninggalkan wilayah NKRI selamanya"
  },
  "reasonCategory": {
    "id": "60a2db60-b5ff-11e6-80f5-76304dec7eb7",
    "name": "PHK Atas Kehendak Karyawan"
  },
  "severance": false
}

Get Termination Reason Category

get

Search Query

Supported Keys	Supported Operators	Notes
name	:	Like operator

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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/termination-reason-categories

cURLPython SDK

curl -X GET \
  "https://api.catapa.com/core/v1/termination-reason-categories" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "name": "Pengunduran Diri"
    },
    {
      "id": "fe0b217f-dd55-426a-b987-9a618ca794fe",
      "name": "Pensiun"
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 2,
  "totalElements": 2,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Get Termination Tax Reasons

get

Search Query

Supported Keys	Supported Operators	Notes
name	:	Like operator
taxAnnualized	:	Equal operator

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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/termination-tax-reasons

cURLPython SDK

curl -X GET \
  "https://api.catapa.com/core/v1/termination-tax-reasons" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "name": "Alasan Medis",
      "taxAnnualized": false
    },
    {
      "id": "fe0b217f-dd55-426a-b987-9a618ca794fe",
      "name": "Pensiun",
      "taxAnnualized": true
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 2,
  "totalElements": 2,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}

Get Termination BPJS Manpower Reasons

get

Search Query

Supported Keys	Supported Operators	Notes
name	:	Like operator

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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/termination-bpjs-manpower-reasons

cURLPython SDK

curl -X GET \
  "https://api.catapa.com/core/v1/termination-bpjs-manpower-reasons" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "79f537af-83b2-4a8b-851c-5d14ec046554",
      "name": "Pengunduran Diri"
    },
    {
      "id": "fe0b217f-dd55-426a-b987-9a618ca794fe",
      "name": "Pensiun"
    }
  ],
  "pageable": "INSTANCE",
  "number": 0,
  "size": 10,
  "totalPages": 1,
  "numberOfElements": 2,
  "totalElements": 2,
  "last": true,
  "sort": [],
  "first": true,
  "empty": true
}