GET/jds/:jdId

Get Job Description

Get full JD details including application list.

🔒 Scope required: read or jd:read

Path Parameters

Parameter	Type	Required	Description
`jdId`	string	✅	The JD ID

Example

curl https://api.scootsign.com/api/v1/jds/jd_abc123 \
  -H "X-API-Key: aram_ent_a1b2c3d4e5f6..."

Response

{
  "success": true,
  "data": {
    "id": "jd_abc123",
    "title": "Senior Backend Engineer",
    "description": "We are looking for a senior backend engineer...",
    "status": "PUBLISHED",
    "department": "Engineering",
    "location": "Remote",
    "experience": "5-8 years",
    "type": "full-time",
    "salary": "₹25-35 LPA",
    "requirements": "Node.js, TypeScript, PostgreSQL",
    "applications": [
      { "id": "app_1", "status": "SCREENING" },
      { "id": "app_2", "status": "SHORTLISTED" }
    ],
    "createdAt": "2026-03-01T09:00:00.000Z",
    "updatedAt": "2026-03-01T10:30:00.000Z"
  }
}

Errors

Status	Error
`404`	JD not found (wrong ID or doesn’t belong to your tenant)