지원자 상세 정보 조회

📘

Note

지원자 상세 정보를 제공합니다.


요청 URL

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


요청 파라미터

Content-Type: application/json

필드타입필수 여부설명
applicantIdInteger필수지원자 고유 id입니다.

응답 객체 상세

필드

타입

필수 여부

설명

id

Integer

필수

지원자 고유 id입니다.

name

String

필수

지원자 이름입니다.

email

String

선택

지원자 이메일입니다.

phone

String

선택

지원자 전화번호입니다.

submitDate

String

필수

지원자 제출일입니다.

quickNote

String

선택

퀵노트입니다.

referer

String

선택

지원 경로입니다.

openingInfo

Object

필수

지원자가 지원한 공고 정보입니다.

additionalInfo

Object

선택

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

educationalBackgroundsInfo

Object

필수

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

careersInfo

Object

필수

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

languageSkillsInfo

Object

필수

지원자의 어학사항 정보입니다.

certificatesInfo

Object

필수

지원자의 자격사항 정보입니다.

nationalityInfo

Object

선택

국적 정보입니다.

foreignNameInfo

Object

선택

외국어 이름 정보입니다.

outsideActivitiesInfo

Object

필수

외부 활동 정보입니다.

overseasActivitiesInfo

Object

필수

해외 경험 정보입니다.

documentsInfo

Object

필수

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

questionInfo

Object

필수

지원자의 추가질문 정보입니다.

profileImageUrl

String

선택

지원자의 프로필 이미지를 다운받을 수 있는 링크입니다. (4시간만 유효합니다)


응답 객체 상세(openingInfo)

필드타입필수 여부설명
idInteger필수공고 고유 id값입니다.
titleString필수공고 제목입니다.

응답 객체 상세(additionalInfo)

필드

타입

필수 여부

설명

비고

birthday

String

선택

생년월일 정보입니다.

militaryStatus

Enum

선택

병역 / 복무 형태입니다.

  • FULL_FILLED: 군필
  • UN_FULL_FILLED: 미필
  • EXEMPTED: 면제
  • IN_SERVICE: 복무 중

militaryKind

Enum

선택

군종 정보입니다.

  • ARMY: 육군
  • MARINE: 해병대
  • NAVY: 해군
  • AIR_FORCE: 공군
  • COMBAT_POLICE: 전경
  • AUXILIARY_POLICE: 의경
  • COAST_GUARD: 해경
  • PUBLIC_SERVICE_
    AGENT: 공익
  • SPECIAL_MILITARY_
    SERVICE: 병역 특례
  • KATUSA: 카투사
  • CONSCRIPTED_
    FIRE_FIGHTERS_ AGENCY: 의무 소방
  • ETC: 기타

enlistmentDate

String

선택

입대일 정보입니다.

dischargeDate

String

선택

제대일 정보입니다.

address

String

선택

주소 정보입니다.

detailAddress

String

선택

상세 주소 정보입니다.

militaryClass

Enum

선택

병역 등급 정보입니다.

  • PRIVATE: 이등병
  • PRIVATE
    _FIRST_CLASS: 일병
  • CORPORAL: 상병
  • SERGEANT: 병장
  • STAFF_SERGEANT: 하사
  • SERGEANT_FIRST_CLASS: 중사
  • MASTER_SERGEANT: 상사
  • CHIEF_MASTER
    _SERGEANT: 원사
  • WARRANT_OFFICER: 준위
  • SECOND_LIEUTENANT: 소위
  • FIRST_LIEUTENANT: 중위
  • CAPTAIN: 대위
  • MAJOR: 소령
  • LIEUTENANT_COLONEL: 중령
  • COLONEL: 대령
  • SPECIAL_FIREFIGHTER: 특방
  • SENIOR_FIREFIGHTER: 수방
  • LEADING_FIREFIGHTER: 상방
  • FIREFIGHTER: 일방

veteranStatus

Enum

선택

보훈 / 보훈 대상 여부입니다.

  • TARGET: 대상
  • NOT_TARGET: 비대상

veteranCode

String

선택

보훈 / 보훈 코드입니다.

isDisability

Enum

선택

장애 / 장애 대상 여부입니다.

  • TARGET: 대상
  • NOT_TARGET: 비대상

typeOfDisability

String

선택

장애 / 장애 종류입니다.

severityOfSymptoms

String

선택

장애 / 장애 중증도입니다.

careerType

Enum

선택

경력사항 입니다.

  • NEW_COMER: 신입
  • EXPERIENCED: 경력
  • NOT_MATTER: 무관

응답 객체 상세(educationalBackgroundsInfo)

필드

타입

필수 여부

설명

비고

kind

Enum

필수

학위 종류입니다.

  • ELEMENTARY _SCHOOL_GRADUATE: 초등학교
  • MIDDLE_SCHOOL_GRADUATE : 중학교
  • HIGH_SCHOOL_GRADUATE : 고등학교
  • ASSOCIATE_DEGREE : 전문대
  • BACHELOR_DEGREE : 학사
  • MASTERS_DEGREE : 석사
  • DOCTOR_DEGREE : 박사

name

String

선택

학교명입니다.

isNightUniversity

Boolean

필수

야간 대학 여부입니다.

startDate

String

선택

입학일입니다.

endDate

String

선택

졸업일입니다.

score

String

선택

학점입니다.

majorField

String

선택

계열입니다.

maxScore

String

선택

기준 학점입니다.

major

String

선택

전공입니다.

isQualification
Examiner

Boolean

필수

검정고시 해당 여부입니다.

examination
ForEntrance PassDate

String

선택

졸업시험 통과일입니다.

attending

Boolean

필수

재학 여부입니다.

minorEducation
Backgrounds

Objectp[

필수

복수/부 전공에 대한 정보입니다.


응답 객체 상세(minorEducationalBackgroundsInfo)

필드

타입

필수 여부

설명

비고

type

Enum

필수

부전공 유형입니다.

  • DOUBLE: 복수 전공
  • MINOR: 부전공

kind

String

필수

부전공 종류입니다.

major

String

필수

부전공 명입니다.


응답 객체 상세(careersInfo)

필드타입필수 여부설명비고
inServiceBoolean필수재직 여부입니다.
tenureStartDateString선택입사일입니다.
tenureEndDateString선택퇴사일입니다.
positionString필수직급입니다.
jobString필수담당 업무입니다.
companyString필수재직 회사명입니다.
affiliationString선택소속입니다.

응답 객체 상세(languageSkillsInfo)

필드타입필수 여부설명비고
examNameString필수시험명입니다.
acquisitionDateString필수취득일입니다.
gradeString필수시험 점수입니다.
languageString필수시험 언어입니다.

응답 객체 상세(certificatesInfo)

필드타입필수 여부설명비고
credentialString필수자격증 이름입니다.
issuerString필수발행처입니다.
acquisitionDateString필수취득일입니다.

응답 객체 상세(nationlityInfo)

필드타입필수 여부설명비고
nationalString필수국적입니다.

응답 객체 상세(foreignNameInfo)

필드타입필수 여부설명비고
nameString필수외국어 이름입니다.
nameTypeEnum필수외국어 이름 타입입니다.ENG: 영어

응답 객체 상세(outsideActivitiesInfo)

필드

타입

필수 여부

설명

비고

activity

String

필수

외부 활동명 이름입니다.

activityType

Enum

필수

외부 활동 유형입니다.

  • EXTERNAL_ACTIVITY: 외부 활동
  • AWARD: 수상
  • EDUCATIONAL_ACTIVITY: 교육 활동
  • VOLUNTEER_ACTIVITY: 봉사 활동
  • ETC: 기타

startDateOfActivity

String

필수

활동 시작일 정보입니다.

endDateOfActivity

String

필수

활동 종료일 정보입니다.

location

String

필수

활동 장소/기관 정보입니다.

content

String

선택

활동 내용 정보입니다.


응답 객체 상세(overseasActivitiesInfo)

필드

타입

필수 여부

설명

비고

countryName

String

필수

국가명 정보입니다.

overseasExperienceType

Enum

필수

해외 경험 유형입니다.

  • RESIDENCE: 거주
  • LANGUAGE_TRAINING: 어학 연수
  • EXCHANGE_STUDENT: 교환 학생
  • WORKING_HOLIDAY: 워킹 홀리데이
  • EXPATRIATE_DISPATCH: 주재원 파견
  • ETC: 기타

startDateOfStay

String

필수

체류 시작일 정보입니다.

endDateOfStay

String

필수

체류 종료일 정보입니다.

purposeOfStay

String

선택

체류 목적 정보입니다.


응답 객체 상세(documentsInfo)

필드타입필수 여부설명비고
nameString필수제출 서류명입니다.
downloadUrlString필수지원자가 제출한 서류를 다운받을 수 있는 링크입니다.4시간만 유효

응답 객체 상세(questionInfo)

필드타입필수 여부설명비고
questionString필수사전질문 질문 정보입니다.
answerString필수사전질문 항목 대한 답변 정보입니다.

응답 예시

{
  "status": 200,
  "message": "OK",
  "data": {
    "id": 12345,
    "name": "홍길동",
    "email": "[email protected]",
    "phone": "010-1234-5678",
    "submitDate": "2025-03-15T14:30:25+09:00",
    "quickNote": "성실하고 책임감 있는 지원자",
    "referer": "LinkedIn",
    "openingInfo": {
      "id": 789,
      "title": "백엔드 개발자 채용"
    },
    "additionalInfo": {
      "gender": "MALE",
      "birthDay": "1995-05-15",
      "militaryService": "TARGET",
      "militaryStatus": "FULL_FILLED",
      "veteranStatus": "NOT_TARGET",
      "isDisability": "NOT_TARGET",
      "careerType": "EXPERIENCED",
      "militaryKind": "ARMY",
      "enlistmentDate": "2015-06-10",
      "dischargeDate": "2017-06-09",
      "address": "서울특별시 강남구",
      "detailAddress": "테헤란로 123, 456동 789호",
      "militaryClass": "SERGEANT"
    },
    "educationalBackgroundsInfo": [
      {
        "kind": "HIGH_SCHOOL_GRADUATE",
        "name": "서울고등학교",
        "isNightUniversity": false,
        "attending": false,
        "startDate": "2011-03-02",
        "endDate": "2014-02-14",
        "isQualificationExaminer": false,
        "minorEducationalBackgrounds": []
      },
      {
        "kind": "BACHELOR_DEGREE",
        "name": "서울대학교",
        "isNightUniversity": false,
        "attending": false,
        "startDate": "2014-03-02",
        "endDate": "2018-02-28",
        "score": "4.2",
        "majorField": "공학",
        "maxScore": "4.5",
        "major": "컴퓨터공학",
        "isQualificationExaminer": false,
        "minorEducationalBackgrounds": [
          {
            "type": "MINOR",
            "kind": "부전공",
            "major": "경영학"
          }
        ]
      }
    ],
    "careersInfo": [
      {
        "inService": false,
        "tenureStartDate": "2018-03-15",
        "tenureEndDate": "2022-05-31",
        "position": "주니어 개발자",
        "job": "백엔드 API 개발 및 유지보수",
        "company": "ABC 테크놀로지",
        "affiliation": "개발팀"
      },
      {
        "inService": true,
        "tenureStartDate": "2022-06-15",
        "position": "시니어 개발자",
        "job": "백엔드 아키텍처 설계 및 개발",
        "company": "XYZ 소프트웨어",
        "affiliation": "서버개발팀"
      }
    ],
    "languageSkillsInfo": [
      {
        "examName": "TOEIC",
        "language": "영어",
        "acquisitionDate": "2017-08-20",
        "grade": "925"
      },
      {
        "examName": "JLPT",
        "language": "일본어",
        "acquisitionDate": "2019-12-15",
        "grade": "N2"
      }
    ],
    "certificatesInfo": [
      {
        "credential": "정보처리기사",
        "issuer": "한국산업인력공단",
        "acquisitionDate": "2017-05-15"
      },
      {
        "credential": "AWS Certified Solutions Architect",
        "issuer": "Amazon Web Services",
        "acquisitionDate": "2020-03-10"
      }
    ],
    "nationalityInfo": {
      "national": "대한민국"
    },
    "foreignNameInfo": {
      "name": "Gildong Hong",
      "nameType": "ENG"
    },
    "outsideActivitiesInfo": [
      {
        "activity": "오픈소스 프로젝트 기여",
        "activityType": "EXTERNAL_ACTIVITY",
        "startDateOfActivity": "2019-01-01",
        "endDateOfActivity": "2021-12-31",
        "location": "GitHub",
        "content": "Spring Boot 관련 오픈소스 프로젝트에 기여"
      },
      {
        "activity": "프로그래밍 경진대회 수상",
        "activityType": "AWARD",
        "startDateOfActivity": "2020-09-15",
        "endDateOfActivity": "2020-09-15",
        "location": "코딩 챌린지 2020"
      }
    ],
    "overseasExperiencesInfo": [
      {
        "countryName": "미국",
        "startDateOfStay": "2016-07-01",
        "endDateOfStay": "2016-08-31",
        "purposeOfStay": "인턴십 프로그램 참가",
        "overseasExperienceType": "EXPATRIATE_DISPATCH"
      }
    ],
    "documentsInfo": [
      {
        "name": "이력서.pdf",
        "downloadUrl": "https://example.com/documents/resume/12345"
      },
      {
        "name": "포트폴리오.pdf",
        "downloadUrl": "https://example.com/documents/portfolio/12345"
      }
    ],
    "questionInfo": [
      {
        "question": "지원 동기를 작성해주세요.",
        "answer": "귀사의 혁신적인 기술과 개발 문화에 깊은 인상을 받아 지원하게 되었습니다. 특히 분산 시스템 아키텍처에 관한 귀사의 접근 방식이 제 경력 목표와 잘 맞는다고 생각합니다."
      },
      {
        "question": "본인의 강점은 무엇인가요?",
        "answer": "문제 해결 능력과 팀 협업 능력이 저의 가장 큰 강점입니다. 복잡한 기술적 문제를 분석하고 효율적인 해결책을 찾는 것을 즐기며, 다양한 배경을 가진 팀원들과 원활하게 소통하고 협력할 수 있습니다."
      }
    ],
    "profileImageUrl": "https://example.com/profileImageUrl/12345",
    "completed": true,
    "redirectUrl": "https://www.doodlin.co.kr"
  }
}