GET/jds

List Job Descriptions

Paginated list of JDs for your tenant. Optionally filter by status.

🔒 Scope required: read or jd:read

Query Parameters

Parameter	Type	Default	Description
`page`	string	`"1"`	Page number
`limit`	string	`"20"`	Results per page (max 100)
`status`	string	—	Filter: `DRAFT`, `PUBLISHED`, `CLOSED`, `ARCHIVED`

Example

curl "https://api.scootsign.com/api/v1/jds?status=PUBLISHED&limit=10" \
  -H "X-API-Key: aram_ent_a1b2c3d4e5f6..."

Response

{
  "success": true,
  "data": [
    {
      "id": "jd_abc123",
      "title": "Senior Backend Engineer",
      "status": "PUBLISHED",
      "department": "Engineering",
      "location": "Remote",
      "experience": "5-8 years",
      "type": "full-time",
      "salary": "₹25-35 LPA",
      "createdAt": "2026-03-01T09:00:00.000Z",
      "updatedAt": "2026-03-01T10:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42,
    "pages": 5
  }
}