Glowb Dev Docs
SaaS API전자계약 API

GET /ai/contract/{contractId}/documents

계약서에 첨부된 서류 목록을 조회합니다.

첨부 서류 목록 조회

계약서에 첨부된 서류(신분증/사업자등록증, 통장사본) 목록을 조회합니다.

항목
메서드GET
경로/ai/contract/{contractId}/documents
인증Bearer Token (크리에이터)

요청

GET /ai/contract/1/documents HTTP/1.1
Host: api.glowb.com
Authorization: Bearer {access_token}
curl -X GET "https://api.glowb.com/ai/contract/1/documents" \
  -H "Authorization: Bearer {access_token}"
const response = await fetch('/ai/contract/1/documents', {
  headers: {
    'Authorization': `Bearer ${accessToken}`,
  },
});
const result = await response.json();

Path Parameters

Prop

Type

응답

성공 응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "서류 목록 조회가 완료되었습니다.",
  "data": [
    {
      "id": 1,
      "type": "IDENTIFICATION",
      "typeDisplayName": "신분증",
      "fileUrl": "https://d3mp6eqt0w2808.cloudfront.net/contract/document/101/1/IDENTIFICATION/1710234567890_id_card.jpg",
      "originalFileName": "id_card.jpg",
      "createdAt": "2026-03-12T14:30:00"
    },
    {
      "id": 2,
      "type": "BANK_ACCOUNT_COPY",
      "typeDisplayName": "통장사본",
      "fileUrl": "https://d3mp6eqt0w2808.cloudfront.net/contract/document/101/1/BANK_ACCOUNT_COPY/1710234567890_bankbook.jpg",
      "originalFileName": "bankbook.jpg",
      "createdAt": "2026-03-12T14:35:00"
    }
  ]
}

응답 필드 (배열)

Prop

Type

에러 응답

계약서를 찾을 수 없음 (404)

{
  "status": 404,
  "code": "CONTRACT_NOT_FOUND",
  "message": "계약서를 찾을 수 없습니다.",
  "data": null
}

접근 권한 없음 (403)

{
  "status": 403,
  "code": "CONTRACT_UNAUTHORIZED",
  "message": "해당 계약서에 접근할 권한이 없습니다.",
  "data": null
}

API 테스트

On this page