ATS
Get Job Posting Details from ATS
Streamline Job Distribution Across Platforms with Unified ATS Data
Implementation Details
Step 1: Connect to the ATS
Authenticate to your customer's ATS using Knit's unified authentication flow. Whether they use Greenhouse, Lever, Zoho Recruit, Ashby, or any of the 30+ supported platforms, you'll use the same connection process. Knit handles OAuth flows, API keys, and credential management, returning a unified access token you'll use for subsequent API calls.
Step 2: List Available Jobs
Call the List Jobs API (GET https://api.getknit.dev/v1.0/ats.job.list) to retrieve all jobs from the connected ATS. Results return in paginated format with job IDs, titles, and basic metadata. Filter by status (OPEN, CLOSED, DRAFT) to show only active positions or include closed jobs for historical analysis. This endpoint supports all 11 directly integrated ATS platforms plus webhook-enabled systems.
Step 3: Retrieve Detailed Job Information
For each job you want to display, call the Get Job API (GET https://api.getknit.dev/v1.0/ats.job.get) with the specific job ID. This returns comprehensive details across 14 data models including:
- Core job info (title, description, creation date, status)
- Department and office assignments
- Hiring managers and recruiters
- Hiring pipeline stages
- Compensation details (salary ranges with min/max, currency, pay period; equity; bonuses; benefits)
- Requirements (skills with proficiency levels, required certifications, education requirements from high school through doctorate, experience years, language requirements)
- Enhanced metadata (employment type like full-time/contract/part-time, work arrangement like remote/hybrid/on-site, experience level)
- Application questions
- External job posts with platform-specific details (LinkedIn, Indeed, Glassdoor status: draft/published/paused/expired)
Key Data Models and APIs
| API/Data Model | Description |
|---|---|
GET /v1.0/ats.job.list |
Returns paginated list of jobs with filtering by status (OPEN, CLOSED, DRAFT, NOT_SPECIFIED) |
GET /v1.0/ats.job.get |
Retrieves comprehensive details for a specific job by ID |
job_info |
Core job data: id, title, status, description, createdAt, closedAt, updatedAt |
job_departments |
Department assignments and organizational structure |
job_offices |
Office locations and regional information |
job_hiringManagers |
Assigned hiring managers with contact details |
job_recruiters |
Assigned recruiters managing the position |
job_stages |
Hiring pipeline stages for the position |
job_compensation |
Salary (min/max, currency, period), equity, bonuses, benefits package |
job_requirements |
Skills (with proficiency), certifications, education (HIGH_SCHOOL through DOCTORATE), experience (min/preferred years), languages |
job_questions |
Application questions specific to this position |
job_posts |
External platform posts (LINKEDIN, INDEED, GLASSDOOR) with status tracking |
job_info_enhanced |
Employment type (FULL_TIME, CONTRACT, PART_TIME, TEMPORARY, INTERNSHIP), work arrangement (REMOTE, ON_SITE, HYBRID), experience level |
Wrapping Up
Knit's unified ATS API transforms job distribution from a manual, error-prone process into an automated workflow. With support for 30+ ATS platforms, you build one integration that works across your entire customer base—whether they use enterprise systems like Workday and SAP SuccessFactors or modern platforms like Ashby and Lever.
Standardized Data Models: Knit maps disparate ATS data structures into consistent models, so you don't need conditional logic to handle Greenhouse jobs differently from Workable jobs. Skills, compensation, requirements—everything follows the same structure.
Real-Time Accuracy: Changes in the source ATS flow through to your application automatically. When a recruiter closes a position or updates salary ranges, your platform reflects those changes without manual intervention.
Comprehensive Coverage: From basic job titles to detailed compensation breakdowns, proficiency-weighted skill requirements, and multi-platform posting status, you get the depth of information candidates need to make informed decisions.
Focus on building features that differentiate your recruitment platform. Let Knit handle the complexity of ATS integrations.