증명서 조회

GET

https://api.claw-ops.com/v1/accounts/:accountId/certificates/:certificateNumber

GET

/v1/accounts/:accountId/certificates/:certificateNumber

curl https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/certificates/KAT-20261016-0001 \
     -H "Authorization: Bearer <token>"

{
  "certificateNumber": "KAT-20261016-0001",
  "type": "telecom_subscription",
  "title": "통신서비스 이용증명원",
  "holder": {
    "type": "business",
    "name": "주식회사 예시",
    "registrationNumber": "123-45-67890",
    "birthDate": "1980-**-**"
  },
  "subject": {
    "number": "07012340001",
    "numberType": "internet_phone",
    "subscriptionDate": "2026-08-14"
  },
  "issueDate": "2026-10-16",
  "status": "issued",
  "revokedAt": null,
  "revokedReason": null,
  "pdfSha256": "3b5f0c1e9a7d4b2e8f6a1c0d9e8b7a6f5e4d3c2b1a0f9e8d7c6b5a4f3e2d1c0b",
  "pdfPath": "/v1/accounts/AC1a2b3c4d/certificates/KAT-20261016-0001/pdf",
  "createdAt": "2026-10-16T01:02:03.000Z"
}

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

certificateNumberstringRequiredformat: "^KAT-[0-9]{8}-[0-9]{4,}$"

발급번호(문서에 찍힌 번호)

Response

증명서

certificateNumberstring

발급번호 KAT-YYYYMMDD-NNNN(날짜 = KST 발급일)

typeenum

Allowed values:

titlestring

발급 당시 문서 제목

holderobject

문서에 찍힌 명의. 사업자 계정은 상호·사업자등록번호, 개인 계정은 그 번호에 연결된 본인확인 명의다. 관리번호(발급 링크로 최종이용자에게 배정한 번호)는 계정과 관계없이 최종이용자 명의다 — 법인은 발급 때 확인한 상호·사업자등록번호, 개인은 본인확인 명의. 개인의 생년월일은 가려서 돌려준다(원문은 PDF 에만 있다).

subjectobject

telecom_subscription(통신서비스 이용증명원)이 증명하는 대상 — 번호와 가입일.

issueDatedate

statusenum

Allowed values:

revokedAtdatetime or null

revokedReasonstring or null

pdfSha256string or null

PDF 파일의 SHA-256(hex). 받은 파일과 대조할 수 있다.

pdfPathstring

PDF 다운로드 경로(이 API 의 GET …/pdf)

createdAtdatetime

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error