키

타입

비고

설명

id

string

지원자별 고유한 ID 값입니다. (포지션별 지원 1건의 ID)

status

string

지원자의 상태 정보입니다.
progressing: 진행 중
passed: 최종 합격
failed: 불합격
불합격 처리된 지원자는 단계와 관계없이 failed이며, 그 외에는 현재 단계가 최종 합격 단계이면 passed, 아니면 progressing입니다.

appliedAt

string(datetime)

지원서를 접수한 날짜와 시간 정보입니다. (UTC)

updatedAt

string(datetime)

지원 정보가 마지막으로 변경된 날짜와 시간 정보입니다. (단계 이동·상태 변경 등, UTC)

name

string

지원자의 이름입니다.

email

string

nullable

지원자의 이메일입니다.

phoneNumber

string

nullable

지원자의 전화번호입니다. (입력된 형식 그대로)

source

string

nullable

지원자가 지원시 입력한 지원 경로입니다.

failReason

string

nullable

지원자 불합격 사유입니다.

company

object

API 전용

회사 정보입니다. 지원자 목록 조회 API 응답에만 포함되며 웹훅에는 없습니다.
id: 회사(워크스페이스) ID
title: 회사명

recruitment

object

지원한 포지션 정보입니다.
id: 포지션 ID (포지션 목록 조회의 id와 같음)
title: 포지션명 (나인하이어 내부 관리용 이름으로, 공고 제목과 다를 수 있음)

step

object

지원자의 현재 전형 단계 정보입니다.
id: 단계 ID
type: 단계 유형 (receipt: 접수, progress: 진행, passed: 최종 합격)
title: 단계명 (고객사가 설정한 이름, 예: 서류 검토, 1차 면접)

customAnswers

object[]

지원서의 정형 항목 외 질문별 답변입니다. (3. 참고)

attachments

object[]

지원 이후 자료 요청으로 제출된 자료입니다. (4. 참고)

정형 항목

학력·경력 등 지원서 정형 항목에 대한 답변입니다. (2. 참고)

키

타입

비고

설명

type

string

학력 구분입니다.
qualification_exam: 검정고시
high_school: 고등학교
technical_college: 전문대학
university: 대학교(4년제 이상)
master_course: 대학원(석사)
doctorate_course: 대학원(박사)

schoolName

string

nullable

학교명입니다.

passedAt

string(datetime)

nullable

합격일입니다. (검정고시 등)

enteredAt

string(datetime)

nullable

입학일입니다.

graduatedAt

string(datetime)

nullable

졸업(예정)일입니다.

grade

string

nullable

취득학점/기준학점 원문입니다. (예: 3.8/4.5)

gradeScore

number

nullable

취득학점입니다. grade가 숫자/숫자 형식이면 앞의 숫자입니다.

standardGrade

number

nullable

기준학점입니다. grade가 숫자/숫자 형식이면 뒤의 숫자입니다.

major

string

nullable

주전공입니다.

doubleMajor

string

nullable

복수전공입니다.

minor

string

nullable

부전공입니다.

status

string

nullable

졸업상태입니다.
graduation: 졸업
candidate: 졸업예정
completion: 수료
attending: 재학
leave: 휴학
drop_out: 중퇴

nightClass

boolean

야간 대학 여부입니다.

transfer

boolean

편입 여부입니다.

majorChange

boolean

전과 여부입니다.

키

타입

비고

설명

companyName

string

nullable

회사명입니다.

joinedAt

string(datetime)

nullable

입사일입니다.

leftAt

string(datetime)

nullable

퇴사일입니다. 재직 중이면 null입니다.

employmentType

string

nullable

고용형태입니다.
full_time: 정규직
contractor: 계약직
intern: 인턴
etc: 기타
unknown: 미확인
포지션의 고용 형태(8종)와 코드 체계가 다릅니다.

position

string

nullable

직급/직책입니다.

department

string

nullable

근무부서입니다.

task

string

nullable

담당업무입니다.

키

타입

비고

설명

type

string

자격 구분입니다.
license: 자격증
prize: 수상

title

string

자격증/수상명입니다.

publisher

string

주최기관/발행처입니다.

grade

string

점수/급입니다.

publishedAt

string(datetime)

nullable

취득일/수상일입니다.

키

타입

비고

설명

type

string

언어 구분입니다.
english: 영어
japanese: 일본어
chinese: 중국어
spanish: 스페인어
german: 독일어
french: 프랑스어
vietnamese: 베트남어
russian: 러시아어
indonesian: 인도네시아어
thai: 태국어
etc: 기타

testTitle

string

시험명입니다.

publisher

string

주최기관입니다.

grade

string

점수/급입니다.

publishedAt

string(datetime)

nullable

취득일입니다.

키

타입

비고

설명

type

string

병역 구분입니다.
fulfilled: 군필
unfulfilled: 미필
in: 복무중
exemption: 병역면제
none: 해당없음

startedAt

string(datetime)

nullable

복무 시작일입니다.

endedAt

string(datetime)

nullable

복무 종료일입니다.

exemptionReason

string

nullable

면제 사유입니다.

rank

string

nullable

계급입니다.
private_second_class: 이병
private_first_class: 일병
corporal: 상병
sergeant: 병장
staff_sergeant: 하사
sergeant_first_class: 중사
master_sergeant: 상사
sergeant_major: 원사
warrant_officer: 준위
second_lieutenant: 소위
first_lieutenant: 중위
captain: 대위
major: 소령
lieutenant_colonel: 중령
colonel: 대령
brigadier_general: 준장
major_general: 소장
lieutenant_general: 중장
general: 대장
general_of_army: 원수
other: 기타

dischargeType

string

nullable

제대 구분입니다.
completion_of_term: 만기제대
discharge_from_mandatory_service: 소집해제
medical_discharge: 의병제대
discharge_due_to_family_circumstances: 의가사제대
dishonorable_discharge: 불명예제대
early_discharge: 상이제대
other: 기타

키

타입

비고

설명

type

string

보훈 구분입니다.
yes: 대상
no: 비대상

number

string

nullable

보훈 번호입니다.

키

타입

비고

설명

type

string

장애 구분입니다.
none: 해당없음
physical: 지체장애
encephalopathy: 뇌병변장애
visual: 시각장애
hearing: 청각장애
speech: 언어장애
facial: 안면장애
intellectual: 지적장애
mental: 정신장애
autism: 자폐성장애
kidney: 신장장애
heart: 심장장애
respiratory: 호흡기장애
liver: 간장애
pancreas: 췌장장애
stoma: 장루/요루장애
epilepsy: 뇌전증장애
unknown: 미확인

degree

string

nullable

장애 정도입니다.
slight: 경증
serious: 중증
etc: 기타

키

타입

비고

설명

postCode

string

우편번호입니다.

roadAddress

string

도로명 주소입니다.

jibunAddress

string

지번 주소입니다.

extraInfo

string

참고 항목입니다. (법정동·건물명 등)

키

타입

비고

설명

relation

string

관계입니다.
grandfather_paternal: 조부
grandmother_paternal: 조모
grandfather_maternal: 외조부
grandmother_maternal: 외조모
father: 부
mother: 모
brother: 형제
sister: 자매
brother_and_sister: 남매
spouse: 배우자
children: 자녀
other: 기타
no_family: 해당없음

birthday

string(datetime)

가족 구성원의 생년월일입니다. 일시 형식으로, 지원자 본인의 birthday(날짜 형식)와 형식이 다릅니다.

livingTogether

boolean

동거 여부입니다.

키

타입

비고

설명

category

string

구분입니다.
oa: OA
language: 언어(프로그래밍)
graphic: 그래픽
engineering: 공학용
other: 기타

level

string

활용 수준입니다.
expert: 특급
advance: 고급
intermediate: 중급
basic: 초급
beginner: 입문

usagePeriod

string

사용 기간입니다. 코드가 아닌 한글 문자열(1년~10년, 11년이상)로 제공됩니다.

programName

string

프로그램명입니다.

키

타입

비고

설명

degree

string

학위 구분입니다.
associate: 전문학사
bachelor: 학사
master: 석사
phd: 박사

title

string

논문 제목입니다.

summary

string

nullable

논문 요약입니다.

키

타입

비고

설명

title

string

질문 내용입니다. (지원서 양식에 설정된 국문 제목)

content

string

nullable

지원자의 텍스트 답변 내용입니다.

fileTitle

string

nullable

지원자가 제출한 파일명입니다. (확장자 제외, 증명사진·일반파일·문서파일)

fileExtension

string

nullable

지원자가 제출한 파일의 확장자입니다. (점 제외, 예: pdf)

fileUrl

string

nullable

지원자가 제출한 파일의 다운로드 URL입니다. (5. 파일 URL 참고)

상황

content 값

단답형·장문형 등 텍스트 답변 1개

입력한 텍스트 그대로

다중 선택 등 답변이 여러 개

각 답변을 쉼표와 공백(", ")으로 이어 붙인 하나의 문자열 (예: "백엔드, 데이터")

선택지에 세부 입력값이 있는 경우 ('기타' 선택 후 직접 입력 등)

선택지(세부 입력값) 형태 (예: "기타(검색 엔진)")

텍스트 답변이 없는 경우 (파일 항목 등)

null

키

타입

비고

설명

title

string

요청 자료의 제목입니다.

content

string

nullable

지원자의 텍스트 답변 내용입니다. 여러 개이면 쉼표로 이어 붙입니다.

fileTitle

string

nullable

지원자가 제출한 파일명입니다. (확장자 제외)

fileExtension

string

nullable

지원자가 제출한 파일의 확장자입니다.

fileUrl

string

nullable

지원자가 제출한 파일의 다운로드 URL입니다. (5. 파일 URL 참고)