List jobs
curl --request GET \
--url https://api.instaview.sk/jobs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.instaview.sk/jobs"
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', 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",
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"
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")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.instaview.sk/jobs")
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{
"data": [
{
"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"
}
}
],
"total": 150,
"page": 1,
"limit": 20,
"totalPages": 8
}Jobs
List Jobs
Lists jobs for the API key’s company with pagination.
GET
/
jobs
List jobs
curl --request GET \
--url https://api.instaview.sk/jobs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.instaview.sk/jobs"
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', 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",
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"
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")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.instaview.sk/jobs")
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{
"data": [
{
"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"
}
}
],
"total": 150,
"page": 1,
"limit": 20,
"totalPages": 8
}Lists all job postings for the API key’s company with pagination and filtering support.
Overview
Returns every job posting in your company. Filter by status, search by title or description, and page through the results — useful for managing your job list and for picking a job before attaching contacts to it.Use Cases
- Job Management: Review all active job postings
- Status Filtering: Find jobs by status (OPEN, CLOSED)
- Search: Locate specific jobs by title or description
- Bulk Operations: Retrieve jobs for assigning contacts in bulk
Basic Usage
// List all jobs (first page, 20 items)
GET /jobs
With Filters
// Filter by status
GET /jobs?status=OPEN
// Search by title or description
GET /jobs?search=engineer
// Combine filters with pagination
GET /jobs?status=OPEN&search=software&page=1&limit=50
Company Scoping
All returned jobs belong to your API key’s company. ATS keys can filter bycompanyId to access jobs from specific companies they manage.
Related Resources
Jobs Resource Guide
Learn about job management and filtering options
Pagination Guide
Understand pagination best practices
Get Job
Retrieve a specific job by ID
Authorizations
API key for authentication using Bearer scheme
Query Parameters
Page number (1-based)
Required range:
1 <= x <= 10000Example:
1
Number of items per page
Required range:
1 <= x <= 100Example:
20
Company ID (required for ATS keys, optional for regular keys)
Example:
"123e4567-e89b-12d3-a456-426614174000"
Filter by job status
Available options:
UNDEFINED, OPEN, CLOSED Example:
"OPEN"
Search by job title
Example:
"TypeScript Developer"