Get Company Job List

GET /cloud/Data/V1/CompanyJobList

Retrieve a list of company jobs based on specified job family and job level parameters. This API endpoint allows access to comprehensive job data, including job titles, descriptions, and other relevant information.

URL

https://companalystapi.salary.com/cloud/Data/V1/CompanyJobList

Method

GET

Request Headers

Authorization: Bearer {AccessToken}

Request Parameters

JobFamily: only return records in a specific Job Family

JobLevel: only return records in a specific Job Level

Glossary

Refer to Company Jobs

Example Request

If you want to get all the company jobs, please remove job family and job level. Otherwise, please provide specific job family or/and job level to return related jobs.

  curl --request GET \
  --url https://companalystapi.salary.com/cloud/Data/V1/CompanyJobList?JobFamily=Finance&JobLevel=Entry
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Response Model

The response is a JSON object containing various details about the job, such as its code, title, description, job family, and other relevant information.

Successful call with data

200: OK -The request was successful, and the detailed job information is returned as expected.

[
    {
        "CompanyJobCode": "ACCT1",
        "CompanyJobTitle": "Accountant I",
        "JobFamily": "Accounting & Finance",
        "JobFunction": "Accounting",
        "JobFocus": "General Accounting",
        "JobLevel": "P1",
        "CompanyJobDesc": "Assists in maintaining financial records and ensuring that financial transactions are properly recorded.",
        "JobFLSAStatus": "Exempt",
        "Department": "Finance",
        "EEOCategorycode": "1",
        "JobCode": "FA06000001",
        "JobMatchCode": "JM02",
        "JobAdjustment": 0.12,
        "JobAdjustmentComment": "NA",
        "UDF_job family group": "FIN",
        "JobTypeCode": 0,
        "AlterCompanyJobCode": null,
        "IsDraft": false,
        "AvgEmpSalary": 45600,
        "UID": "4354DA0C-D9DD-4927-8E17-907FBB",
        "LastUpdateDate": "2020-08-15T10:17:21.103"
    },
    {
        "CompanyJobCode": "ACCT2",
        "CompanyJobTitle": "Accountant II",
        "JobFamily": "Accounting & Finance",
        "JobFunction": "Accounting",
        "JobFocus": "Financial Reporting",
        "JobLevel": "P2",
        "CompanyJobDesc": "Responsible for preparing financial statements and supporting documentation.",
        "JobFLSAStatus": "Exempt",
        "Department": "Finance",
        "EEOCategorycode": "1",
        "JobCode": "FA06000002",
        "JobMatchCode": "JM03",
        "JobAdjustment": 0.15,
        "JobAdjustmentComment": "NA",
        "UDF_job family group": "FIN",
        "JobTypeCode": 0,
        "AlterCompanyJobCode": null,
        "IsDraft": false,
        "AvgEmpSalary": 45600,
        "UID": "4354DA0C-D9DD-4927-8E17-907FBB",
        "LastUpdateDate": "2020-08-15T10:17:21.103"
    }
]

Successful call without data

200: OK - the requested jobs do not exist in the system per job family or job level, maybe invalid job family or job level provided, we cannot find any company jobs.

{
    "WEBAPIStatusCode": 1,
    "WEBAPIStatusDesc": "This companyjob does not exist."
}

Failed call

400: Bad Request - User use wrong parameters, or incorrect format of the call parameters.

{
    "StatusCode": 400,
    "Reason": "Bad Request"
}

404: Not Found – Invalid URL call used

{  
    "StatusCode": 41,
    "Reason": "Invalid WEB API"
}