BPJS Membership

These endpoints let you manage BPJS memberships for employees in the system. It allows you to retrieve, create, update, and delete BPJS membership records.

Get BPJS Healthcare Membership

get

Return the BPJS healthcare memberships.

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

ID of the BPJS Healthcare Membership

employeeIdstringOptional

membershipNumberstringOptional

startDatestringOptional

endDatestringOptional

effectiveDatestringOptional

firstLevelHealthcareFacilitystringOptional

dentalHealthcareFacilitystringOptional

400

Bad Request

get

/core/v1/employees/{employeeId}/bpjs-healthcare-memberships

cURLPython SDK

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

{
  "id": "6c571c34-9981-4223-ae04-f21647edec5e",
  "employeeId": "532eba49-1784-4224-9e0c-c8e70db96697",
  "membershipNumber": "34235",
  "startDate": "2025-01-01",
  "effectiveDate": "2025-07-01",
  "firstLevelHealthcareFacility": "healthcare",
  "dentalHealthcareFacility": "dental",
  "bpjsHealthcareProvider": {
    "id": "29b37992-6b61-4f8e-85f4-78b664847b9b",
    "code": "001",
    "name": "BPJS Kesehatan Cabang Bandung",
    "address": "Jl. Khp Hasan Mustopa No.81, Cikutra, Kec. Cibeunying Kidul, Kota Bandung, Jawa Barat 40124",
    "registrationNumber": "556332",
    "reportSignatoryName": "Budi",
    "reportSignatoryJobTitle": "Manager"
  },
  "bpjsHealthcareTemplate": {
    "id": "178f77de-39a0-48b4-8c33-89ff256ccf35",
    "code": "001",
    "name": "BPJS KS",
    "salaryType": "BY_SALARY_DECREE",
    "linkToPayroll": true
  },
  "bpjsHealthcareTreatmentClass": {
    "id": "3f0afd17-af9a-4274-a3da-7cba7f96b7f1",
    "name": "CLASS 1",
    "minSalaryType": "UMP",
    "minSalaryValue": "5000000",
    "maxSalaryType": "UMP",
    "maxSalaryValue": "10000000"
  },
  "additionalFamilyMemberships": [
    {
      "id": "62cecc2b-cff9-46ec-91f5-11235e1969ad",
      "familyMemberName": "Siti Rahayu",
      "familyMemberRelation": {
        "id": "1f29ea4e-a7e9-11e6-80f5-76304dec7eb7",
        "name": "Ibu Kandung",
        "code": "Ibu Kandung",
        "relationType": "MOTHER"
      },
      "firstLevelHealthcareFacility": "first level",
      "dentalHealthcareFacility": "dental"
    },
    {
      "id": "ccad2cc6-e02e-4770-add3-f4226857d47f",
      "familyMemberName": "Ahmad Suryanto",
      "familyMemberRelation": {
        "id": "1f29e7ec-a7e9-11e6-80f5-76304dec7eb7",
        "name": "Ayah Kandung",
        "code": "Ayah Kandung",
        "relationType": "FATHER"
      },
      "firstLevelHealthcareFacility": "first level",
      "dentalHealthcareFacility": "dental"
    }
  ]
}

Update BPJS Healthcare Membership

put

Update the BPJS healthcare membership.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

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

Body

application/json

bpjsHealthcareProviderIdstringRequired

bpjsHealthcareTemplateIdstringRequired

bpjsHealthcareTreatmentClassIdstringOptional

dentalHealthcareFacilitystringOptional

firstLevelHealthcareFacilitystringOptional

membershipNumberstringRequired

startDatestringRequired

effectiveDatestringOptional

Effective Date of the BPJS Healthcare Membership default to start date

Responses

200

OK

application/json

idstringOptional

ID of the BPJS Healthcare Membership

employeeIdstringOptional

membershipNumberstringOptional

startDatestringOptional

endDatestringOptional

effectiveDatestringOptional

firstLevelHealthcareFacilitystringOptional

dentalHealthcareFacilitystringOptional

400

Bad Request

application/json

put

/core/v1/employees/{employeeId}/bpjs-healthcare-memberships

cURLPython SDK

curl -X PUT \
  "https://api.catapa.com/core/v1/employees/0ab1c2d3-e4f5-6789-0123-456789abcdef/bpjs-healthcare-memberships" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id" \
  -H "Content-Type: application/json" \
  -d '{
  "additionalFamilyMemberships": [
    {
      "dentalHealthcareFacility": "dental",
      "familyMemberName": "Alfian Hanafi",
      "familyMemberRelationId": "1f29ea4e-a7e9-11e6-80f5-76304dec7eb7",
      "firstLevelHealthcareFacility": "Level 1",
      "id": "af4a47376-e964-4cb2-a6b5-d540b17bfea0"
    }
  ],
  "bpjsHealthcareProviderId": "11f6b427-b7a8-11e6-b782-d0bf9cdd43ca",
  "bpjsHealthcareTemplateId": "38322fb6-b129-11e6-80f5-76304dec7eb7",
  "bpjsHealthcareTreatmentClassId": "3f0afd17-af9a-4274-a3da-7cba7f96b7f1",
  "dentalHealthcareFacility": "dental",
  "firstLevelHealthcareFacility": "first level",
  "membershipNumber": "555556666",
  "startDate": "2022-11-11",
  "effectiveDate": "2022-11-11"
}'

{
  "id": "6c571c34-9981-4223-ae04-f21647edec5e",
  "employeeId": "532eba49-1784-4224-9e0c-c8e70db96697",
  "membershipNumber": "34235",
  "startDate": "2025-01-01",
  "effectiveDate": "2025-07-01",
  "firstLevelHealthcareFacility": "healthcare",
  "dentalHealthcareFacility": "dental",
  "bpjsHealthcareProvider": {
    "id": "29b37992-6b61-4f8e-85f4-78b664847b9b",
    "code": "001",
    "name": "BPJS Kesehatan Cabang Bandung",
    "address": "Jl. Khp Hasan Mustopa No.81, Cikutra, Kec. Cibeunying Kidul, Kota Bandung, Jawa Barat 40124",
    "registrationNumber": "556332",
    "reportSignatoryName": "Budi",
    "reportSignatoryJobTitle": "Manager"
  },
  "bpjsHealthcareTemplate": {
    "id": "178f77de-39a0-48b4-8c33-89ff256ccf35",
    "code": "001",
    "name": "BPJS KS",
    "salaryType": "BY_SALARY_DECREE",
    "linkToPayroll": true
  },
  "bpjsHealthcareTreatmentClass": {
    "id": "3f0afd17-af9a-4274-a3da-7cba7f96b7f1",
    "name": "CLASS 1",
    "minSalaryType": "UMP",
    "minSalaryValue": "5000000",
    "maxSalaryType": "UMP",
    "maxSalaryValue": "10000000"
  },
  "additionalFamilyMemberships": [
    {
      "id": "62cecc2b-cff9-46ec-91f5-11235e1969ad",
      "familyMemberName": "Siti Rahayu",
      "familyMemberRelation": {
        "id": "1f29ea4e-a7e9-11e6-80f5-76304dec7eb7",
        "name": "Ibu Kandung",
        "code": "Ibu Kandung",
        "relationType": "MOTHER"
      },
      "firstLevelHealthcareFacility": "first level",
      "dentalHealthcareFacility": "dental"
    },
    {
      "id": "ccad2cc6-e02e-4770-add3-f4226857d47f",
      "familyMemberName": "Ahmad Suryanto",
      "familyMemberRelation": {
        "id": "1f29e7ec-a7e9-11e6-80f5-76304dec7eb7",
        "name": "Ayah Kandung",
        "code": "Ayah Kandung",
        "relationType": "FATHER"
      },
      "firstLevelHealthcareFacility": "first level",
      "dentalHealthcareFacility": "dental"
    }
  ]
}

Get BPJS Manpower Membership

get

Return the BPJS manpower memberships.

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

ID of the BPJS Manpower Membership

membershipNumberstringOptional

startDatestringOptional

endDatestringOptional

effectiveDatestringOptional

pensionEndstringOptional

400

Bad Request

get

/core/v1/employees/{employeeId}/bpjs-manpower-memberships

cURLPython SDK

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

{
  "id": "f0ff94df-aac6-49ac-8da2-c34a63159b56",
  "bpjsManpowerProvider": {
    "id": "3cb8182b-639b-4897-b124-2b5bffcfdd63",
    "code": "001",
    "name": "BPJS Bandung",
    "address": "Bandung",
    "registrationNumber": "63456456346",
    "reportSignatoryName": "",
    "reportSignatoryJobTitle": ""
  },
  "membershipNumber": "345345",
  "startDate": "2025-01-01",
  "endDate": "",
  "bpjsManpowerTemplate": {
    "id": "19523198-8d9e-44f1-a14d-5e6d747ea4d2",
    "code": "001",
    "name": "BPJS TK",
    "salaryType": "BY_PRORATED_SALARY",
    "linkToPayroll": true
  },
  "pensionEnd": "",
  "effectiveDate": "2025-01-01"
}

Update BPJS Manpower Membership

put

Update the BPJS manpower membership.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

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

Body

application/json

bpjsManpowerProviderIdstringRequired

bpjsManpowerTemplateIdstringRequired

membershipNumberstringOptional

startDatestringRequired

effectiveDatestringOptional

Effective Date of the BPJS Manpower Membership default value is start date

Responses

200

OK

application/json

idstringOptional

ID of the BPJS Manpower Membership

membershipNumberstringOptional

startDatestringOptional

endDatestringOptional

effectiveDatestringOptional

pensionEndstringOptional

400

Bad Request

application/json

put

/core/v1/employees/{employeeId}/bpjs-manpower-memberships

cURLPython SDK

curl -X PUT \
  "https://api.catapa.com/core/v1/employees/0ab1c2d3-e4f5-6789-0123-456789abcdef/bpjs-manpower-memberships" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id" \
  -H "Content-Type: application/json" \
  -d '{
  "bpjsManpowerProviderId": "11f6b427-b7a8-11e6-b782-d0bf9cdd43ca",
  "bpjsManpowerTemplateId": "48322fb6-b129-11e6-80f5-76304dec7eb7",
  "membershipNumber": "555556666",
  "startDate": "2022-11-11",
  "effectiveDate": "2022-11-11"
}'

{
  "id": "f0ff94df-aac6-49ac-8da2-c34a63159b56",
  "bpjsManpowerProvider": {
    "id": "3cb8182b-639b-4897-b124-2b5bffcfdd63",
    "code": "001",
    "name": "BPJS Bandung",
    "address": "Bandung",
    "registrationNumber": "63456456346",
    "reportSignatoryName": "",
    "reportSignatoryJobTitle": ""
  },
  "membershipNumber": "345345",
  "startDate": "2025-01-01",
  "endDate": "",
  "bpjsManpowerTemplate": {
    "id": "19523198-8d9e-44f1-a14d-5e6d747ea4d2",
    "code": "001",
    "name": "BPJS TK",
    "salaryType": "BY_PRORATED_SALARY",
    "linkToPayroll": true
  },
  "pensionEnd": "",
  "effectiveDate": "2025-01-01"
}