API

서브계정 목록 조회

작성일 2026.03.21 | 수정일 2026.03.21

GET/appstore/v2/me/apps/:appId/subaccounts
Parameters
appId*— SITE 앱 ID
Query
accountId— 서브계정 ID로 필터링
limit— 반환할 레코드 수
startKey— 페이지네이션 시작 키
dateCreated— 생성일시 필터 (연산자: eq, gt, lt, gte, lte)
dateUpdated— 수정일시 필터 (연산자: eq, gt, lt, gte, lte)
customField1— 커스텀필드1 값으로 필터 (연산자: eq). 최대 250자
customField2— 커스텀필드2 값으로 필터 (연산자: eq). 최대 250자
customField3— 커스텀필드3 값으로 필터 (연산자: eq). 최대 250자
customField4— 커스텀필드4 값으로 필터 (연산자: eq). 최대 250자
customField5— 커스텀필드5 값으로 필터 (연산자: eq). 최대 250자
chat

지원 연사자를 사용하실 경우 Query Operator 가이드를 참조하세요.

마이사이트 앱의 서브계정 목록을 조회합니다. 각 서브계정의 잔액/포인트 정보도 함께 반환됩니다.

Response

NameTypeRequiredDescription
subAccountsarray*서브계정 목록
handleKeystring*서브계정 고유 키 (접두사: AP02SA)
appIdstring*앱 ID
accountIdstring*서브계정 ID
customField1object|null커스텀 필드 1
namestring|null필드 이름
valuestring|null필드 값 (최대 250자)
customField2object|null커스텀 필드 2
namestring|null필드 이름
valuestring|null필드 값 (최대 250자)
customField3object|null커스텀 필드 3
namestring|null필드 이름
valuestring|null필드 값 (최대 250자)
customField4object|null커스텀 필드 4
namestring|null필드 이름
valuestring|null필드 값 (최대 250자)
customField5object|null커스텀 필드 5
namestring|null필드 이름
valuestring|null필드 값 (최대 250자)
balancenumber*서브계정 잔액 (원)
pointnumber*서브계정 포인트
dateCreatedstring*생성일시 (ISO 8601)
dateUpdatedstring*수정일시 (ISO 8601)
startKeystring|null*다음 페이지 시작 키. null이면 마지막 페이지

Structure

Response
{ "subAccounts": [ { "handleKey": "AP02SA_abc12345678901234567890", "appId": "aBcDeFgHiJkL", "accountId": "12345678901234", "customField1": { "name": "부서", "value": "마케팅팀" }, "customField2": { "name": "담당자", "value": "홍길동" }, "customField3": null, "customField4": null, "customField5": null, "balance": 50000, "point": 10000, "dateCreated": "2024-01-15T09:00:00.000Z", "dateUpdated": "2024-03-20T14:30:00.000Z" } ], "startKey": null }