전화번호 자원 목록 조회

{ "items": [ { "id": "<string>", "number": "<string>", "monthly_fee": 123, "sms_capable": { "send": true, "recv": true }, "carrier": "<string>" } ], "total_count": 123, "next_cursor": "<string>" }

Authorizations

Authorization

string

header

required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Query Parameters

line_type

enum<string> | null

default:voip

회선 종류 필터. 허용값은 TelephoneLineType enum 값(mobile/landline/voip/uan/personal/toll_free)을 따릅니다. telephone_lines.number_type -- 회선 종류.

Available options:

mobile,

landline,

voip,

uan,

personal,

toll_free

cursor

string | null

이전 응답의 next_cursor 값입니다. 다음 페이지를 조회할 때 그대로 전달합니다.

limit

integer

default:50

반환할 최대 항목 수입니다. v3 목록 endpoint는 1~100을 허용합니다.

Required range: 1 <= x <= 100

sort_by

enum<string>

default:number

정렬 기준 필드입니다. 기본값은 number입니다.

Available options:

number,

monthly_fee

sort_order

enum<string>

default:asc

정렬 방향입니다. 허용값은 asc, desc입니다.

Available options:

asc,

desc

Response

성공 응답

구매 가능한 전화번호 자원 목록 페이지 응답입니다.

items

AvailableTelephoneLineResponse · object[]

required

페이지 항목입니다.

Show child attributes

total_count

integer

required

조건에 맞는 전체 항목 수입니다.

next_cursor

string | null

다음 페이지 커서입니다. 조회할 항목이 더 없으면 null입니다.

{ "items": [ { "id": "<string>", "number": "<string>", "monthly_fee": 123, "sms_capable": { "send": true, "recv": true }, "carrier": "<string>" } ], "total_count": 123, "next_cursor": "<string>" }