API Documentation
Taxonomy
- Domains
- Subdomains
- Skill Clusters
- Skills
- Taxonomy operations
Employees
- CRUD
- Skill Profile
- Metrics
- Search
- Skill Events
- Interactions
- Suggestions
Job Families
- CRUD
- Skill Profile
- Job Family Profile Data
Jobs
- CRUD
- Skill Profile
- Job Profile Data
- Metrics
Vacancies
- CRUD
- Skill Profile
- Metrics
- Search
Courses
- CRUD
- Skill Profile
- Metrics
Skill Clusters
- CRUD
- Skill Profile
- Metrics
External Companies
- CRUD
- Search
Skills
- Skill Search
- Skill Gaps
- Skill Lookup
Organisational Structure
- Organisational Units
Custom Properties
- Definitions
- Properties
Matchmaking
- Vacancy Matching
- Course Recommendations
- External Company Matching
- Job Matching
- Job Family Matching
- Match Feedback
Matching Configuration
Export
- Employees
- Job Architecture
- Courses
- Employees Assigned Position
- Taxonomy
- Organisational Structure
Reports
- General Reports
- Employee Reports
- Vacancy Reports
- Job Reports
- Data Maturity Scan
Version
- Version
List External Company's Vacancies
Get an overview of all the Vacancies stored inside the system that are linked to the specified External Company.
curl --request GET \
--url https://{tenant_name}.{region}.techwolf.ai/companies/{external_id}/vacancies \
--header 'Authorization: Bearer <token>'
{
"count": 3,
"results": [
{
"external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
"job_title": "Staffing coordinator",
"job_description": "We are looking for a competent Staffing coordinator to undertake a variety of tasks such as recruitment, orientation and placement of Employees. You will also be the one to ensure that the Company complies with all relevant laws regarding employment.",
"location": {
"lat": 51.0216707,
"lng": 2.6887328
},
"company": "8cbdbdbe-5f44-4423-8157-520f8a2f429a",
"active": true,
"last_updated": "2021-01-21T17:32:28Z"
},
{
"external_id": "62d2c013-ab77-410e-b5fb-2f96eed9c1db",
"job_title": "HR assistant",
"job_description": "We are looking for an HR Assistant to undertake a variety of HR administrative duties.",
"location": {
"lat": 50.0216707,
"lng": 3.6887328
},
"company": "9abdbdbe-5f44-4423-8157-520f8a2f429a",
"active": true,
"last_updated": "2021-01-22T15:02:00Z"
},
{
"external_id": "6129e3f1-663f-44ea-aa3f-2ce1077b834c",
"job_title": "HR analyst",
"job_description": "We are looking for an HR Analyst to gather and process qualitative and quantitative data around jobs, compensation and employment trends.",
"location": {
"lat": 51.0516707,
"lng": 4.6887328
},
"company": "9hbdbdbe-5f44-4423-8157-520f8a2f429a",
"active": true,
"last_updated": "2021-01-21T17:46:29Z"
}
]
}
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.
1 - 100
Response
Total number of Vacancy objects stored inside the system.
x > 0
Subset of Vacancies starting from offset
up to offset + limit
.
The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.
1 - 100
Title of the Vacancy.
1 - 255
Textual description of the Vacancy (job posting).
1
Timestamp of the last update to this entity.
The Vacancy will not be used in matching if active is false
. This is useful when a Vacancy is being phased out.
List of ISO 639-1 codes for languages required by the Vacancy, combined with the proficiency level. The proficiency levels go from 1 (elementary proficiency) to 5 (native proficiency). If the level is omitted, the default proficiency level of 2 is used.
external_id from the External Company the Vacancy is linked to.
1
A geographic location, expressed in latitude and longitude. This can represent a home address, an office location... Each entity is limited to having a single location. To get the latitude and longitude for a given address, you can use the Google Maps Geocoding API or a predefined lookup table (for example by zip code). If location is present in matching or filters, it will act as an override for geo-distance calculations.
Was this page helpful?
curl --request GET \
--url https://{tenant_name}.{region}.techwolf.ai/companies/{external_id}/vacancies \
--header 'Authorization: Bearer <token>'
{
"count": 3,
"results": [
{
"external_id": "5cbdbdbe-5f44-4423-8157-520f8a2f429a",
"job_title": "Staffing coordinator",
"job_description": "We are looking for a competent Staffing coordinator to undertake a variety of tasks such as recruitment, orientation and placement of Employees. You will also be the one to ensure that the Company complies with all relevant laws regarding employment.",
"location": {
"lat": 51.0216707,
"lng": 2.6887328
},
"company": "8cbdbdbe-5f44-4423-8157-520f8a2f429a",
"active": true,
"last_updated": "2021-01-21T17:32:28Z"
},
{
"external_id": "62d2c013-ab77-410e-b5fb-2f96eed9c1db",
"job_title": "HR assistant",
"job_description": "We are looking for an HR Assistant to undertake a variety of HR administrative duties.",
"location": {
"lat": 50.0216707,
"lng": 3.6887328
},
"company": "9abdbdbe-5f44-4423-8157-520f8a2f429a",
"active": true,
"last_updated": "2021-01-22T15:02:00Z"
},
{
"external_id": "6129e3f1-663f-44ea-aa3f-2ce1077b834c",
"job_title": "HR analyst",
"job_description": "We are looking for an HR Analyst to gather and process qualitative and quantitative data around jobs, compensation and employment trends.",
"location": {
"lat": 51.0516707,
"lng": 4.6887328
},
"company": "9hbdbdbe-5f44-4423-8157-520f8a2f429a",
"active": true,
"last_updated": "2021-01-21T17:46:29Z"
}
]
}