기업을 위한 그리팅 가이드

🆕 공고 지원자 목록 조회

공고의 지원자 목록을 조회합니다. 채용 단계와 지원서 상태로 필터링할 수 있습니다.

요청 URL

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

요청 파라미터

X-Api-Version: 1.0

요청 Path

필드	타입	필수 여부	설명	파라미터 타입
openingId	Number	`필수`	그리팅 공고 Id 입니다.	Path

요청 Query

필드	타입	필수 여부	설명
processOnOpeningId	Number	`옵션`	채용단계 ID 입니다. 공고 상세 정보 조회 V3 API 응답의 `processInfo` 에서 확인할 수 있습니다. 요청한 공고에 속한 단계여야 합니다.
status	String	`옵션`	지원자 상태 입니다. 미지정시 전체 상태를 조회합니다. 상태내역 SUBMIT: 평가중 REJECT: 불합격 PASS: 합격
cursor	Number	`옵션`	페이지네이션 커서 입니다. 이전 응답의 `nextCursor` 값을 전달하면 해당 지원자 ID 미만의 지원자를 조회합니다. 첫 요청시 생략합니다. 지정시 1 이상이어야 합니다.
limit	Number	`옵션`	한 번에 조회할 지원자 수 입니다. 기본값 1,000 최소 1 최대 5,000

응답 객체

필드	타입	필수 여부	설명
applicants	Object[]	`필수`	지원자 목록 지원자 ID 내림차순 정렬
nextCursor	Number	`옵션`	다음 페이지 커서 (마지막 지원자 ID) 다음 페이지가 없으면 `null`

응답객체 상세(applicants)

응답에 포함되지 않는 추가정보는 지원자 상세 정보 API를 사용해주세요.

필드	타입	필수 여부	설명
applicantId	Number	`필수`	지원자 ID
name	String	`필수`	지원자 이름
email	String	`옵션`	이메일, 없으면 null
phone	String	`옵션`	전화번호, 없으면 null
status	String	`필수`	지원자 상태 SUBMIT: 평가중 REJECT: 불합격 PASS: 합격
processOnOpeningId	Number	`필수`	현재 채용 단계 ID
submitDate	String	`필수`	지원서 제출 일시 (ISO-8601)

예시 응답

JSON