---
title: "발신번호 목록 조회"
method: GET
path: "/v2/sender/numbers"
tags: ["Sender"]
---

# 발신번호 목록 조회

`GET /v2/sender/numbers`

사용자가 등록한 발신번호 목록을 조회합니다. 각 발신번호의 인증 상태, 사용 가능 여부, 기본 번호 설정 등을 확인할 수 있으며, 문자 발송 시 사용할 발신번호를 선택하는 데 활용할 수 있습니다.

## Query parameters

- `cursor` number
- `limit` number

## Response `200`

발신번호 목록 조회가 성공적으로 완료되었습니다. 등록된 발신번호 목록과 인증 대기 중인 번호 수, 페이지네이션 정보가 반환됩니다.

- ListUserNumbersResponseDto
  - `code` number, required — HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required — API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "성공", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` ListUserNumberData, required
    - `list` NumberSimple[], required — 사용자가 등록한 발신번호들의 목록입니다. 각 발신번호의 기본 정보와 상태가 포함됩니다.
      - `numberId` number — 발신번호의 ID입니다.
      - `userId` number — 발신번호 소유자의 사용자 ID입니다.
      - `channelId` number — 발신번호가 적용되는 채널의 ID입니다.
      - `senderNumber` string — 실제 발신번호입니다. 하이픈(-) 없이 숫자만 입력하며, 국제 표준 형식을 따릅니다.
      - `numberType` 'MOBILE' | 'LANDLINE' — 발신번호의 유형을 나타냅니다. 일반 번호, 대표 번호, 특수 번호 등으로 구분됩니다.
      - `senderStatus` 'REGISTERED' | 'WAITING' | 'ACTIVE' | 'INPROGRESS' | 'SUSPENDED' | 'DENIED' | 'REJECTED' | 'FREE' | 'EXPIRED' — 발신번호의 현재 상태를 나타냅니다. 승인 대기, 승인 완료, 반려 등의 상태를 구분합니다.
      - `rejectType` 'DOCS' | 'REOPEN' | '' — 발신번호 등록이 반려된 경우의 반려 종류를 나타냅니다. 서류 부족, 정보 오류 등의 사유를 구분합니다.
      - `isDefault` 'Y' | 'N' — 해당 발신번호가 사용자의 기본 발신번호인지 여부를 나타냅니다. Y는 기본 번호, N은 일반 번호입니다.
      - `displayName` string — 발신번호의 표시 이름입니다. 사용자가 지정한 발신번호의 별칭이나 설명을 나타냅니다.
      - `isDuplicatedNumber` number — 동일한 발신번호가 중복으로 등록되어 있는지 여부를 나타냅니다. 1은 중복, 0은 고유를 의미합니다.
      - `numberContractorType` 'COMPANY' | 'COMPANY_EMPLOYEE' | 'COMPANY_CEO' | 'OTHER_COMPANY' — 발신번호 명의자의 유형을 나타냅니다. 개인, 법인, 사업자 등으로 구분됩니다.
      - `companyId` number — 발신번호 소유자의 사업자 등록번호입니다. 법인 명의로 등록된 발신번호의 경우 필수 입력 항목입니다.
      - `companyName` string — 법인명 또는 회사명입니다. 사업자 등록증에 기재된 공식 명칭을 입력하세요.
      - `isHidden` 'Y' | 'N' — 발신번호의 숨김 처리 여부입니다. Y로 설정하면 목록에서 보이지 않으며, N이면 정상적으로 표시됩니다.
      - `createdAt` string, date-time — 발신번호가 시스템에 등록된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
      - `updatedAt` string, date-time — 발신번호 정보가 마지막으로 수정된 날짜와 시간입니다. 상태 변경이나 정보 업데이트 시 갱신됩니다.
    - `todo` number — 현재 인증 대기 중인 발신번호의 개수입니다. 승인을 기다리는 발신번호의 수를 나타냅니다.
    - `cursor` number — 다음 페이지를 요청할 때 사용할 커서 값입니다. 더 이상 데이터가 없으면 null이 됩니다.

---

[API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/revisions/525dedc81a05/schema)