---
title: List merchant ids
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-merchantids
---

# List merchant ids

List all merchant Ids for your team.

## URL

GET https://api.appstoreconnect.apple.com/v1/merchantIds

## Query Parameters

fields[certificates]: fields[merchantIds]: filter[identifier]: filter[name]: include: limit: limit[certificates]: sort:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 429 :

## See Also

### Managing merchant IDs

- [Managing merchant IDs and Payment Processing certificates](appstoreconnectapi/managing-payment-processing-certificates.md)
- [Read details for a merchant id](appstoreconnectapi/get-v1-merchantids-_id_.md)
- [List certificates for a merchant id](appstoreconnectapi/get-v1-merchantids-_id_-certificates.md)
- [List certificate IDs for a merchant ID](appstoreconnectapi/get-v1-merchantids-_id_-relationships-certificates.md)
- [Modify merchant ids](appstoreconnectapi/patch-v1-merchantids-_id_.md)
- [Create a merchant id](appstoreconnectapi/post-v1-merchantids.md)
- [Delete a merchant id](appstoreconnectapi/delete-v1-merchantids-_id_.md)