API Reference
증명서 목록
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
Query Parameters
type?string
Value in
"telecom_subscription"number?string
이 번호의 증명서만
status?string
Value in
"issued" | "revoked"page?integer
0부터 시작하는 페이지 번호
Default
0Range
0 <= valuepageSize?integer
Default
20Range
1 <= value <= 100Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/certificates?type=telecom_subscription&number=07012340001&status=issued&page=0&pageSize=20"{
"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
}
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}