API

구독 단건 조회

작성일 2026.03.14 | 수정일 2026.03.14

GET/cash/v1/subscribes/:subscribeId

Parameters

subscribeId— 조회할 구독의 고유 ID (32자)

chat

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

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

Response

Name	Type	Required	Description
subscribeId	string	*	구독 고유 ID (32자, 'CA01SU' 접두사)
accountId	string	*	계정 고유 ID
planId	string	*	구독한 플랜 ID
status	string	*	구독 상태. ACTIVE(활성), INACTIVE(비활성), NOT_PAID(미결제), DELETED(삭제됨).
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

{
  "subscribeId": "CA01SU01234567890123456789AB",
  "accountId": "12345678901234",
  "planId": "CA01PL01234567890123456789AB",
  "status": "ACTIVE",
  "settlementDay": "CUSTOM",
  "settlementCustomDate": 15,
  "dateLastPaid": "2024-06-15T15:00:00.000Z",
  "dateCreated": "2024-01-15T10:00:00.000Z",
  "dateUpdated": "2024-06-15T15:00:00.000Z"
}