Skip to main content
GET
/
jobs
List jobs
curl --request GET \
  --url https://api.instaview.sk/jobs \
  --header 'Authorization: Bearer <token>'
{
  "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

The list jobs endpoint allows you to retrieve all job postings in your company. You can filter by status, search by title or description, and paginate through results. This is useful for managing your job pipeline and finding jobs before creating candidates.

​
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 bulk candidate assignment

​
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 by companyId to access jobs from specific companies they manage.

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

​
Authorization
string
header
required

API key for authentication using Bearer scheme

Query Parameters

​
page
integer
default:1

Page number (1-based)

Required range: 1 <= x <= 10000
Example:

1

​
limit
integer
default:20

Number of items per page

Required range: 1 <= x <= 100
Example:

20

​
companyId
string<uuid>

Company ID (required for ATS keys, optional for regular keys)

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
status
enum<string>

Filter by job status

Available options:
UNDEFINED,
OPEN,
CLOSED
Example:

"OPEN"

​
search
string

Search by job title

Example:

"TypeScript Developer"

Response

200 - application/json
​
data
object[]
required

Array of jobs

​
total
number
required

Total number of items

Example:

150

​
page
number
required

Current page number

Example:

1

​
limit
number
required

Number of items per page

Example:

20

​
totalPages
number
required

Total number of pages

Example:

8