메인 콘텐츠로 건너뛰기
GET
curl
Didit의 List Transactions 엔드포인트는 날짜 범위에 대해 계좌의 거래 내역을 확정 거래와 대기 중 거래 모두 조회하며, 페이지 토큰 방식의 페이지네이션을 사용합니다. 금액은 십진수 형식의 문자열로 제공되며, 은행이 전달하지 않는 필드는 null로 표시됩니다. 사본을 최신 상태로 유지하려면 범위를 다시 조회하는 대신 변경 피드를 사용하십시오.

인증

x-api-key
string
header
필수

귀사 애플리케이션의 API 키입니다. Business Console의 Developers -> API keys에서 확인할 수 있습니다. 기본 키는 모든 권한을 가집니다. 명명된 키는 범위를 지정할 수 있습니다. 리소스별로 권한 없음, 읽기 또는 쓰기를 설정할 수 있고, 일부 워크플로나 승인된 세션으로 제한할 수 있으며, 허용된 IP 목록으로 제한할 수 있고, 만료일을 설정할 수 있습니다. 401은 키가 잘못되었거나, 취소되었거나, 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스 또는 작업에 대한 권한이 없거나, 요청이 IP 목록 밖의 주소에서 왔음을 의미합니다. 세션 경로에서 발생한 404는 세션이 키의 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 동영상 및 PDF URL을 null로 받으며, 세션 쓰기 권한이 없는 키는 세션 링크와 토큰을 null로 받습니다. 자세한 내용은 https://docs.didit.me/console/api-keys 를 참조합니다.

경로 매개변수

account_id
string<uuid>
필수

계좌 ID입니다.

쿼리 매개변수

date_from
string<date>

포함할 첫 번째 유효 날짜이며, 해당 날짜를 포함합니다.

date_to
string<date>

포함할 마지막 유효 날짜(해당 날짜 포함)입니다. 생략하면 상한이 없습니다.

status
enum<string>

확정 거래 또는 대기 중 거래만 해당합니다. 기본값은 둘 다입니다.

사용 가능한 옵션:
booked,
pending
limit
integer
기본값:100

페이지 크기이며, 1~500 사이입니다. 기본값은 100입니다.

필수 범위: 1 <= x <= 500
page_token
string

이전 페이지의 next_page_token입니다.

응답

거래 페이지입니다.

날짜 범위 조회의 한 페이지입니다. 첫 페이지는 포함될 거래를 고정하며, 각 거래는 현재 상태로 제공됩니다. 페이지를 넘기는 동안 삭제된 거래는 이후 페이지에서 빠지며 변경 피드에 보고됩니다.

items
object[]
필수

effective_date 내림차순, 그다음 id 순으로 정렬됩니다.

next_page_token
string | null
필수

이 읽기를 계속합니다. 첫 페이지의 스냅샷을 고정하며, 유효 기간은 1시간이고 읽기에 사용된 애플리케이션, 환경, 계정 및 필터에 연결됩니다.

has_more
boolean
필수
마지막 수정일 2026년 11월 22일