---
title: "빌링키 결제 복수조회 API (빌링키 결제 내역 확인)"
method: GET
path: "/subscribe/customers/{customer_uid}/payments"
tags: ["subscribe.customer"]
---

# 빌링키 결제 복수조회 API (빌링키 결제 내역 확인)

`GET /subscribe/customers/{customer_uid}/payments`

구매자의 빌링키로 결제된 결제목록을 조회합니다.

## Path parameters

- `customer_uid` string, required

## Query parameters

- `page` integer

## Response `200`

정상 조회

- PaymentListResponse — 결제 상세정보. 바로 아래 Payment structure를 확인하세요
  - `code` integer — 0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다
  - `message` string — code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다
  - `response` PagedPaymentAnnotation — unresolved $ref

## Other responses

- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `404` — 유효하지 않은 customer_uid

---

[API](https://skmtc.net/iamport/apis/rest-api.md) · [All operations](https://skmtc.net/iamport/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iamport/rest-api/revisions/006dfffdec43/schema)