전화번호
표시 번호 목록
삭제하지 않은 전화 발신 표시 번호를 최근 등록 순으로 돌려줍니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
Query Parameters
assignableTo?string
이 관리번호에 걸 수 있는 표기만 돌려줍니다(같은 명의의 승인 건)
status?string
이 상태의 표시 번호만 조회
Value in
"pending" | "approved" | "rejected"limit?integer
한 번에 돌려줄 개수
Default
50Range
1 <= value <= 100cursor?string
이전 응답의 meta.nextCursor
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/presentation-numbers?assignableTo=07012345678&status=approved&limit=50&cursor=cmh1pn0000001"{
"data": [
{
"id": "cmh1pn0000001",
"number": "0212345678",
"type": "landline",
"verificationMethod": "usage_cert",
"status": "approved",
"rejectedReason": null,
"managedHolder": false,
"phoneNumbers": [
"07012340001"
],
"createdAt": "2026-11-04T01:12:30.000Z",
"updatedAt": "2026-11-04T03:20:11.000Z"
}
],
"meta": {
"nextCursor": "cmh1pn0000001"
}
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"processedAt": "2026-10-21T04:10:34.303Z",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
],
"numbers": [
"07012345678"
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"processedAt": "2026-10-21T04:10:34.303Z",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
],
"numbers": [
"07012345678"
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"processedAt": "2026-10-21T04:10:34.303Z",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
],
"numbers": [
"07012345678"
]
}