Application Data Models

📘

Use data type ats_applicationsin the Sync APIs to get these models

Here are the different models you can subscribe to while doing a sync

Model IDEvent Data KeyDescription
application_infoinfoGet the data of an application like applicant details, job id, appliedAt, owner, creditedTo etc
application_stagecurrentStageGet information about the application's current stage
application_interviewsinterviewsGet information about all the interviews associated with an application like id, subject, scheduledStart, scheduledEnd, status, interviewers etc
application_rejectionrejectionGet information about an application's rejection like id, reason etc
application_offersoffersGet the offers associated with an application
application_attachmentsattachmentsGet the attachments associated with an application

All these models have been detailed out below for your reference.

📘

Use Model IDs for Sync

While invoking sync APIs, pass these model IDs in order to get the desired data.

User

NameTypeDescription
idStringUser ID in the ATS system
emailString
employeeIdStringEmployee ID of the user

Application Info

Model ID: application_info

Name Type Description

id

String

Application ID

status

Enum

One of
ACTIVE
REJECTED
HIRED
NOT_SPECIFIED

candidate

Candidate

Candidate Details

origin

Enum

One of
AGENCY,
REFERRAL,
EXTERNAL
NOT_SPECIFIED

appliedAt

Date

updatedAt

Date

jobId

String

Job ID of the application. More info about the Job data model can be found here

owner

User

Owner of the application in the ATS system

creditedTo

User

The user who will receive credit for this application

Candidate

NameTypeDescription
idStringCandidate ID
firstNameString
lastNameString
phonesPhone
emailsList[Email]
linksList[String]Links associated with the candidate like LinkedIn, Website etc
locationString

Phone

Name Type Description

type

Enum

One of
WORK,
PERSONAL,
SKYPE
NOT_SPECIFIED

phoneNumber

String

Email

Name Type Description

type

Enum

One of
WORK,
PERSONAL,
NOT_SPECIFIED

email

String

Application Stage

Model ID: application_stage

NameTypeDescription
currentStageStage

Stage

NameTypeDescription
idStringStage Id
textStringStage Name

Application Interviews

Model ID: application_interviews

NameTypeDescription
interviewsList[Interview]

Interview

Name Type Description

id

String

Interview Id

subject

String

createdAt

Date

scheduledStart

Date

scheduledEnd

Date

stage

Stage

Stage the application was in when this interview was scheduled

interviewers

List[User]

location

String

creator

User

status

Enum

One of
SCHEDULED
AWAITING_FEEDBACK
COMPLETE
CANCELLED
NOT_SPECIFIED

Application Rejection

Model ID: application_rejection

NameTypeDescription
idString
textString
rejectedAtDate

Application Offers

Model ID: application_offers

NameTypeDescription
offersList[Offer]

Offer

Name Type Description

id

String

status

Enum

One of
IN_PROGRESS
SIGNED
DENIED
DEPRECATED
NOT_SPECIFIED

createdAt

Date

sentAt

Date

closedAt

Date

startDate

Date

hireDate

Date

Application Attachments

Model ID: application_attachments

NameTypeDescription
attachmentsList[Attachment]

Attachment

Name Type Description

type

Enum

One of
RESUME
COVER_LETTER
OFFER_LETTER
NOT_SPECIFIED

name

String

File Name

link

String

Downloadable link of the file. (Caution: Some ATS systems might only provide a short lived link)

attachmentContent

AttachmentContent

Content of the attachment

createdAt

Date

When this attachment was created

downloadLink

String

  • Prefer using the downloadLink field over link if both are present.
  • Content will be base64 encoded.
  • Sample JSON:
    { "success": true, "data": { "content": "Base64 Encoded content" } }

Attachment Content

Name Type Description

content

String

encoding

Enum

One of
BASE64
NOT_SPECIFIED

Event Data Example

{
  "info": {
    "id": "lRQ03MnbWBSTKHX",
    "status": "ACTIVE",
    "candidate": {
      "id": "X73cKg1NAFUJTec",
      "firstName": "ABC",
      "lastName": "DEF",
      "phones": [
        {
          "type": "PERSONAL",
          "phoneNumber": "000-000-00"
        },
        {
          "type": "WORK",
          "phoneNumber": "000-000-00"
        }
      ],
      "emails": [
        {
          "type": "PERSONAL",
          "email": "[email protected]"
        }
      ],
      "links": [
        "www.blog.com",
        "www.linkedin.com/abc"
      ],
      "location": "Delhi, India"
    },
    "origin": "EXTERNAL",
    "appliedAt": "1970-01-01T00:00:00Z",
    "updatedAt": "1970-01-01T00:00:00Z",
    "jobId": "Ty60CurNfqp5I9r",
    "owner": {
      "id": "tDWso22iFg8iN56",
      "email": "[email protected]",
      "employeeId": "re8AKBnyujPZ4Yb"
    },
    "creditedTo": {
      "id": "UxXF6C3PwZ4gD4c",
      "email": "[email protected]",
      "employeeId": "ChdsLhmoelplUGN"
    }
  },
  "currentStage": {
    "id": "JLUnI5TFKWbhQ1k",
    "text": "Technical Test"
  },
  "interviews": [
    {
      "id": "uKt2wVW0iSsmw8p",
      "subject": "Tehnical Screen",
      "createdAt": "1970-01-01T00:00:00Z",
      "scheduledStart": "1970-01-01T00:00:00Z",
      "scheduledEnd": "1970-01-01T00:00:00Z",
      "stage": {
        "id": "T63bQ43io2vlgSQ",
        "text": "Interview"
      },
      "interviewers": [
        {
          "id": "PrJjg0mYYSkucbC",
          "email": "[email protected]",
          "employeeId": "WvDRi2Hw9wBOGpp"
        },
        {
          "id": "LjwEnf8vBXMCa1q",
          "email": "[email protected]",
          "employeeId": "HYajD4pt5NNKPto"
        },
        {
          "id": "uf6XtHjVqoJATnD",
          "email": "[email protected]",
          "employeeId": "97XBkbEiDZhlpg4"
        }
      ],
      "location": "zoom.com/interview",
      "creator": {
        "id": "7hHbRoqaZrUWKsE",
        "email": "[email protected]",
        "employeeId": "FCaMvYS2i6z7Idp"
      },
      "status": "COMPLETED"
    }
  ],
  "rejection": {
    "id": "xw0QKdLFrxFh70E",
    "text": "Did not meet our standards",
    "rejectedAt": "1970-01-01T00:00:00Z"
  },
  "offers": [
    {
      "id": "cGCo5ALjUDpjdmZ",
      "status": "SIGNED",
      "createdAt": "1970-01-01T00:00:00Z",
      "sentAt": "1970-01-01T00:00:00Z",
      "closedAt": "1970-01-01T00:00:00Z",
      "startDate": "1970-01-01T00:00:00Z",
      "hireDate": "1970-01-01T00:00:00Z"
    },
    {
      "id": "mkQKiEvrYDgCtaA",
      "status": "DENIED",
      "createdAt": "1970-01-01T00:00:00Z",
      "sentAt": "1970-01-01T00:00:00Z",
      "closedAt": "1970-01-01T00:00:00Z",
      "startDate": "1970-01-01T00:00:00Z",
      "hireDate": "1970-01-01T00:00:00Z"
    }
  ],
  "attachments": [
    {
      "type": "OFFER_LETTER",
      "name": "Offer 1",
      "link": "abc.com/offer1",
      "createdAt": "1970-01-01T00:00:00Z",
      "downloadLink": "https://api.getknit.dev?token=hdc-29393393"
    },
    {
      "type": "COVER_LETTER",
      "name": "Cover Letter",
      "attachmentContent": {
        "content": "b29fTVJrRWU5dW1CU2NQNUlTYkFkc3dJdTpzbGFjaw==",
        "encoding": "BASE64"
      },
      "createdAt": "1970-01-01T00:00:00Z"
    }
  ]
}