Mall StoryDevelopers
Mall Story
관리자 API회원 관리소유자 토큰

회원 목록

회원 목록을 이름 · 메일 · 휴대폰 · 상태로 걸러 읽습니다.

업데이트됨 10.13 — 목록 정렬 sort · order 를 받습니다

목록

GEThttps://api.mallstory.kr/v1/shop/{shop_unique}/members

권한 customers:read

쿼리형식설명
pagenumber쪽 번호(1부터, 기본 1)
sizenumber쪽당 건수(기본 10, 최대 100)
namestring이름 포함 검색
emailstring메일 포함 검색
mobilestring휴대폰 포함 검색(숫자만)
statusstring회원 상태(쉼표로 여럿). 탈퇴 회원은 나오지 않습니다 코드값
sortstring정렬 키. 관리자 회원 목록의 정렬과 같습니다. 빼면 member_no 내림차순(최신 가입순) 코드값
orderstring정렬 방향. 빼면 desc. sort 와 함께 보냅니다 — 혼자 보내면 400 코드값
bash요청
curl 'https://api.mallstory.kr/v1/shop/6a9515bdcb3ab5179ba767ad/members?size=2&name=상품시험' \
  -H 'Authorization: Bearer msat_8Hk2wQ7...'
json200 OK
{
  "items": [
    {
      "member_unique": "6accb17807e52ce89536610b",
      "member_no": 11,
      "login_id": "e2eprod",
      "provider": "LOCAL",
      "name": "상품시험",
      "status": "ACTIVE",
      "level": {
        "level_unique": "6aa0e089fc6e77ca0e475eef",
        "name": "플래티넘"
      },
      "address": null,
      "consent_email": {
        "agreed": false,
        "at": null
      },
      "consent_sms": {
        "agreed": false,
        "at": null
      },
      "point": 0,
      "created": "2026-10-12T10:07:52.337Z",
      "last_login_at": null,
      "memo": ""
    }
  ],
  "page": 1,
  "size": 2,
  "total": 1,
  "has_more": false
}

응답 필드

필드형식설명
itemsarray회원 줄(필드는 상세와 같고 memo 가 없음)
pagenumber지금 쪽 번호
sizenumber쪽당 건수
totalnumber조건에 맞는 전체 건수
has_moreboolean다음 쪽이 있는가

오류

상태code언제
401MissingLoginSessionAuthorization 헤더에 Bearer 토큰이 없음
401InvalidAccessToken토큰이 틀리거나 만료 · 폐기됨
403InsufficientScope토큰에 customers:read 가 없음