List Job Campaigns | Gradii API Documentation

curl https://gradii.ai/api/v2/job-campaigns \
     -H "Authorization: Bearer <token>"

{
  "success": true,
  "data": [
    {
      "id": "campaign-uuid",
      "campaignName": "Senior Developer Hiring 2024",
      "jobTitle": "Senior Full Stack Developer",
      "department": "Engineering",
      "location": "Remote",
      "experienceLevel": "Senior Level (6–10 years)",
      "employeeType": "Full-time",
      "salaryMin": 100000,
      "salaryMax": 150000,
      "salaryNegotiable": true,
      "currency": "USD",
      "numberOfOpenings": 3,
      "status": "active",
      "campaignType": "specific",
      "applicationDeadline": "2024-12-31T23:59:59.000Z",
      "targetHireDate": "2025-01-15T00:00:00.000Z",
      "isRemote": true,
      "isHybrid": false,
      "totalApplicants": 45,
      "activeApplicants": 32,
      "autoSchedulingEnabled": true,
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "timestamp": "2024-01-28T10:30:00.000Z",
  "version": "2.0"
}

Get all job campaigns for your company (no pagination - returns all campaigns)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

searchstringOptional

Search in campaign name, job title, or description

departmentstringOptional

Filter by exact department

locationstringOptional

Filter by location (partial match)

statusstringOptional

Filter by status: draft|active|paused|closed

experienceLevelstringOptional

Filter by experience level

employeeTypestringOptional

Filter by employee type

sortBystringOptional

Sort by: campaignName|jobTitle|createdAt|updatedAt|applicationDeadline (default: createdAt)

sortOrderstringOptional

Sort order: asc|desc (default: desc)

Response

Campaigns retrieved successfully

successboolean

datalist of objects

timestampstring

versionstring