전화번호

표시 번호 목록

Markdown으로 보기
GET
/v1/accounts/{accountId}/presentation-numbers

삭제하지 않은 전화 발신 표시 번호를 최근 등록 순으로 돌려줍니다.

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

한 번에 돌려줄 개수

Default50
Range1 <= value <= 100
cursor?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"
  ]
}