Job Category List

get
Job Category List

https://apigateway.boost.rs/job-categories
This endpoint retrieves a list of job categories.
Request
Response
Request
Headers
Authorization
required
string
Authorisation token received from oAuth API Bearer :token
Query Parameters
offset
optional
integer
This parameter is used to retrieve paginated results. The default setting is 0. For a specific page, set offset to be: (#pageNumber - 1) * limit
limit
optional
integer
Number of records to return. Default setting is 10 records. Can take values between 1 and 100.
parent_id
optional
integer
Filter categories based on their parent
with_items
optional
boolean
Filter categories which contain jobs or do not contain jobs.
Response
200: OK
Job category list successfully retrieved
{
"success": true,
"message": "",
"result": [
{
"id": 483,
"name": "Alabama",
"description": null,
"external_id": null,
"status": "active",
"parent_id": null,
"children_count": 3,
"jobs_count": 0,
"has_subcategories": true,
"has_jobs": false,
"translations": {
"en": {
"name": "Alabama",
"description": null
}
},
"benchmark": null
},
{
"id": 1791,
"name": "Am mai bagat eu o categorie",
"description": null,
"external_id": null,
"status": "active",
"parent_id": null,
"children_count": 0,
"jobs_count": 0,
"has_subcategories": false,
"has_jobs": false,
"translations": {
"en": {
"name": "Am mai bagat eu o categorie",
"description": null
}
},
"benchmark": null
},
{
"id": 1795,
"name": "Black farm",
"description": null,
"external_id": null,
"status": "active",
"parent_id": null,
"children_count": 0,
"jobs_count": 0,
"has_subcategories": false,
"has_jobs": false,
"translations": {
"en": {
"name": "Black farm",
"description": null
}
},
"benchmark": null
},
{
"id": 1802,
"name": "Blue farm",
"description": null,
"external_id": null,
"status": "active",
"parent_id": null,
"children_count": 0,
"jobs_count": 0,
"has_subcategories": false,
"has_jobs": false,
"translations": {
"en": {
"name": "Blue farm",
"description": null
}
},
"benchmark": null
},
{
"id": 485,
"name": "Cat de cat decent",
"description": null,
"external_id": null,
"status": "active",
"parent_id": 1778,
"children_count": 0,
"jobs_count": 0,
"has_subcategories": false,
"has_jobs": false,
"translations": {
"en": {
"name": "Cat de cat decent",
"description": null
}
},
"benchmark": null
},
{
"id": 1804,
"name": "Category 1",
"description": "asddsa",
"external_id": "12345",
"status": "active",
"parent_id": null,
"children_count": 1,
"jobs_count": 0,
"has_subcategories": true,
"has_jobs": false,
"translations": {
"en": {
"name": "Category 1",
"description": "asddsa"
}
},
"benchmark": null
},
{
"id": 47,
"name": "Developmentt",
"description": " ",
"external_id": null,
"status": "active",
"parent_id": 483,
"children_count": 0,
"jobs_count": 4,
"has_subcategories": false,
"has_jobs": true,
"translations": {
"en": {
"name": "Developmentt",
"description": null
},
"fr": {
"name": "Développement",
"description": null
}
},
"benchmark": {
"remote_index": 94,
"automation_index": 37
}
},
{
"id": 1740,
"name": "DevOps aproximativ",
"description": null,
"external_id": null,
"status": "active",
"parent_id": null,
"children_count": 0,
"jobs_count": 9,
"has_subcategories": false,
"has_jobs": true,
"translations": {
"en": {
"name": "DevOps aproximativ",
"description": null
}
},
"benchmark": {
"remote_index": 92,
"automation_index": 53
}
},
{
"id": 1799,
"name": "Don't drink and vote",
"description": null,
"external_id": null,
"status": "active",
"parent_id": null,
"children_count": 0,
"jobs_count": 3,
"has_subcategories": false,
"has_jobs": true,
"translations": {
"en": {
"name": "Don't drink and vote",
"description": null
}
},
"benchmark": null
},
{
"id": 1806,
"name": "dsa",
"description": "asd",
"external_id": "asd",
"status": "active",
"parent_id": 1803,
"children_count": 0,
"jobs_count": 0,
"has_subcategories": false,
"has_jobs": false,
"translations": {
"en": {
"name": "dsa",
"description": "asd"
}
},
"benchmark": null
}
]
}

Response fields

Field name

Description

id

Category ID

name

Category title

description

Category description

external_id

Alphanumeric value (optional) which can be set by the client for external cross-referencing purposes.

status

Category status. Available values:

active - the category is ready for use (completed)

draft - the category content might not be the final (it might not be ready for use)

parent_id

The ID of the parent category

children_count

The number of sub-categories that exist in the current category

jobs_count

The number of jobs that exist in the current category

has_subcategories

Boolean value.

true - the category contains sub-categories

false - the category does not contain sub-categories

has_jobs

Boolean value.

true - the category contains jobs

false - the category does not contain any jobs

translations

Group of fields containing the available translations (per language) for the category title and description, if available.

Translation fields: en, fr - language codes name - category title description - category description

benchmark

Benchmark fields:

remote_index - the category's remote work index (values range: 0 to 100)

automation_index - the category's automation index (value range: 0 to 100)

repository

The section provides the fields related to the parent repository.

Repository fields:

id

name

description

external_id

status

has_categories

For more information see Job Repository Details.