GETBearer 토큰

잔액 거래 내역 조회

/api/v1/balance/entries

조직의 거래 내역을 최대 100건 조회합니다. 직접 구매 영수증은 잔액 변동이 0일 수 있으며, 결제 금액은 info의 paidAmount에 표시됩니다.

API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.

요청 예시

cURL

curl "https://tovahub.com/api/v1/balance/entries" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.

응답 예시

JSON

[]

매개변수가 없습니다.

HTTP 상태 200

조직의 최근 원장 항목을 최대 100개 담은 배열을 반환합니다.

[]array

응답의 최상위 값은 배열이며 createdAt 내림차순으로 정렬됩니다.

[]._idstring (ObjectId)

원장 항목 식별자입니다.

[].assetstring

저장된 자산 이름입니다. 이전 자산 이름이 남아 있을 수 있습니다.

[].amountstring

저장된 자산 단위로 나타낸 부호 있는 정수 금액입니다.

[].reasonstring

원장 변동 사유입니다.

[].linkstring

저장된 참조 값이며, HTTP URL이라고 가정하면 안 됩니다.

[].createdAtstring (ISO 8601)

항목 생성 시각입니다.

[].infounknown | null

용도별로 저장된 메타데이터입니다. 공통 중첩 데이터 구조는 정의되어 있지 않습니다.