신규 지원서 양식을 활용하는 지원자 상세 조회입니다.

GET https://oapi.greetinghr.com/openapi/v2/applicants/{applicantId}

요청 URL이 변경되었으니, 참고 바랍니다.

X-Api-Version: 2.0

필드

타입

필수 여부

설명

파라미터 타입

applicantId

Integer

필수

지원자의 고유 번호(id) 입니다.

Path

필드

타입

필수 여부

설명

openingData

Object

필수

공고 정보입니다.

metaData

Object

필수

지원자의 메타정보입니다.

basicInformation

Object

필수

지원자의 기본정보입니다.

personalInformation

Object

필수

지원자의 인적사항입니다.

physicalInformation

Object

필수

지원자의 신체정보입니다.

applicationDetail

Object

필수

지원자의 지원정보입니다.

militaryServicePreferentialEmploymentStatus

Object

필수

지원자의 병역, 취업우대 정보입니다.

educationalBackground

Object

필수

지원자의 학력사항입니다.

workHistory

Object

필수

지원자의 경력사항입니다.

languagesCertificationsAndOtherActivity

Object

필수

지원자의 어학, 자격, 활동정보 입니다.

applicationDocument

Object

필수

지원자의 제출서류입니다.

coverLetter

Object

필수

지원자의 자기소개서 입니다.

additionalQuestion

Object

필수

지원자의 추가질문 답변항목 입니다.

필드

타입

필수 여부

설명

비고

id

Number

필수

공고 식별자

title

String

필수

공고명

필드

타입

필수 여부

설명

비고

id

Number

필수

지원자 식별자

submittedAt

String

필수

지원일시

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

quickNote

String

선택

퀵노트

passedAt

String

선택

합격일시

ISO 8601 (UTC+0)

ex:2026-01-01T00:00:00Z

필드

타입

필수 여부

설명

ko

String

필수

항목의 한글값입니다.

en

String

선택

항목의 영문값입니다.

필드

타입

필수 여부

설명

url

Object

선택

URL로 제출한 경우의 답변값입니다.

url.url

String

선택

URL

file

Object

선택

파일

file.fileName

String

선택

파일명

file.fileSize

Number

선택

파일 사이즈

file.downloadUrl

String

선택

파일 다운로드 URL (4시간 동안 유효합니다)

필드

타입

필수 여부

설명

비고

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

customAttributeAnswers.id

Number

필수

커스텀 답변 ID

customAttributeAnswers.applicationFormAttributeId

Number

선택

어트리뷰트 ID

 

customAttributeAnswers.type

Enum

선택

커스텀 항목 답변 유형

지원자 등록 타입

customAttributeAnswers.question

Object(MultiLanguage)

선택

커스텀 항목 질문

customAttributeAnswers.answer

Object

선택

커스텀 항목 답변

customAttributeAnswers.answer.text

String

선택

문자 답변값

customAttributeAnswers.answer.option

Object

선택

옵션 답변값

customAttributeAnswers.answer.option.id

String

선택

옵션 ID

customAttributeAnswers.answer.option.name

Object(MultiLanguage)

선택

옵션 항목명

customAttributeAnswers.answer.file

Object(File)

선택

첨부 파일 조회 정보

customAttributeAnswers.period

Object

선택

커스텀 항목 기간 답변값

기간 설정

customAttributeAnswers.period.startDate

Date

선택

시작일

타입이 ‘연/월’일 경우 ‘일'은 '01’로 설정

ex: 2026-01-01

customAttributeAnswers.period.endDate

Date

선택

종료일

 타입이 ‘연/월’일 경우 ‘일'은 '01’로 설정

ex: 2026-01-01

필드

타입

필수 여부

설명

비고

name

String

필수

이름

 

englishName

String

선택

영문이름

 

chineseName

String

선택

한문이름

 

examNumber

String

선택

수험번호

gender

Enum

선택

성별

지원자 등록 타입

birthdate

Date

선택

생년월일

 ex: 2026-01-01

idPhoto

Object(File)

선택

사진

 

nationalityCode

String

선택

국적

2자리 국가코드(ISO 3166-1 alpha-2)

emailAddress

String

선택

이메일주소

 

secondaryEmailAddress

String

선택

보조이메일주소

 

phoneNumber

Object

선택

연락처

 

phoneNumber.nationalCode

Number

선택

국제전화 국가코드

국제전화 국가코드

(ITU-T E.164)

phoneNumber.nationalNumber

String

선택

전화번호

 

homePhoneNumber

Object

선택

일반전화번호

 

homePhoneNumber.nationalCode

Number

선택

국제전화 국가코드

국제전화 국가코드

(ITU-T E.164)

homePhoneNumber.nationalNumber

String

선택

전화번호

 

emergencyContact

Object

선택

긴급연락처

 

emergencyContact.emergencyContactNumber

Object

선택

긴급연락처

 

emergencyContact.emergencyContactNumber.nationalCode

Number

선택

국제전화 국가코드

국제전화 국가코드

(ITU-T E.164)

emergencyContact.emergencyContactNumber.nationalNumber

String

선택

전화번호

 

emergencyContact.relationshipToApplicant

String

선택

지원자와의 관계

 

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

필드

타입

필수 여부

설명

비고

currentAddress

Object

선택

현주소

 

currentAddress.postalCode

String

선택

우편번호

 

currentAddress.addressId

String

선택

주소 ID

 

currentAddress.address

String

선택

기본주소

 

currentAddress.detailedAddress

String

선택

상세주소

 

registeredAddress

Object

선택

주민등록지

 

registeredAddress.postalCode

String

선택

우편번호

 

registeredAddress.addressId

String

선택

주소 ID

 

registeredAddress.address

String

선택

기본주소

 

registeredAddress.detailedAddress

String

선택

상세주소

 

specialSkill

String

선택

특기

 

hobby

String

선택

취미

 

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

 

필드

타입

필수 여부

설명

비고

bloodType

Enum

선택

혈액형

지원자 등록 타입

height

Number

선택

신장

weight

Number

선택 

체중

vision

Object

선택

시력

vision.left

BigDecimal

선택

vision.right

BigDecimal

선택

physicalCondition

String

선택

신체 특이사항

colorBlindness

Enum

선택

색약여부

지원자 등록 타입

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

 

필드

타입

필수 여부

설명

비고

applicationSource

String

선택

지원경로

desiredSalary

Object

선택

희망연봉

desiredSalary.salary

Number

선택

희망연봉

desiredSalary.expectationType

Enum

선택

회사 내규에 따름 옵션 활성화 여부

지원자 등록 타입

previousSalary

Number

선택

직전연봉

availableStart

Object

선택

입사가능시점 정보

availableStart.type

Enum

선택

입사가능시점 구분

지원자 등록 타입

availableStart.date

Date

선택

입사가능일자

ex: 2026-01-01

desiredPositionLevel

String

선택

희망직급

referrerInformation

Object

선택

추천인정보

referrerInformation.referrerName

String

선택

추천인 이름

referrerInformation.relationshipToReferrer

String

선택

추천인과의 관계

referrerInformation.referrerEmail

String

선택

추천인 이메일

referrerInformation.referrerOrganization

String

선택

추천인 소속

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

 

필드

타입

필수 여부

설명

비고

disability

Object

선택

장애여부

disability.disabilityStatus

Enum

선택

장애대상여부

지원자 등록 타입

disability.disabilityRegistrationNumber

String

선택

장애등록번호

disability.degreeOfDisability

Enum

선택

장애정도

지원자 등록 타입

disability.descriptionOfDisability

Enum

선택

장애내용

지원자 등록 타입

disability.disabilityRegistrationCard

Object(File)

선택

장애인등록증

disability.disabilityCertificate

Object(File)

선택

장애인증명서

veteranStatus

Object

선택

보훈여부

veteranStatus.eligibilityForVeteransBenefit

Enum

선택

보훈대상여부

지원자 등록 타입

veteranStatus.veteransRegistrationNumber

String

선택

보훈번호

veteranStatus.veteranRelationship

Enum

선택

보훈관계

지원자 등록 타입

veteranStatus.veteranBenefitRating

Enum

선택

보훈비율

지원자 등록 타입

veteranStatus.certificateOfEligibilityForEmploymentSupport

Object(File)

선택

취업지원 대상자증명서

militaryService

Object

선택

병역사항

militaryService.militaryServiceStatus

Enum

선택

병역여부

지원자 등록 타입

militaryService.militaryServiceClassification

Enum

선택

병역구분

지원자 등록 타입

militaryService.branchOfService

Enum

선택

군별

지원자 등록 타입

militaryService.rank

Enum

선택

계급

지원자 등록 타입

militaryService.militaryOccupationalSpecialty

String

선택

병과

militaryService.servicePeriod

Object

선택

복무기간

militaryService.servicePeriod.startDate

Date

선택

시작일

ex: 2026-01-01

militaryService.servicePeriod.endDate

Date

선택

종료일

ex: 2026-01-01

militaryService.dischargeType

Enum

선택

제대구분

지원자 등록 타입

militaryService.reasonForExemption

String

선택

면제사유

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

 

필드

타입

필수 여부

설명

비고

highSchool

Object

선택

고등학교

highSchool.completionStatus

Enum

선택

졸업구분

지원자 등록 타입

highSchool.gedExamPassedDate

Date

선택

검정고시 합격일자

ex: 2026-01-01

highSchool.countryCode

String

선택

국가코드

2자리 국가코드(ISO 3166-1 alpha-2)

highSchool.schoolName

String

선택

학교명

highSchool.schoolLocation

Enum

선택

학교소재지

지원자 등록 타입

highSchool.trackDepartment

Enum

선택

계열

지원자 등록 타입

highSchool.dayNightClassification

Enum

선택

주간,야간구분

지원자 등록 타입

highSchool.enrollmentPeriod

String

선택

재학기간

highSchool.enrollmentPeriod.startDate

Date

선택

시작일

ex: 2026-01-01

highSchool.enrollmentPeriod.endDate

Date

선택

종료일

ex: 2026-01-01

universities

Object[]

필수

대학교

universities.degreeLevel

Enum

필수

학위구분

지원자 등록 타입

universities.countryCode

String

선택

국가코드

2자리 국가코드(ISO 3166-1 alpha-2)

universities.schoolName

String

필수

학교명

universities.schoolLocation

Enum

선택

학교소재지

지원자 등록 타입

universities.mainCampusBranchCampus

Enum

선택

본교,분교

지원자 등록 타입

universities.enrollmentPeriod

Object

선택

재학기간

universities.enrollmentPeriod.startDate

Date

선택

시작일

ex: 2026-01-01

universities.enrollmentPeriod.endDate

Date

선택

종료일

ex: 2026-01-01

universities.admissionType

Enum

필수

입학구분

지원자 등록 타입

universities.completionStatus

Enum

필수

졸업구분

지원자 등록 타입

universities.majors

Object[]

필수

전공

universities.majors.majorField

Enum

선택

전공계열

지원자 등록 타입

universities.majors.major

String

선택

전공

universities.majors.majorClassification

Enum

선택

전공구분

지원자 등록 타입

universities.dayNightClassification

Enum

선택

주야간구분

지원자 등록 타입

universities.gpa

Object

선택

평점

universities.gpa.score

BigDecimal

선택

평점

universities.gpa.scoreScale

Enum

선택

만점기준

지원자 등록 타입

universities.totalCreditsEarned

Number

선택

총이수학점

universities.transcript

Object(File)

선택

성적증명서

universities.certificateOfEnrollmentGraduation

Object(File)

선택

재학/졸업증명서

graduateSchools

Object[]

필수

대학원

graduateSchools.degreeLevel

Enum

필수

학위구분

지원자 등록 타입

graduateSchools.countryCode

String

선택

국가코드

2자리 국가코드(ISO 3166-1 alpha-2)

graduateSchools.schoolName

String

필수

학교명

graduateSchools.schoolLocation

Enum

선택

학교소재지

지원자 등록 타입

graduateSchools.mainCampusBranchCampus

Enum

선택

본교,분교

지원자 등록 타입

graduateSchools.enrollmentPeriod

Object

선택

재학기간

graduateSchools.enrollmentPeriod.startDate

Date

선택

시작일

ex: 2026-01-01

graduateSchools.enrollmentPeriod.endDate

Date

선택

종료일

ex: 2026-01-01

graduateSchools.admissionType

Enum

필수

입학구분

지원자 등록 타입

graduateSchools.completionStatus

Enum

선택

졸업구분

지원자 등록 타입

graduateSchools.majors

Object[]

필수

전공

graduateSchools.majors.majorField

Enum

선택

전공계열

지원자 등록 타입

graduateSchools.majors.major

String

선택

전공

graduateSchools.majors.majorClassification

Enum

선택

전공구분

지원자 등록 타입

graduateSchools.dayNightClassification

Enum

선택

주야간구분

지원자 등록 타입

graduateSchools.gpa.score

BigDecimal

선택

평점

graduateSchools.gpa.scoreScale

Enum

선택

만점기준

지원자 등록 타입

graduateSchools.totalCreditsEarned

Number

선택

총이수학점

graduateSchools.researchField

String

선택

연구분야

graduateSchools.academicAdviser

String

선택

지도교수

graduateSchools.transcript

Object(File)

선택

성적증명서

graduateSchools.certificateOfEnrollmentGraduation

Object(File)

선택

재학/졸업증명서

theses

Object[]

필수

논문

theses.thesisClassification

Enum

선택

논문구분

지원자 등록 타입

theses.thesisTitle

String

선택

논문제목

theses.thesisSummary

String

선택

논문요약

theses.thesisAttachmentFile

Object(File)

선택

논문파일첨부

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

 

필드

타입

필수 여부

설명

비고

workExperiences

Object[]

필수

직장경력

workExperiences.employmentType

Enum

필수

고용형태

지원자 등록 타입

workExperiences.companyName

String

필수

회사명

workExperiences.employmentStatus

Enum

선택

근무상태구분

지원자 등록 타입

workExperiences.employmentPeriod

Object

선택

근무기간

workExperiences.employmentPeriod.startDate

Date

선택

시작일

ex: 2026-01-01

workExperiences.employmentPeriod.endDate

Date

선택

종료일

ex: 2026-01-01

workExperiences.department

String

선택

부서

workExperiences.positionRank

String

선택

직급

workExperiences.dutiesResponsibility

String

선택

담당업무

workExperiences.annualSalary

Number

선택

연봉

workExperiences.reasonForResignation

String

선택

퇴직사유

totalWorkExperience

Object

선택

총경력

totalWorkExperience.years

Number

필수

totalWorkExperience.months

Number

필수

totalWorkExperience.days

Number

필수

projects

Object[]

필수

프로젝트

projects.projectName

String

필수

프로젝트명

projects.client

String

선택

발주처

projects.placeOfEmployment

String

선택

근무처

projects.projectPeriod

Object

선택

프로젝트 기간researchField

projects.projectPeriod.startDate

Date

선택

시작일

ex: 2026-01-01

projects.projectPeriod.endDate

Date

선택

종료일

ex: 2026-01-01

projects.projectDescription

String

선택

프로젝트 내용

projects.contribution

Number

선택

기여도

projects.roleParticipationRole

String

선택

참여역할

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

 

필드

타입

필수 여부

설명

비고

certifiedLanguageTests.score

Object

선택

취득점수

certifiedLanguageTests.score.score

BigDecimal

필수

취득점수

certifiedLanguageTests.score.scoreScale

Enum

필수

만점기준

지원자 등록 타입

certifiedLanguageTests.supportingDocument

Object(File)

선택

증빙서류

foreignLanguageProficiencies

Object[]

필수

외국어활용능력

foreignLanguageProficiencies.foreignLanguage

Enum

필수

외국어

지원자 등록 타입

foreignLanguageProficiencies.conversationalProficiency

Enum

선택

회화수준

지원자 등록 타입

foreignLanguageProficiencies.writingProficiency

Enum

선택

작문수준

지원자 등록 타입

foreignLanguageProficiencies.readingProficiency

Enum

선택

독해수준

지원자 등록 타입

overseasExperiences

Object[]

필수

해외경험

overseasExperiences.purposeOfOverseasExperience

Enum

필수

해외경험 목적

지원자 등록 타입

overseasExperiences.countriesOfOverseasExperienceCode

String

선택

해외경험 국가코드

2자리 국가코드(ISO 3166-1 alpha-2)

overseasExperiences.periodOfOverseasExperience

Object

선택

해외경험 기간

overseasExperiences.periodOfOverseasExperience.startDate

Date

선택

시작일

ex: 2026-01-01

overseasExperiences.periodOfOverseasExperience.endDate

Date

선택

종료일

ex: 2026-01-01

overseasExperiences.descriptionOfOverseasExperience

String

선택

해외경험 내용기술

certificatesLicenses

Object[]

필수

자격증,면허증

certificatesLicenses.credentials

String

필수

자격증명

certificatesLicenses.rating

String

선택

등급

certificatesLicenses.issuingAgency

String

선택

발급기관

certificatesLicenses.registrationNumber

String

선택

등록번호

certificatesLicenses.acquisitionDate

Date

필수

취득일

ex: 2026-01-01

certificatesLicenses.supportingDocument

Object(File)

선택

증빙서류

computerSkills

Object[]

필수

컴퓨터활용능력

computerSkills.skillCategory

Enum

필수

활용능력구분

지원자 등록 타입

computerSkills.programName

String

필수

프로그램명

computerSkills.skillLevel

Enum

선택

활용수준

지원자 등록 타입

awards

Object[]

필수

수상경력

awards.awardName

String

필수

상훈명

awards.awardingInstitution

String

선택

수여기관

awards.awardDate

Date

필수

수상일자

ex: 2026-01-01

awards.awardDetail

String

선택

수상내역

awards.supportingDocument

Object(File)

선택

증빙서류

extracurricularActivities

Object[]

필수

학내외활동

extracurricularActivities.activityClassification

Enum

필수

활동구분

지원자 등록 타입

extracurricularActivities.institutionOrganizationName

String

선택

기관 및 조직명

extracurricularActivities.activityPeriod

Object

선택

활동기간

extracurricularActivities.activityPeriod.startDate

Date

선택

시작일

ex: 2026-01-01

extracurricularActivities.activityPeriod.endDate

Date

선택

종료일

ex: 2026-01-01

extracurricularActivities.role

String

선택

역할

extracurricularActivities.activityDescription

String

선택

활동내역

volunteerExperiences

Object[]

필수

봉사활동

volunteerExperiences.serviceCategory

Enum

필수

봉사구분

지원자 등록 타입

volunteerExperiences.hostOrganization

String

선택

주관기관

volunteerExperiences.activityPeriod

Object

선택

활동기간

volunteerExperiences.activityPeriod.startDate

Date

선택

시작일

ex: 2026-01-01

volunteerExperiences.activityPeriod.endDate

Date

선택

종료일

ex: 2026-01-01

volunteerExperiences.volunteerHours

Number

선택

봉사참여시간

volunteerExperiences.serviceCountryCode

String

선택

봉사국가코드

2자리 국가코드(ISO 3166-1 alpha-2)

volunteerExperiences.serviceDescription

String

선택

봉사내용

volunteerExperiences.supportingDocument

Object(File)

선택

증빙서류

completedCoursesTrainings

Object[]

필수

교육이수사항

completedCoursesTrainings.courseName

String

필수

과정명

completedCoursesTrainings.educationalInstitution

String

선택

교육기관

completedCoursesTrainings.completionPeriod

Object

선택

이수기간

completedCoursesTrainings.completionPeriod.startDate

Date

선택

시작일

ex: 2026-01-01

completedCoursesTrainings.completionPeriod.endDate

Date

선택

종료일

ex: 2026-01-01

completedCoursesTrainings.trainingHours

Number

선택

교육시간

completedCoursesTrainings.mainContent

String

선택

주요내용

completedCoursesTrainings.supportingDocument

Object(File)

선택

증빙서류

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

 

필드

타입

필수 여부

설명

비고

resume

Object(File)

선택

이력서

careerSummary

Object(File)

선택

경력기술서

portfolio

Object(File)

선택

포트폴리오

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

 

필드

타입

필수 여부

설명

비고

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

 

필드

타입

필수 여부

설명

비고

customAttributeAnswers

Object[]

필수

커스텀 항목 답변

 

JSON