Get job creation options

GET

/job-options

Get supported values for job creation and lifecycle updates.

Using the options

statuses.canSet: codes accepted by the status-update endpoint.

initialStatus is account_workflow: normal creation becomes active or pending approval according to the account configuration.

POST /jobs does not accept a lifecycle status.

canSet describes supported input, not whether a particular job passes approval and capacity checks.

Status 5 means active (In Progress). Approval and publication are separate.

Data conventions

Salary intervals: H hourly, D daily, W weekly, M monthly, Y yearly.

Locations and qualifications are text fields; currencies use their currency code.

For the full workflow, see Create a job.

Permissions

organization.read

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200

application/json

Successful response.

Headers

Bodyapplication/json

🟠400

🟠401

🟠403

🟠429

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cvviz.com/v1/job-options' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "data": {
        "jobTypes": [
            "Full Time"
        ],
        "educationLevels": [
            "Bachelor"
        ],
        "salaryIntervals": [
            "H",
            "D",
            "W",
            "M",
            "Y"
        ],
        "experienceUnit": "years",
        "initialStatus": "draft",
        "statuses": [
            {
                "code": 1,
                "label": "Draft",
                "canCreate": true,
                "canSet": true
            },
            {
                "code": 2,
                "label": "New",
                "canCreate": false,
                "canSet": true
            },
            {
                "code": 3,
                "label": "Pending Approval",
                "canCreate": false,
                "canSet": false
            },
            {
                "code": 4,
                "label": "Rejected",
                "canCreate": false,
                "canSet": true
            },
            {
                "code": 5,
                "label": "In Progress",
                "canCreate": true,
                "canSet": true
            },
            {
                "code": 6,
                "label": "On Hold",
                "canCreate": false,
                "canSet": false
            },
            {
                "code": 7,
                "label": "Paused",
                "canCreate": false,
                "canSet": false
            },
            {
                "code": 8,
                "label": "Filled",
                "canCreate": false,
                "canSet": false
            },
            {
                "code": 9,
                "label": "Cancelled",
                "canCreate": false,
                "canSet": false
            },
            {
                "code": 10,
                "label": "Closed",
                "canCreate": false,
                "canSet": false
            },
            {
                "code": 11,
                "label": "Archived",
                "canCreate": false,
                "canSet": false
            }
        ]
    }
}

List candidate stages for a job

List industries

Get job creation options

Using the options#

Data conventions#

Permissions#

Request

Responses

Using the options

Data conventions

Permissions