> For the complete documentation index, see [llms.txt](https://api-kit.prix.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-kit.prix.im/platform/search-schedule.md).

# 일정 목록 조회 API

프로젝트 일정과 재무일정 목록을 조회할 수 있는 API를 제공합니다.

프로젝트 일정과 재무일정(재무정보가 연결된 일정)을 함께 조회할 수 있는 API입니다.

* 프로젝트에 연결된 일정은 API 권한이 연결된 멤버에게 해당 프로젝트 조회 권한이 있을 때만 포함되며, 프로젝트가 없는 일정은 항상 포함됩니다.
* 매출/매입 구분은 `accountingRecord.type`으로, 입금일은 일정의 완료일(`doneDate`)과 입금액(`accountingRecord.doneAmount`)으로 확인할 수 있습니다.
* 매출/매입 합계는 응답에 포함되지 않으므로 행 데이터를 합산해 주세요.

<br>

## `GET` kit-api/v1/schedules

Method: GET\
Endpoint: kit-api/v1/schedules

<br>

## Example

```
...kit-api/v1/schedules?scheduleTimeAfter=2026-01-01T00:00:00.000Z&scheduleTimeBefore=2026-12-31T23:59:59.999Z&hasAccounting=true&limit=100
```

<br>

## Request Query

| Key                | Description                                                      | Required |
| ------------------ | ---------------------------------------------------------------- | -------- |
| limit              | 목록 개수 (default 10, max 100)                                      | no       |
| offset             | 스킵할 목록 개수                                                        | no       |
| scheduleTimeAfter  | 기준일이 해당 날짜 이후인 일정 조회 (date)                                      | no       |
| scheduleTimeBefore | 기준일이 해당 날짜 이전인 일정 조회 (date)                                      | no       |
| dateBasis          | 기간 필터 기준일 (값: CASH 일정일, ACCRUAL 인식일(인식일이 없으면 일정일). default CASH) | no       |
| dealUuid           | 특정 프로젝트의 일정만 조회                                                  | no       |
| customerId         | 재무정보 거래처 고객 id로 조회                                               | no       |
| isDone             | 완료 여부로 조회 (true, false)                                          | no       |
| hasAccounting      | 재무정보 유무로 조회 (true: 재무일정만, false: 일반 일정만, 미지정: 전체)                | no       |
| accountingType     | 매출/매입 구분으로 조회 (REVENUE, COST)                                    | no       |
| tagIds             | 해당 일정 태그들과 연결된 일정 조회 (콤마 구분)                                     | no       |
| orderValue         | 일정일 기준 정렬 방향 (값: ASC, DESC. default ASC)                         | no       |

<br>

## Response

```json
{
  "ok": true, // api 성공
  "data": {
    "total": 1,
    "schedules": [
      {
        "id": 21,
        "title": "1차 청구", // 일정명
        "scheduleTime": "2026-02-01T00:00:00.000Z", // 일정일
        "isDone": true, // 완료 여부
        "doneDate": "2026-02-03T00:00:00.000Z", // 완료일 (재무일정의 입금일로 활용, 없으면 null)
        "dueDate": null, // 마감일 (없으면 null)
        "tags": [{ "id": 9, "name": "청구" }], // 일정 태그
        "deal": { "uuid": "38432ad8-a21f-43b3-9912-44295e3ecca1", "name": "A사 법률 자문", "customKey": "P-2026-001" }, // 연결된 프로젝트 (없으면 null)
        "accountingRecord": {
          // 재무정보 (일반 일정은 null)
          "id": 11,
          "name": "1차 자문료", // 항목명
          "type": "REVENUE", // 매출(REVENUE), 매입(COST)
          "currency": "WON", // 통화 (WON, USD, EUR, JPY)
          "vat": "EXCLUSIVE", // VAT 유형 (EXCLUSIVE 별도, TAX_FREE 면세)
          "amount": 1100000, // 총액 (VAT 포함)
          "supplyAmount": 1000000, // 공급가액
          "taxAmount": 100000, // 세액
          "doneAmount": 1100000, // 입금/수금액 (없으면 null)
          "accrualDate": null, // 인식일 (없으면 null)
          "note": null, // 메모
          "counterpart": { "id": 1, "title": "A컴퍼니", "customKey": "A5-k159402" } // 거래처
        },
        "createdAt": "2026-01-15T00:00:00.000Z", // 생성일
        "updatedAt": "2026-02-03T00:00:00.000Z" // 변경일
      }
    ]
  }
}
```

<br>

```json
{
  "ok": false, // api 실패
  "message": "error message", // Error가 존재하면 message(string)로 전달
  "errorCode": "ERROR_CODE"
}
```

<br>