일정 목록 조회 API

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

• 프로젝트에 연결된 일정은 API 권한이 연결된 멤버에게 해당 프로젝트 조회 권한이 있을 때만 포함되며, 프로젝트가 없는 일정은 항상 포함됩니다.

• 매출/매입 구분은 accountingRecord.type으로, 입금일은 일정의 완료일(doneDate)과 입금액(accountingRecord.doneAmount)으로 확인할 수 있습니다.

• 매출/매입 합계는 응답에 포함되지 않으므로 행 데이터를 합산해 주세요.

GET kit-api/v1/schedules

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

Example

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

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

Response

{
  "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" // 변경일
      }
    ]
  }
}

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