증명서 목록

GET

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

GET

/v1/accounts/:accountId/certificates

curl -G https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/certificates \
     -H "Authorization: Bearer <token>" \
     -d number=07012340001 \
     -d page=0 \
     -d pageSize=20 \
     -d status=issued \
     -d type=telecom_subscription

{
  "data": [
    {
      "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"
    }
  ],
  "meta": {
    "page": 0,
    "pageSize": 20,
    "total": 1
  }
}

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Query parameters

typeenumOptional

Allowed values:

numberstringOptional

이 번호의 증명서만

statusenumOptional

Allowed values:

pageintegerOptional>=0Defaults to 0

0부터 시작하는 페이지 번호

pageSizeintegerOptional1-100Defaults to 20

Response

증명서 목록

datalist of objects

metaobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error