채용 공고 리스트

공고 리스트

GET https://api.roundhr.com/v1/jobs

등록하신 공고의 리스트를 반환합니다. 페이지네이션이 적용됩니다.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	필수	Description	parameter type
title	string	optional	검색하고자 하는 공고 혹은 직군의 제목	query

응답 예제

200

{
   "collection":[
      {
         "code": null,
         "title": "채용공고",
         "url": "https://whattime.recruit.roundhr.com/c/code_bd5cb335a7"
         "created_at": "2024-09-02T18:56:37+09:00",
         "updated_at": "2024-09-02T18:56:37+09:00",
         "position": {
            "title": "프론트 개발자",
            "created_at": "2024-09-02T18:56:37+09:00",
            "updated_at": "2024-09-02T18:56:37+09:00"
         },
         "application_form": {
            "uri": "https://api.roundhr.com/v1/{path}/{code}"
            "code": "code_bd5cb335a7",
            "title": "지원서",
            "status": "in_progress",
            "career_kind": "not_required",
            "career_start": 2,
            "career_end": 5,
            "employment_type": "full_time",
            "address": "서울 강남구 테헤란로 507",
            "address2": "F5",
            "content": "<h3>회사 소개</h3>",
            "open_status": true,
            "resume_required": true,
            "end_at": "2024-12-31T00:00:00+09:00",
            "expired": false,
            "created_at": "2024-09-02T18:56:37+09:00",
            "updated_at": "2024-09-02T18:56:37+09:00"
         },
         "managers":[
            {
               "kind": "job_admin",
               "created_at":"2024-09-02T18:56:37+09:00",
               "updated_at":"2024-09-02T18:56:37+09:00",
               "user":{
                  "code":"code_9a406ea996",
                  "email":"[email protected]",
                  "role":"admin",
                  "name":"김라운",
                  "phone":null,
                  "position":null,
                  "created_at":"2024-09-02T18:56:37+09:00",
                  "updated_at":"2024-09-02T18:56:37+09:00"
               }
            }
         ],
         "stages":[
            {
               "stage_kind":"applied",
               "title":"지원",
               "created_at":"2024-09-02T18:56:37+09:00",
               "updated_at":"2024-09-02T18:56:37+09:00"
            },
            {
               "stage_kind":"review",
               "title":"서류 검토",
               "created_at":"2024-09-02T18:56:37+09:00",
               "updated_at":"2024-09-02T18:56:37+09:00"
            },
            {
               "stage_kind":"interview",
               "title":"면접",
               "created_at":"2024-09-02T18:56:37+09:00",
               "updated_at":"2024-09-02T18:56:37+09:00"
            },
            {
               "stage_kind":"offer",
               "title":"처후협의",
               "created_at":"2024-09-02T18:56:37+09:00",
               "updated_at":"2024-09-02T18:56:37+09:00"
            },
            {
               "stage_kind":"pass",
               "title":"합격",
               "created_at":"2024-09-02T18:56:37+09:00",
               "updated_at":"2024-09-02T18:56:37+09:00"
            },
            {
               "stage_kind":"failed",
               "title":"불합격",
               "created_at":"2024-09-02T18:56:37+09:00",
               "updated_at":"2024-09-02T18:56:37+09:00"
            }
         ]
      }
   ],
   "pagination":{
      "total":1,
      "previous_page": "MTk=_N",
      "previous_page_token": "https://api.roundhr.com/v1/{path}?page_token=MTk=_N",
      "next_page": "MTk=_N",
      "next_page_token": "https://api.roundhr.com/v1/{path}?page_token=MTk=_N"
   }
}