Open API 앱을 활성화하기 이전의 주문·결제 데이터도 조회할 수 있습니다. 데이터가 토스플레이스 서버에 저장되어 있으므로, 앱 설치 이후에 발생한 데이터만 조회되는 구조는 아닙니다.

1. 과거 데이터 조회 범위

앱이 연결된 매장의 서버 저장 데이터를 조회할 수 있으며, 앱 설치 시점이나 최근 몇 개월을 기준으로 조회기간을 제한하지 않습니다.

2. 한 번에 지정할 수 있는 기간

from~to 사이의 기간에 별도의 최대 일수 제한은 없습니다. 다만 두 값은 주문 생성 시각이 아니라 결제 내역이 변동된 시각을 기준으로 조회합니다. 주문 조회 가이드를 참고해 주세요.

3. 과거 주문을 여러 페이지로 조회할 때

한 페이지는 기본 100건, 최대 500건입니다. 호출량은 토큰이 최대 100개까지 충전되고 초당 10개씩 보충되는 방식으로 제한됩니다. 요청마다 토큰 1개를 사용하며, 한도를 초과하면 HTTP 429가 반환됩니다.

응답 헤더의 x-ratelimit-remaining과 x-ratelimit-reset을 확인해 호출 속도를 조정해 주세요. 호출량 제한 가이드를 참고해 주세요.

4. 결제 내역 조회

결제 내역도 앱 활성화 이전 데이터라는 이유로 조회가 제한되지는 않습니다. 주문 목록에서 주문 ID를 확인한 뒤, 주문의 결제건 모두 조회 API로 해당 주문의 결제 내역을 조회할 수 있습니다. 결제 조회 가이드를 참고해 주세요.