기업을 위한 그리팅 가이드

공고 지원자 목록 조회

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

요청 URL

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

요청 파라미터

요청 Header

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