> For the complete documentation index, see [llms.txt](https://api-docs.roundhr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.roundhr.com/round-api/api-reference/jobs/list.md).

# 채용 공고 리스트

## 공고 리스트

<mark style="color:green;">`GET`</mark> `https://api.roundhr.com/v1/jobs`

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

**Headers**

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

**Body**

<table><thead><tr><th width="129">Name</th><th width="93">Type</th><th width="149">필수</th><th width="189">Description</th><th>parameter type</th></tr></thead><tbody><tr><td>title</td><td>string</td><td><code>optional</code></td><td>검색하고자 하는 공고 혹은 직군의 제목</td><td>query</td></tr></tbody></table>

**응답 예제**

{% tabs %}
{% tab title="200" %}

```json
{
   "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":"test-google@gmail.com",
                  "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"
   }
}
```

{% endtab %}
{% endtabs %}