API

증빙서류 목록 조회

작성일 2026.03.17 | 수정일 2026.03.25

GET/senderid/v1/documents

Query

documentId— 문서 ID로 필터링

category— 카테고리로 필터링

use— 사용 여부로 필터링

startDate— 조회 시작 날짜

endDate — 조회 종료 날짜

startKey— 페이지네이션 커서. 이전 응답의 nextKey 값을 전달합니다.

limit— 한 번에 조회할 최대 건수 (기본값: 20, 최소: 1, 최대: 1000)

계정에 업로드한 증빙서류 목록을 조회합니다.

Response

Name	Type	must	Description
data	array	*	문서 객체 배열
documentId	string	*	문서 고유 ID
accountId	string	*	계정 고유 ID
name	string		문서 이름
url	string	*	문서 파일 URL
category	string	*	문서 카테고리
use	boolean	*	사용 여부
dateCreated	string	*	업로드일시 (ISO 8601)
nextKey	string\|null	*	다음 페이지 커서. null이면 마지막 페이지입니다.

Structure

Response

{
  "data": [
    {
      "documentId": "DOC_abc123def456",
      "accountId": "12345678901234",
      "name": "통신서비스이용증명원",
      "url": "https://storage.example.com/documents/DOC_abc123def456.png",
      "originalName": "certificate.png",
      "category": "SENDERID_APPROVAL",
      "use": true,
      "dateCreated": "2024-07-01T12:00:00.000Z"
    }
  ],
  "nextKey": null
}