API

구독 목록 조회

작성일 2026.03.14 | 수정일 2026.03.14

GET/cash/v1/subscribes

Query

subscribeId— 특정 구독 ID로 조회 (32자)

planId— 특정 플랜 ID로 필터링 (32자)

settlementDay— 정산일 유형 필터. LAST(매월 말일) 또는 CUSTOM(지정일).

settlementCustomDate— 정산 지정일 필터 (1~31). settlementDay가 CUSTOM인 경우에만 유효합니다.

startKey— 이전 응답의 nextKey를 전달하여 다음 페이지 조회

limit— 조회 건수 (기본값: 20, 최소: 1)

dateCreated— 생성일 필터(ISO 8601). 지원 연산자 eq, gte, lte, gt, lt

dateUpdated— 수정일 필터(ISO 8601). 지원 연산자 eq, gte, lte, gt, lt

chat

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

현재 계정의 플랜 구독 정보 목록을 조회합니다. 삭제(DELETED) 상태의 구독은 제외됩니다.

Response

Name	Type	Required	Description
startKey	string\|null	*	현재 조회의 시작 키
nextKey	string\|null	*	다음 페이지 조회를 위한 키
limit	number	*	요청한 조회 건수
subscribeList	array	*	구독 정보 목록
subscribeId	string	*	구독 고유 ID (32자, 'CA01SU' 접두사)
accountId	string	*	계정 고유 ID
planId	string	*	구독한 플랜 ID
status	string	*	구독 상태. ACTIVE(활성), INACTIVE(비활성), NOT_PAID(미결제).
settlementDay	string	*	정산일 유형. LAST(매월 말일) 또는 CUSTOM(지정일).
settlementCustomDate	number\|null	*	정산 지정일 (1~31). settlementDay가 CUSTOM인 경우에만 유효.
dateLastPaid	string	*	마지막 결제 일시 (ISO 8601)
dateCreated	string	*	구독 생성 일시 (ISO 8601)
dateUpdated	string	*	최종 수정 일시 (ISO 8601)

Structure

Response

{
  "startKey": null,
  "nextKey": null,
  "limit": 20,
  "subscribeList": [
    {
      "subscribeId": "CA01SU01234567890123456789AB",
      "accountId": "12345678901234",
      "planId": "CA01PL01234567890123456789AB",
      "status": "ACTIVE",
      "settlementDay": "LAST",
      "settlementCustomDate": null,
      "dateLastPaid": "2024-06-30T15:00:00.000Z",
      "dateCreated": "2024-01-15T10:00:00.000Z",
      "dateUpdated": "2024-06-30T15:00:00.000Z"
    }
  ]
}