Organization & lookup data

Get job creation options

Get supported values for job creation and lifecycle updates.

GET

/job-options

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

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

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.

Use Create a job to combine these options with the classification lookups.

Permissions

organization.read

Authorizations

Authorizationstringheaderrequired

Use Authorization: Bearer <api-credential>.

Response

Successful response.

X-API-Daily-Limitintegerheader

Daily account request allowance, when metered. Shared across API credentials.

Required range: 0 <= x

X-API-Daily-Remainingintegerheader

Requests remaining in the daily window after admission.

Required range: 0 <= x

X-API-Daily-Resetstringheader

Daily window reset time in UTC.

X-API-Monthly-Limitintegerheader

Monthly account request allowance, when metered. Shared across API credentials.

Required range: 0 <= x

X-API-Monthly-Remainingintegerheader

Requests remaining in the monthly window after admission.

Required range: 0 <= x

X-API-Monthly-Resetstringheader

Monthly window reset time in UTC.

X-Request-IDstringheader

Request correlation identifier. Supply this value when contacting support.

Example: 01J7Y8N9P0Q1R2S3T4U5V6W7X8

X-API-Contractstringheader

Response envelope contract version.

Example: canonical-v1

RateLimit-Limitintegerheader

Account request limit for capacity add-ons; effective credential request-unit limit for included legacy access.

Example: 600

RateLimit-Remainingintegerheader

Requests remaining for capacity add-ons, or request units for included legacy access.

Example: 598

RateLimit-Resetintegerheader

Seconds until the current minute window resets.

Example: 30

dataobjectrequired

Show child attributes

Still need help? Ask the team