계약서/전자서명 목록 조회 API

계약서 목록을 조회할 수 있는 API입니다.

GET kit-api/v1/contracts

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

Example

...kit-api/v1/contracts?limit=10&offset=0

Request Query

Key	Description	Required
customerCustomKeys	해당 customKeys 속성을 가진 고객들과 연결된 계약서 목록을 조회	no
customerIds	해당 id 속성을 가진 고객들과 연결된 계약서 목록을 조회	no
title	제목으로 계약서 조회 (string)	no
customer	고객이름으로 계약서 조회 (string)	no
participantName	서명참여자 이름으로 계약서 조회 (string)	no
participantEmail	서명참여자 이메일로 계약서 조회 (string)	no
participantPhone	서명참여자 전화번호로 계약서 조회 (string)	no
type	해당 타입에 해당하는 계약서 조회 (NEW, RENEWAL)	no
status	계약 체결 여부에 따른 계약서 조회 (CREATED, CONCLUDED)	no
tagIds	해당 tagIds 속성을 가진 태그들과 연결된 계약서 목록을 조회	no
signature	전자서명 존재 여부에 따라 계약서 조회 (included, excluded)	no
periodStatus	기간 상태에 해당하는 계약서 조회 (before, ongoing, after)	no
createdAtAfter	해당 날짜 이후 생성된 계약서 조회 (date)	no
createdAtBefore	해당 날짜 이전 생성된 계약서 조회 (date)	no
limit	한 번에 몇 개의 값을 받아올지 의미하는 숫자 (max 100)	no
offset	offset 개수 이후만큼의 limit 개수를 조회	no
hasNoCustomer	고객과 연결되지 않은 목록만 조회 (값: true)	no

Response

{
  "ok": true, // api 성공
  "data": {
    "total": 1,
    "contracts": [
      {
        "id": 1,
        "uuid": "akahgk23-afasdvc-asdkhfwh3sd", // 문서 ID (uuid 값을 api에서 사용합니다)
        "customKey": "a4-k1234", // 커스텀 계약 ID
        "title": "A컴퍼니 MOU", // 계약서 이름
        "status": "CREATED", // 계약 상태 (CREATED, CONCLUDED)
        "file": "...contract.pdf", // 원본 계약 문서 url
        "wordFile": "...contract.docx",
        "concludedFile": "...concluded.pdf", // 체결된 계약 문서 url
        "createdAt": "2024-07-05 06:40:35", // 생성일
        "updatedAt": "2024-07-10 07:40:35", // 갱신일
        "signature": {
          // 전자서명 정보
          "uuid": "jvakfljva-fad3edd-badfawdcah", // 전자서명 ID
          "title": "A컴퍼니 MOU 전자서명", // 전자서명 제목
          "expiredDate": "2024-10-05 06:40:35", // 전자서명 만료일
          "status": "WAITING", // 전자서명 상태 (CREATED, WAITING, DONE, CANCELED)
          "createdAt": "2024-07-05 06:40:35", // 생성일
          "participants": [], // 전자서명 참여자 정보
          "objects": [
            {
              // 전자서명 입력값 정보
              "contents": "서울시 강남구 선릉로 551", // 내용
              "type": "TEXT", // 종류 (TEXT, SIGNATURE, CHECKBOX)
              "category": "DEFAULT", // 유형 (DEFAULT, INPUT)
              "name": "주소", // 이름
              "description": "상세 주소를 입력해 주세요." // 설명
            }
          ]
        }
      }
    ]
  }
}

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

Status Code	Error Code	Description
400	INVALID_CUSTOMER_CUSTOM_KEY	규칙을 벗어난 customKey인 경우