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.

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 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