---
title: "결제내역 복수조회 API"
method: GET
path: "/payments"
tags: ["payments"]
---

# 결제내역 복수조회 API

`GET /payments`

여러 개의 포트원 거래고유번호 또는 고객사 주문번호로 결제내역을 한 번에 조회합니다.(최대 100개)
     <br>(예시) /payments?imp_uid[]=imp_448280090638&imp_uid[]=imp_448280090639&merchant_uid[]=merchant_143434085216

## Query parameters

- `imp_uid[]` string[]
- `merchant_uid[]` string[]

## Response `200`

요청된 모든 imp_uid 에 대한 결제정보 응답완료

- MultiplePaymentsResponse — unresolved $ref

## Other responses

- `207` — 요청된 imp_uid 중 일부 거래 조회 실패(ex. 접근권한없음 또는 존재하지 않는 imp_uid)
- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `404` — 해당되는 결제건을 찾지 못하였습니다.

---

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