---
title: "빌링키 정보 복수조회 API"
method: GET
path: "/subscribe/customers"
tags: ["subscribe.customer"]
---

# 빌링키 정보 복수조회 API

`GET /subscribe/customers`

여러 개의 빌링키를 한 번에 조회하는 API입니다.<br><br>등록된 카드마다 1개의 customer_uid가 매핑되므로,
     고객사 시스템 내에 1명의 고객이 여러 장의 카드를 등록할 수 있는 경우 여러 개의 customer_uid를 가지게 됩니다.<br> 해당 고객이 등록해놓은 카드정보 목록을 한 번에 조회하는데 사용하면 편리합니다.
     <br><br>예시) /subscribe/customers?customer_uid[]=hong_1234_a&customer_uid[]=hong_1234_b

## Query parameters

- `customer_uid[]` string[], required

## Response `200`

요청된 모든 customer_uid 에 대한 빌키정보 응답완료. 조회된 빌링키에 따라 일반 빌링키(CustomerAnnotation)와 슈퍼 빌링키(SuperBillingKeyAnnotation)를 포함할 수 있습니다.

- MultipleCustomersResponse — unresolved $ref

## Other responses

- `207` — 요청된 customer_uid 중 일부 빌키정보 조회 실패(ex. 접근권한없음 또는 존재하지 않는 customer_uid). 조회된 빌링키에 따라 일반 빌링키(CustomerAnnotation)와 슈퍼 빌링키(SuperBillingKeyAnnotation)를 포함할 수 있습니다.
- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `404` — 유효하지 않은 customer_uid

---

[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)