인증 이력 조회

계정의 인증 이력을 페이지네이션으로 조회합니다.

Authorization

BearerAuth

AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Query Parameters

channel?string

채널로 거릅니다.

Value in"sms" | "call" | "sms_inbound"

status?string

상태로 거릅니다.

to?string

인증 대상 번호로 거릅니다.

createdAfter?string

이 시각 이후에 만들어진 건만.

Formatdate-time

createdBefore?string

이 시각 이전에 만들어진 건만.

Formatdate-time

page?integer

0부터 시작합니다.

Default0

Range0 <= value

pageSize?integer

한 쪽에 담을 건수.

Default20

Range1 <= value <= 100

Response Body

`application/json`

curl -X GET "https://example.com/v2/verifications?channel=sms&status=verified&to=01012345678&createdAfter=2026-09-18T00%3A00%3A00.000Z&createdBefore=2026-09-19T00%3A00%3A00.000Z&page=0&pageSize=20"

{
  "data": [
    {
      "verificationId": "VE1a2b3c4d5e6f7a8b",
      "status": "pending",
      "channel": "sms",
      "to": "01012345678",
      "from": "07052358010",
      "codeLength": 6,
      "remainingAttempts": 5,
      "expiresAt": "2019-08-24T14:15:22Z",
      "createdAt": "2019-08-24T14:15:22Z",
      "verifiedAt": "2019-08-24T14:15:22Z",
      "instruction": {
        "type": "string",
        "sendTo": "string",
        "body": "string",
        "callTo": "string",
        "code": "string",
        "deadline": "2019-08-24T14:15:22Z"
      }
    }
  ],
  "meta": {
    "page": 0,
    "pageSize": 0,
    "total": 0
  }
}

{
  "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·대표번호만 발급됩니다."
    }
  ]
}

인증 이력 조회

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`