---
title: Job
slug: job
docTags: 
createdAt: 2025-08-08T10:56:19.419Z
---

**Actions**

| Name            | Description                         |
| --------------- | ----------------------------------- |
| created         | Job created                         |
| updated         | Job was updated                     |
| status\_changed | Job status was specifically updated |

**Request Payload**

| Name        | Type   | Description                             |
| ----------- | ------ | --------------------------------------- |
| event\_type | string | "job"                                   |
| action      | string | Action triggering the event (see above) |
| job         | object | The [job](#) object                     |

## Job Object

| Name             | Type          | Description                                                                                                                                                                                                               |
| ---------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id               | integer       | Job ID                                                                                                                                                                                                                    |
| title            | string        | Title of the job                                                                                                                                                                                                          |
| description      | string        | Job description                                                                                                                                                                                                           |
| skills           | string        | Job skills                                                                                                                                                                                                                |
| from\_date       | string (date) | Date job first created                                                                                                                                                                                                    |
| to\_date         | string (date) | Deadline for the job                                                                                                                                                                                                      |
| contact\_name    | string        | Contact name                                                                                                                                                                                                              |
| contact\_email   | string        | Contact email                                                                                                                                                                                                             |
| url              | string (URL)  | URL of job ad                                                                                                                                                                                                             |
| language         | string        | The [language](docId:_IO2-SJeUjv6VGTRTGYoZ) of the job                                                                                                                                                                    |
| location\_set    | array         | The [location(s)](docId:_IO2-SJeUjv6VGTRTGYoZ) of the job                                                                                                                                                                 |
| categories       | array         | The [categories](docId:_IO2-SJeUjv6VGTRTGYoZ) that this job belongs to                                                                                                                                                    |
| departments      | array         | The [departments](docId:_IO2-SJeUjv6VGTRTGYoZ) that this job belongs to                                                                                                                                                   |
| layers\_X        | array         | The [layers](docId:_IO2-SJeUjv6VGTRTGYoZ) that this job belongs to.<br />For each layer an layers\_x field is present. See [example](docId:_IO2-SJeUjv6VGTRTGYoZ). (X is the dimension to which the layer options belong) |
| status           | string        | The [job status](docId:_IO2-SJeUjv6VGTRTGYoZ) value                                                                                                                                                                       |
| visibility       | string        | The [visibility](docId\:qkMSBu_bu56kiGKrn7Bcj) of the job                                                                                                                                                                 |
| company          | object        | The [company](docId:_IO2-SJeUjv6VGTRTGYoZ) object                                                                                                                                                                         |
| owner            | object        | The [user](docId:_IO2-SJeUjv6VGTRTGYoZ) that owns the job                                                                                                                                                                 |
| employment\_type | object        | The [employment type](docId:_IO2-SJeUjv6VGTRTGYoZ) object                                                                                                                                                                 |
| experience       | object        | The [experience](docId:_IO2-SJeUjv6VGTRTGYoZ) object                                                                                                                                                                      |
| function         | object        | The [function](docId:_IO2-SJeUjv6VGTRTGYoZ) object                                                                                                                                                                        |

### Job Status

| Value       | Description |
| ----------- | ----------- |
| 'draft'     | Draft       |
| 'published' | Published   |
| 'closed'    | Closed      |
| 'archived'  | Archived    |

### Category

| Name | Type    | Description          |
| ---- | ------- | -------------------- |
| id   | integer | Category ID          |
| text | string  | Category description |

### Company

| Name       | Type         | Description                                                                       |
| ---------- | ------------ | --------------------------------------------------------------------------------- |
| id         | integer      | Company ID                                                                        |
| name       | string       | Name                                                                              |
| users\_url | string (URL) | Time-limited link to an list of users that have access to the job and their roles |

### Department

| Name | Type    | Description     |
| ---- | ------- | --------------- |
| id   | integer | Department ID   |
| name | string  | Department name |

### Experience

| Name | Type    | Description            |
| ---- | ------- | ---------------------- |
| id   | integer | Experience ID          |
| text | string  | Experience description |

### Employment Type

| Name | Type    | Description                |
| ---- | ------- | -------------------------- |
| id   | integer | EmploymentType ID          |
| text | string  | EmploymentType description |

### Function

| Name | Type    | Description          |
| ---- | ------- | -------------------- |
| id   | integer | Function ID          |
| text | string  | Function description |

### Language

| Value | Description |
| ----- | ----------- |
| 'da'  | Dansk       |
| 'de'  | Deutsch     |
| 'en'  | English     |
| 'fi'  | Suomi       |
| 'fr'  | Français    |
| 'nb'  | Norsk       |
| 'nl'  | Nederlands  |
| 'sv'  | Svenska     |

### Layer

| Name                 | Type    | Description          |
| -------------------- | ------- | -------------------- |
| id                   | integer | Layer ID             |
| identifier           | string  | Slug based on "text" |
| external\_identifier | string  | External identifier  |
| description          | string  | Layer description    |
| text                 | string  | Layer name           |

### Location

| Name           | Type   | Description                                    |
| -------------- | ------ | ---------------------------------------------- |
| location       | string | Name of the location                           |
| location\_json | object | Object based on the data from Google's map API |

### Recommended By

| Name  | Type   | Description |
| ----- | ------ | ----------- |
| name  | string | Name        |
| email | string | Email       |

### User

| Name  | Type    | Description |
| ----- | ------- | ----------- |
| id    | integer | User ID     |
| name  | string  | Name        |
| email | string  | Email       |

### UserRole

| Name           | Type    | Description    |
| -------------- | ------- | -------------- |
| id             | integer | User ID        |
| first\_name    | string  | First name     |
| last\_name     | string  | Last name      |
| role           | string  | User [role](#) |
| email\_primary | string  | Email          |
| emails         | array   | Email          |

### Visibility

| Value      | Description   |
| ---------- | ------------- |
| 'external' | Public jobs   |
| 'internal' | Internal jobs |