GET /jobs — List and Filter Your Organization Jobs

Retrieve all job postings for your Cutshort organization. Use the status filter to view only active jobs, or pull the full list including closed roles for reporting.

Endpoint

GET https://api.cutshort.io/v1/jobs

Query Parameters

string

Filter results by job status. One of active, paused, or closed. Returns all statuses if omitted.

integer

Page number for paginated results. Default: 1.

integer

Number of results per page. Maximum: 50. Default: 20.

Example Request

curl -X GET 'https://api.cutshort.io/v1/jobs?status=active' \
  -H 'Authorization: Bearer YOUR_API_KEY'

import requests

response = requests.get(
    "https://api.cutshort.io/v1/jobs",
    params={"status": "active"},
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

Response

Returns 200 OK with a paginated list of job postings belonging to your organization.

{
  "total": 5,
  "page": 1,
  "per_page": 20,
  "data": [
    {
      "id": "job_4xRt2wPv",
      "title": "Senior Backend Engineer",
      "status": "active",
      "location": "Bengaluru",
      "remote_type": "hybrid",
      "skills_required": ["Python", "Django", "PostgreSQL"],
      "experience_min": 4,
      "experience_max": 8,
      "shortlist_count": 23,
      "created_at": "2024-01-10T09:00:00Z"
    }
  ]
}

Response Fields

integer

Total number of job postings matching the applied filter, across all pages.

integer

The current page number.

integer

Number of results returned per page.

array

List of job posting objects for your organization.

string

Unique Cutshort job ID (e.g., job_4xRt2wPv).

string

The job posting title.

string

Current status of the job. One of active, paused, or closed.

string

City or work location associated with the job.

string

Work arrangement type. One of onsite, remote, or hybrid.

array

List of required technical skill names for this role.

integer

Minimum years of experience required.

integer

Maximum years of experience accepted.

integer

Number of candidates currently in the AI-generated shortlist for this job.

string

ISO 8601 timestamp of when the job was created.

Overview

Candidates

Jobs

Sourcing

Webhooks

GET /jobs — List and Filter Your Organization Jobs

Endpoint

Query Parameters

Example Request

Response

Response Fields

​Endpoint

​Query Parameters

​Example Request

​Response

​Response Fields

Endpoint

Query Parameters

Example Request

Response

Response Fields