curl --request GET \
--url https://api.instaview.sk/jobs/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.instaview.sk/jobs/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.instaview.sk/jobs/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.instaview.sk/jobs/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.instaview.sk/jobs/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.instaview.sk/jobs/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.instaview.sk/jobs/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "987e6543-e21b-12d3-a456-426614174000",
"title": "Senior TypeScript Developer",
"status": "OPEN",
"createdAt": "2024-11-16T10:30:00Z",
"updatedAt": "2024-11-16T10:30:00Z",
"description": "We are looking for an experienced TypeScript developer...",
"jobUrl": "https://company.com/careers/senior-typescript-dev",
"benefits": "Health insurance, remote work, flexible hours",
"requiredSkills": [
"TypeScript",
"React",
"Node.js"
],
"niceToHaveSkills": [
"Docker",
"AWS"
],
"languageRequirements": [
{
"language": "EN",
"proficiency": "B2"
},
{
"language": "SK",
"proficiency": "C1"
}
],
"education": [
"BACHELORS"
],
"experience": "SENIOR",
"contractType": "FULL_TIME",
"location": {
"workMode": "REMOTE",
"street": "Hlavná 123",
"city": "Bratislava",
"postalCode": "81101",
"countryCode": "SK"
},
"salary": {
"min": 50000,
"max": 80000,
"currency": "USD",
"period": "YEARLY"
},
"metadata": {
"externalJobId": "JOB-12345",
"department": "Engineering"
}
}Get Job
Returns a single job, ensuring it belongs to the API key’s company.
curl --request GET \
--url https://api.instaview.sk/jobs/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.instaview.sk/jobs/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.instaview.sk/jobs/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.instaview.sk/jobs/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.instaview.sk/jobs/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.instaview.sk/jobs/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.instaview.sk/jobs/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "123e4567-e89b-12d3-a456-426614174000",
"companyId": "987e6543-e21b-12d3-a456-426614174000",
"title": "Senior TypeScript Developer",
"status": "OPEN",
"createdAt": "2024-11-16T10:30:00Z",
"updatedAt": "2024-11-16T10:30:00Z",
"description": "We are looking for an experienced TypeScript developer...",
"jobUrl": "https://company.com/careers/senior-typescript-dev",
"benefits": "Health insurance, remote work, flexible hours",
"requiredSkills": [
"TypeScript",
"React",
"Node.js"
],
"niceToHaveSkills": [
"Docker",
"AWS"
],
"languageRequirements": [
{
"language": "EN",
"proficiency": "B2"
},
{
"language": "SK",
"proficiency": "C1"
}
],
"education": [
"BACHELORS"
],
"experience": "SENIOR",
"contractType": "FULL_TIME",
"location": {
"workMode": "REMOTE",
"street": "Hlavná 123",
"city": "Bratislava",
"postalCode": "81101",
"countryCode": "SK"
},
"salary": {
"min": 50000,
"max": 80000,
"currency": "USD",
"period": "YEARLY"
},
"metadata": {
"externalJobId": "JOB-12345",
"department": "Engineering"
}
}Overview
Returns everything held about one job posting — useful before attaching a contact to it, for checking its configuration, or for displaying it in your own application.Use Cases
- Job Details Display: Show complete job information in your UI
- Pre-flight check: confirm the job exists and is reachable by your key before attaching contacts
- Job Configuration Review: Inspect job settings and requirements
- Integration Validation: Confirm job details match external systems
Response Data
The response includes all job information:- Basic details (title, description, status)
- Skills requirements (required and nice-to-have)
- Location and work mode
- Salary information
- Language requirements
- Timestamps (created, updated)
Company Isolation
You can only access jobs that belong to your API key’s company. A job from another company answers404 Not Found — the same status and the same body as an id that exists nowhere, so the response never confirms that an id exists somewhere else.
Error Scenarios
- 404 Not Found: No job with that id is available to your API key. It does not exist, it has been deleted, or it belongs to another company — the three are deliberately indistinguishable, so do not branch on this status to detect a permission problem.
Related Resources
Jobs Resource Guide
Update Job
List Jobs
Authorizations
API key for authentication using Bearer scheme
Path Parameters
Query Parameters
Required for ATS API keys to specify which company to access. Ignored for standard company API keys.
Response
Job ID
"123e4567-e89b-12d3-a456-426614174000"
Company ID
"987e6543-e21b-12d3-a456-426614174000"
Job title
"Senior TypeScript Developer"
Job status
UNDEFINED, OPEN, CLOSED "OPEN"
Created timestamp
"2024-11-16T10:30:00Z"
Updated timestamp
"2024-11-16T10:30:00Z"
Job description
"We are looking for an experienced TypeScript developer..."
Job URL
"https://company.com/careers/senior-typescript-dev"
Benefits
"Health insurance, remote work, flexible hours"
Required skills
["TypeScript", "React", "Node.js"]
Nice-to-have skills
["Docker", "AWS"]
Language requirements with proficiency levels
Show child attributes
Show child attributes
[
{ "language": "EN", "proficiency": "B2" },
{ "language": "SK", "proficiency": "C1" }
]
Education requirements
["BACHELORS"]
Experience level
"SENIOR"
Contract type
"FULL_TIME"
Location information
Show child attributes
Show child attributes
Salary range
Show child attributes
Show child attributes
{
"min": 50000,
"max": 80000,
"currency": "USD",
"period": "YEARLY"
}
Custom metadata
{
"externalJobId": "JOB-12345",
"department": "Engineering"
}