---
title: "Candidate data model"
url: "https://docs.unified.to/ats/candidate/model"
description: "API reference for Candidate data model. Launch multiple pre-built Candidate integrations today with zero maintenance — all through a single API."
generated_at: "2026-05-22T23:26:43.321Z"
---
# Candidate data model

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](/ats/integrations) page. 

### 

* Data Model
* Typescript Type
* Zod Shape
* Python Class

Data Model

**id**string 

**created\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**name**string 

**first\_name**string 

**last\_name**string 

**emails** array 

**title**string 

Candidate’s current job title

**telephones** array 

**company\_name**string 

Name of company where candidate currently works

**image\_url**string 

**tags**string array 

**address**object 

**external\_identifier**string 

**link\_urls**string array 

URLs for web pages containing additional material about the candidate (LinkedIn, other social media, articles, etc.)

**origin** enum

Valid values:

 "AGENCY" 

 "APPLIED" 

 "INTERNAL" 

 "REFERRED" 

 "SOURCED" 

**company\_id**string 

(reference to AtsCompany)

**sources**string array 

**date\_of\_birth**date 

**user\_id**string 

Employee ID that owns the relationship for this candidate (reference to HrisEmployee)

**web\_url**string 

**experiences** array 

**education** array 

**skills**string array 

**job\_ids**string array 

**metadata** array 

**raw**any