Sender
발신번호 목록 조회
사용자가 등록한 발신번호 목록을 조회합니다. 각 발신번호의 인증 상태, 사용 가능 여부, 기본 번호 설정 등을 확인할 수 있으며, 문자 발송 시 사용할 발신번호를 선택하는 데 활용할 수 있습니다.
get/v2/sender/numbers
Query parameters
cursornumber
페이징을 위한 커서 값입니다. 첫 페이지 조회 시에는 0을 사용하고, 다음 페이지 조회 시에는 이전 응답의 cursor 값을 사용하세요.
limitnumber
한 번에 조회할 발신번호의 최대 개수입니다. 기본값은 20개이며, 너무 큰 값을 설정하면 응답 속도가 느려질 수 있습니다.
Response
발신번호 목록 조회가 성공적으로 완료되었습니다. 등록된 발신번호 목록과 인증 대기 중인 번호 수, 페이지네이션 정보가 반환됩니다.
Example response
{
"code": 200,
"message": "성공",
"data": {
"list": [
{
"numberId": 12345,
"senderNumber": "01012345678",
"numberType": "SMS",
"senderStatus": "APPROVED",
"isDefault": "Y",
"displayName": "회사 대표번호"
}
],
"todo": 2,
"cursor": 20
}
}