Job Experience

These endpoints let you manage job experience records for employees in the system. It allows you to retrieve job experience approval records.

Get Job Experience Approvals By Employee

get

Return paginated job experience approvals for a specific employee.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

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

Query parameters

pageintegerOptional

Page number

Default: 0Example: 0

sizeinteger · min: 1 · max: 50Optional

Page size

Default: 10Example: 10

querystringOptional

Search Query

Supported Keys	Supported Operators	Notes
approvalStatus	:	Equal operator. Values: APPROVED, REJECTED, OPEN, WAITING_FOR_APPROVAL

Example: {"summary":"Search by approval status","value":"approvalStatus:WAITING_FOR_APPROVAL"}

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/employees/{employeeId}/job-experiences/approvals

cURLPython SDK

curl -X GET \
  "https://api.catapa.com/core/v1/employees/0ab1c2d3-e4f5-6789-0123-456789abcdef/job-experiences/approvals?page=0&size=10&query=approvalStatus%3AWAITING_FOR_APPROVAL" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "companyName": "PT Acme Corp",
      "jobTitle": "Software Engineer",
      "jobLevel": "Senior",
      "startDate": "2020-01-15",
      "endDate": "2023-06-30",
      "companyBusiness": "Technology",
      "terminationReasonInput": "Career growth",
      "companyLocation": "Jakarta",
      "lastSalary": 15000000,
      "employee": {
        "id": "0ab1c2d3-e4f5-6789-0123-456789abcdef",
        "identificationNumber": "ID-0001",
        "name": "John Doe",
        "employmentStatus": {
          "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
          "employmentStatusNumber": "ES-0001",
          "effectiveDate": "2020-01-15",
          "organization": {
            "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "name": "Engineering",
            "code": "ENG",
            "type": "STRUCTURAL",
            "company": {
              "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
              "name": "PT Acme Corp",
              "code": "ACME"
            }
          },
          "jobLevel": {
            "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
            "name": "Senior",
            "code": "SR",
            "level": 5
          },
          "employmentType": {
            "id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
            "name": "Permanent"
          },
          "jobTitle": {
            "id": "a7b8c9d0-e1f2-3456-abcd-567890123456",
            "name": "Software Engineer"
          },
          "location": {
            "id": "b8c9d0e1-f2a3-4567-bcde-678901234567",
            "name": "Jakarta"
          },
          "costCenter": {
            "id": "c9d0e1f2-a3b4-5678-cdef-234567890123",
            "code": "CC-001",
            "name": "Technology Cost Center"
          },
          "position": {
            "id": "d0e1f2a3-b4c5-6789-def0-345678901234",
            "code": "POS-001",
            "name": "Senior Position"
          }
        }
      },
      "references": [
        "ref-123",
        "ref-456"
      ],
      "jobExperience": {
        "id": "e1f2a3b4-c5d6-7890-ef01-456789012345",
        "companyName": "Previous Company",
        "jobTitle": "Junior Developer",
        "jobLevel": "Junior",
        "startDate": "2018-01-01",
        "endDate": "2020-01-14"
      },
      "approvalStatus": "WAITING_FOR_APPROVAL",
      "rejectionReason": "",
      "action": "ADD"
    }
  ],
  "totalPages": 1,
  "last": true,
  "totalElements": 1,
  "numberOfElements": 1,
  "sort": [
    {
      "direction": "DESC",
      "property": "updatedDate",
      "ignoreCase": false,
      "nullHandling": "NATIVE",
      "ascending": false,
      "descending": true
    }
  ],
  "first": true,
  "size": 10,
  "number": 0
}

Get Job Experience Approval By Employee And Id

get

Return a specific job experience approval for a specific employee.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

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

approvalIdstringRequiredExample: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Responses

200

OK

application/json

idstringOptional

companyNamestringOptional

jobTitlestringOptional

jobLevelstringOptional

startDatestring · dateOptional

endDatestring · dateOptional

companyBusinessstringOptional

terminationReasonInputstringOptional

companyLocationstringOptional

lastSalarynumberOptional

referencesstring[]Optional

approvalStatusstring · enumOptionalPossible values:

rejectionReasonstringOptional

actionstring · enumOptionalPossible values:

400

Bad Request

404

Not Found

get

/core/v1/employees/{employeeId}/job-experiences/approvals/{approvalId}

cURLPython SDK

curl -X GET \
  "https://api.catapa.com/core/v1/employees/0ab1c2d3-e4f5-6789-0123-456789abcdef/job-experiences/approvals/a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "companyName": "PT Acme Corp",
  "jobTitle": "Software Engineer",
  "jobLevel": "Senior",
  "startDate": "2020-01-15",
  "endDate": "2023-06-30",
  "companyBusiness": "Technology",
  "terminationReasonInput": "Career growth",
  "companyLocation": "Jakarta",
  "lastSalary": 15000000,
  "employee": {
    "id": "0ab1c2d3-e4f5-6789-0123-456789abcdef",
    "identificationNumber": "ID-0001",
    "name": "John Doe",
    "employmentStatus": {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "employmentStatusNumber": "ES-0001",
      "effectiveDate": "2020-01-15",
      "organization": {
        "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
        "name": "Engineering",
        "code": "ENG",
        "type": "STRUCTURAL",
        "company": {
          "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
          "name": "PT Acme Corp",
          "code": "ACME"
        }
      },
      "jobLevel": {
        "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
        "name": "Senior",
        "code": "SR",
        "level": 5
      },
      "employmentType": {
        "id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
        "name": "Permanent"
      },
      "jobTitle": {
        "id": "a7b8c9d0-e1f2-3456-abcd-567890123456",
        "name": "Software Engineer"
      },
      "location": {
        "id": "b8c9d0e1-f2a3-4567-bcde-678901234567",
        "name": "Jakarta"
      },
      "costCenter": {
        "id": "c9d0e1f2-a3b4-5678-cdef-234567890123",
        "code": "CC-001",
        "name": "Technology Cost Center"
      },
      "position": {
        "id": "d0e1f2a3-b4c5-6789-def0-345678901234",
        "code": "POS-001",
        "name": "Senior Position"
      }
    }
  },
  "references": [
    "ref-123",
    "ref-456"
  ],
  "jobExperience": {
    "id": "e1f2a3b4-c5d6-7890-ef01-456789012345",
    "companyName": "Previous Company",
    "jobTitle": "Junior Developer",
    "jobLevel": "Junior",
    "startDate": "2018-01-01",
    "endDate": "2020-01-14"
  },
  "approvalStatus": "WAITING_FOR_APPROVAL",
  "rejectionReason": "",
  "action": "ADD"
}

Get Job Experience Approvals

get

Return paginated job experience approvals across all employees.

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

querystringOptional

Search Query

Supported Keys	Supported Operators	Notes
employee.id	:	Equal operator with multiple values. Each value should separated with delimiters ;
approvalStatus	:	Equal operator. Values: APPROVED, REJECTED, OPEN, WAITING_FOR_APPROVAL

Example: {"summary":"Search by employee ID","value":"employee.id:0ab1c2d3-e4f5-6789-0123-456789abcdef"}

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/job-experiences/approvals

cURLPython SDK

curl -X GET \
  "https://api.catapa.com/core/v1/job-experiences/approvals?page=0&size=10&query=employee.id%3A0ab1c2d3-e4f5-6789-0123-456789abcdef" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Tenant: your-tenant-id"

{
  "content": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "companyName": "PT Acme Corp",
      "jobTitle": "Software Engineer",
      "jobLevel": "Senior",
      "startDate": "2020-01-15",
      "endDate": "2023-06-30",
      "companyBusiness": "Technology",
      "terminationReasonInput": "Career growth",
      "companyLocation": "Jakarta",
      "lastSalary": 15000000,
      "employee": {
        "id": "0ab1c2d3-e4f5-6789-0123-456789abcdef",
        "identificationNumber": "ID-0001",
        "name": "John Doe",
        "employmentStatus": {
          "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
          "employmentStatusNumber": "ES-0001",
          "effectiveDate": "2020-01-15",
          "organization": {
            "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "name": "Engineering",
            "code": "ENG",
            "type": "STRUCTURAL",
            "company": {
              "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
              "name": "PT Acme Corp",
              "code": "ACME"
            }
          },
          "jobLevel": {
            "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
            "name": "Senior",
            "code": "SR",
            "level": 5
          },
          "employmentType": {
            "id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
            "name": "Permanent"
          },
          "jobTitle": {
            "id": "a7b8c9d0-e1f2-3456-abcd-567890123456",
            "name": "Software Engineer"
          },
          "location": {
            "id": "b8c9d0e1-f2a3-4567-bcde-678901234567",
            "name": "Jakarta"
          },
          "costCenter": {
            "id": "c9d0e1f2-a3b4-5678-cdef-234567890123",
            "code": "CC-001",
            "name": "Technology Cost Center"
          },
          "position": {
            "id": "d0e1f2a3-b4c5-6789-def0-345678901234",
            "code": "POS-001",
            "name": "Senior Position"
          }
        }
      },
      "references": [
        "ref-123",
        "ref-456"
      ],
      "jobExperience": {
        "id": "e1f2a3b4-c5d6-7890-ef01-456789012345",
        "companyName": "Previous Company",
        "jobTitle": "Junior Developer",
        "jobLevel": "Junior",
        "startDate": "2018-01-01",
        "endDate": "2020-01-14"
      },
      "approvalStatus": "WAITING_FOR_APPROVAL",
      "rejectionReason": "",
      "action": "ADD"
    }
  ],
  "totalPages": 1,
  "last": true,
  "totalElements": 1,
  "numberOfElements": 1,
  "sort": [
    {
      "direction": "DESC",
      "property": "updatedDate",
      "ignoreCase": false,
      "nullHandling": "NATIVE",
      "ascending": false,
      "descending": true
    }
  ],
  "first": true,
  "size": 10,
  "number": 0
}