Skip to main content
GET
/
v1
/
jobs
List jobs (deprecated)
curl --request GET \
  --url https://api.stardex.ai/v1/jobs \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.stardex.ai/v1/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.stardex.ai/v1/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.stardex.ai/v1/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.stardex.ai/v1/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.stardex.ai/v1/jobs")
  .header("Authorization", "Bearer <token>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.stardex.ai/v1/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
{
  "success": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Senior Software Engineer",
      "created_at": "2024-01-10T09:00:00Z",
      "is_archived": false,
      "client_company_name": "StartupXYZ",
      "client_company_id": "456e7890-e12b-34d5-a678-901234567890",
      "client_company_domain": "startupxyz.com",
      "client_company_linkedin_url": "https://www.linkedin.com/company/startupxyz",
      "job_status_name": "Active",
      "job_status_id": "789e0123-e45f-67a8-b901-234567890123",
      "candidate_count": 12,
      "location": "San Francisco, CA",
      "primary_url": "https://startupxyz.com/careers/senior-swe",
      "job_function": "Engineering",
      "open_date": "2024-01-01",
      "end_date": null,
      "currency_code": "USD",
      "salary_range": "[150000,200000]",
      "salary_min": 150000,
      "salary_max": 200000,
      "salary_details": "+ 0.5% equity, signing bonus negotiable",
      "billing_contact_name": "Sarah Chen",
      "billing_contact_email": "sarah.chen@startupxyz.com",
      "fee": 25000,
      "description": "We are looking for a Senior Software Engineer to join our platform team...",
      "team_members": [
        {
          "team_member_id": "234e5678-e90a-12b3-c456-789012345678",
          "email": "jane@company.com",
          "first_name": "Jane",
          "last_name": "Smith",
          "role_id": "345e6789-e01b-23c4-d567-890123456789",
          "role_name": "Team Lead"
        },
        {
          "team_member_id": "345e6789-f01b-23c4-d567-890123456789",
          "email": "bob@company.com",
          "first_name": "Bob",
          "last_name": "Johnson",
          "role_id": "456e7890-f12b-34d5-e678-901234567890",
          "role_name": "Executive Sponsor"
        }
      ],
      "linked_deals": [
        {
          "deal_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "deal_job_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
          "name": "StartupXYZ — Senior SWE retained search",
          "amount": 35000,
          "currency_code": "USD",
          "deal_status_id": "7201a0b8-e63c-4d8f-899d-78cdd62b5c38",
          "deal_status_name": "Qualified",
          "deal_status_color": "#10B981"
        }
      ],
      "fees": {
        "retainer": {
          "id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
          "fee_type": "percentage",
          "fee_base": "first_year_salary",
          "fee_percentage": 25,
          "projected_fee": 50000,
          "estimated_compensation": 200000,
          "installment_count": 3,
          "final_payment_type": "on_placement",
          "currency_code": "USD"
        },
        "fee_events": [
          {
            "id": "f6a7b8c9-d0e1-2345-f012-456789012345",
            "type": "retainer",
            "label": "Engagement fee",
            "amount": 16666.67,
            "total_fee": 50000,
            "currency_code": "USD",
            "fee_type": "percentage",
            "fee_percentage": 25,
            "compensation": 200000,
            "firm_commission_percent": 100,
            "is_placeholder": false,
            "sequence": 1,
            "start_date": "2024-01-05",
            "expected_date": "2024-01-10",
            "actual_payment_date": "2024-01-11",
            "candidate_id": null,
            "offer_id": null,
            "retainer_id": "e5f6a7b8-c9d0-1234-ef01-345678901234",
            "fee_status_id": "a7b8c9d0-e1f2-3456-0123-567890123456",
            "fee_status_name": "Paid",
            "fee_status_color": "#10B981",
            "fee_status_type": "paid"
          },
          {
            "id": "b8c9d0e1-f2a3-4567-1234-678901234567",
            "type": "placement",
            "label": "Placement — Jane Smith",
            "amount": 50000,
            "total_fee": 50000,
            "currency_code": "USD",
            "fee_type": "percentage",
            "fee_percentage": 25,
            "compensation": 200000,
            "firm_commission_percent": 100,
            "is_placeholder": false,
            "sequence": null,
            "start_date": null,
            "expected_date": "2024-03-15",
            "actual_payment_date": null,
            "candidate_id": "234e5678-e90a-12b3-c456-789012345678",
            "offer_id": "c9d0e1f2-a3b4-5678-2345-789012345678",
            "retainer_id": null,
            "fee_status_id": "d0e1f2a3-b4c5-6789-3456-890123456789",
            "fee_status_name": "Invoiced",
            "fee_status_color": "#3B82F6",
            "fee_status_type": "invoiced"
          }
        ],
        "total_placement_fee": 50000
      },
      "custom_fields": [
        {
          "attribute_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
          "attribute_name": "Priority",
          "data_type": "single-select",
          "value": null,
          "tag": {
            "id": "d4e5f6a7-b8c9-0123-defg-234567890123",
            "name": "High"
          },
          "team_member": null
        }
      ]
    }
  ],
  "meta": {
    "total": 25,
    "offset": 0,
    "limit": 20
  }
}
{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}
{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}
{
  "success": false,
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Authenticate with a Bearer token: API key, OAuth token, or session token.

Query Parameters

​
offset
integer | null
default:0

Records to skip for pagination. Defaults to 0.

Required range: x >= 0
​
limit
integer
default:100

Max records per page (1–100). Defaults to 100.

Required range: 1 <= x <= 100
​
is_archived
boolean

Filter by archive status. Omit for all jobs, true for archived only, false for active only.

​
team_member_id
string<uuid>

Filter to jobs where this team member is assigned. Get IDs from GET /v1/team-members.

​
team_member_email
string

Filter by team member email. Fallback when team_member_id is not available.

​
team_member_role_id
string<uuid>

Filter to jobs that have a member with this role. Get role IDs from GET /v1/jobs/team-member-roles.

​
team_member_role_name
string

Filter by role name (e.g. "Executive Sponsor"). Fallback when team_member_role_id is not available.

​
include
string

Comma-separated extra sections. Values: custom_fields, linked_deals, fees. Omit for base fields only.

Response

Jobs fetched

​
success
enum<boolean>
required
Available options:
true
​
data
object[]
required
​
meta
object
required