---
title: Get Merchant Details
framework: Apple Pay Web Merchant Registration API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple pay web merchant registration api 1.0+]
path: applepaywebmerchantregistrationapi/get-merchant
---

# Get Merchant Details

Retrieve information about a registered merchant’s current state by using the merchant’s internal merchant identifier.

## URL

GET https://apple-pay-gateway.apple.com/paymentservices/merchant/${partnerInternalMerchantIdentifier}

## Path Parameters

partnerInternalMerchantIdentifier: A unique identifier for the merchant that the e-commerce partner created and used in the Register Merchant request.

## Response Codes

200 OK: Success. The response contains an object with information for the registered merchant. 400 Bad Request: The request is malformed or invalid, or the merchant isn’t registered. 401 Unauthorized: The e-commerce platform doesn’t have permission to call this API. 417 Expectation Failed: The e-commerce platform isn’t registered with Apple Developer. 500 Internal Server Error: An internal server error occurred.

## Discussion

Discussion Get information about a merchant you previously registered. You provide the merchant’s unique identifier (partnerInternalMerchantIdentifier). A succesful response contains a MerchantDetails object in the response body.

## See Also

### Web Merchant Details

- [MerchantDetails](applepaywebmerchantregistrationapi/merchantdetails.md)