---
title: "Knit - Sync / Get Applicant Details from ATS"
description: "Get Applicant Details for any Job Posting"
source_url: "https://www.getknit.dev/solutions-use-cases/sync-get-applicant-details-from-ats"
page_type: "use-case-playbook"
---

_This page is a detailed implementation playbook for a specific Knit integration use case: “Knit - Sync / Get Applicant Details from ATS”._

# Knit - Sync / Get Applicant Details from ATS

ATS

  Get Applicant Details for any Job Posting

### Step 1: Sync Candidate Data from ATS

Initiate a sync request to pull candidate information from the connected ATS platform. Knit's Sync API retrieves data across six comprehensive candidate models, giving you access to everything from basic contact details to complete work histories.

**API Endpoint:** `POST https://api.getknit.dev/v1.0/sync.start`

**Request Parameters:**

*   `dataType`: Set to `"ats_candidates"` to retrieve candidate information
*   `honorScheduler` (optional): Controls delta sync timing behavior

**What You Receive:**  
The sync operation retrieves data across six candidate models:

*   **candidate\_info**: Identity, contact details, professional summary, application IDs
*   **candidate\_education**: Degree information, institutions, dates, GPA
*   **candidate\_locations**: Complete address details
*   **candidate\_skills**: Skill names with proficiency levels
*   **candidate\_experiences**: Employment history with dates and descriptions
*   **candidate\_attachments**: Resumes, cover letters, and supporting documents

**Implementation Note:** Syncs must be enabled for the ATS category before making this call. Review Knit's Getting Started documentation to activate sync capabilities for your integration.

### Step 2: Extract Relevant Profile Information

Parse the synced candidate data to identify information relevant to your assessment workflows. The structured data models enable you to programmatically access specific fields needed for test routing, evaluator context, and candidate communication.

**Key Data Fields for Assessment Platforms:**

**Identity and Contact (from candidate\_info):**

*   `firstName`, `lastName`: Personalize assessment invitations
*   `emails`: Array with type designation (personal/work) for multi-channel communication
*   `phones`: Array with type designation for SMS notifications
*   `title`, `company`: Current role context for assessment difficulty calibration

**Skills and Proficiency (from candidate\_skills):**

*   `skillName`: Technologies, frameworks, methodologies
*   `proficiency`: "Expert," "Advanced," "Intermediate," "Beginner"
*   Use proficiency levels to route candidates to appropriately difficult technical assessments

**Education History (from candidate\_education):**

*   `degreeName`, `institution`: Verify credential claims during background checks
*   `major`, `minor`: Understand academic background for role fit
*   `currentlyPursuing`: Boolean indicating ongoing education status
*   `score`: GPA or percentage for academic performance context

**Work Experience (from candidate\_experiences):**

*   `company`, `jobTitle`: Professional background context
*   `startDate`, `endDate`: Years of experience calculations
*   `currentlyWorking`: Boolean for current employment status
*   `description`: Role summaries and achievement details

**Documents (from candidate\_attachments):**

*   `fileType`: RESUME, COVER\_LETTER, OFFER\_LETTER, NOT\_SPECIFIED
*   `downloadLink`: Direct URL to access documents (preferred over `link` field)
*   `attachmentContent`: Base64-encoded file content for local storage
*   `fileName`, `createdAt`: File metadata

### Step 3: Initiate Assessment Workflows

With complete candidate profiles synced from the ATS, automatically trigger relevant assessment workflows without manual recruiter intervention. Use the extracted data to personalize communications, pre-populate assessment forms, and route candidates to appropriate evaluations.

**Date Format Note:** All date fields in candidate data use ISO 8601 format (YYYY-MM-DD), enabling consistent date calculations across your assessment scheduling and reporting systems.

## Key Data Models and APIs Reference

| Component | Description |
| --- | --- |
| **Start a Sync API** | `POST https://api.getknit.dev/v1.0/sync.start` - Initiates data synchronization from ATS platforms. Use `dataType: "ats_candidates"` to retrieve candidate information across six data models. Supports 40+ ATS platforms. |
| `candidate_info` | Core candidate identity and contact data including firstName, lastName, phones (array with types), emails (array with types), title, company, links, tags, createdAt, updatedAt, and associated application IDs. |
| `candidate_education` | Education history including degreeName, institution, fromDate, toDate, major, minor, score/GPA, currentlyPursuing (boolean), and description fields. |
| `candidate_locations` | Address information with addressLine1, addressLine2, city, state, country, zipCode, and addressType fields following standardized address model structure. |
| `candidate_skills` | Professional competencies including skillName (e.g., "Python", "React") and proficiency levels ("Expert", "Advanced", "Intermediate", "Beginner"). |
| `candidate_experiences` | Employment history with company, jobTitle, startDate, endDate, currentlyWorking (boolean), and description containing role summaries and achievements. |
| `candidate_attachments` | Document files with fileType (RESUME, COVER\_LETTER, OFFER\_LETTER, NOT\_SPECIFIED), fileName, createdAt, downloadLink (preferred), link, and base64-encoded attachmentContent. |

## Wrapping Up: Streamline Your Assessment Pipeline

**Eliminate Data Entry Bottlenecks**  
Manual candidate data transfer between ATS and assessment platforms creates delays that frustrate candidates and overwhelm recruiters. By syncing complete candidate profiles automatically, you reduce time-to-assessment from hours to minutes while eliminating transcription errors that damage candidate experience.

**Enable Skills-Based Assessment Routing**  
Access to structured skills data with proficiency levels transforms assessment assignment from a manual triage process into an automated workflow. Route expert developers to advanced system design challenges while directing beginners to foundational assessments—all without recruiter intervention.

**Maintain Single Source of Truth**  
When candidate data flows automatically from ATS to assessment platforms, your recruiting team maintains one authoritative data source instead of juggling disconnected spreadsheets and testing dashboards. Updates to candidate profiles in the ATS instantly reflect in your assessment tools, ensuring evaluators always have current information.

**Build Once, Connect Everywhere**  
Knit's unified API structure means you build candidate data sync workflows once and instantly support 40+ ATS platforms—from enterprise systems like [Workday](https://md.getknit.dev/mcp-servers/workday-mcp-server) and [SAP SuccessFactors](https://md.getknit.dev/mcp-servers/sap-successfactors-mcp-server) to modern platforms like Greenhouse and Lever. Add new ATS integrations without rewriting your core assessment logic.

## Built for Scale, Speed,  
and Simplicity


## Related pages

- [Use cases hub](https://md.getknit.dev/use-cases)
- [Solutions hub](https://md.getknit.dev/solutions)