---
title: Get MerchantToken Usage Information Package
framework: Apple Pay Merchant Token Management API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple pay merchant token management api 1.0.12+]
path: merchanttokennotificationservices/get-merchanttoken-usage-information-package
---

# Get MerchantToken Usage Information Package

Retrieve the merchant token usage information package from the merchant server.

## URL

GET https://merchant.example.com/v1/merchantToken/{merchantTokenIdentifier}/usageInformation

## Path Parameters

merchantTokenIdentifier: The unique identifier of the merchant token.

## Header Parameters

Authorization: Authentication for the usage information. The scheme is ApplePayMerchantTokenUsageInformation with the authenticationToken as a parameter. For example, ApplePayMerchantTokenUsageInformation {authenticationToken}.

## Response Codes

200 OK: The request was successful and the response includes the encrypted merchant token usage information package. 401 Unauthorized: Unauthorized. See the body for more details. 404 Not Found: Not found. See the body for more details.

## Discussion

Discussion The user’s device calls this API to get the merchant token usage information package from the merchant server. Devices use the webServiceURL delivered to the Apple Pay server as part of the metadata. For more information on formatting your merchant token usage information, see Adding merchant token usage information

## See Also

### Merchant token usage information

- [Retrieve Merchant Token Public Key](merchanttokennotificationservices/retrieve-merchant-token-public-key.md)
- [MerchantToken Usage Data Availability Notification](merchanttokennotificationservices/merchanttoken-usage-data-availability-notification.md)
- [MerchantTokenUsageDataAvailabilityNotificationRequest](merchanttokennotificationservices/merchanttokenusagedataavailabilitynotificationrequest.md)
- [GetMerchantTokenUsageInformationPackageResponse](merchanttokennotificationservices/getmerchanttokenusageinformationpackageresponse.md)
- [AutomaticReloadPaymentDetails](applepaymerchanttokenusageinformation/automaticreloadpaymentdetails.md)
- [CurrencyAmount](applepaymerchanttokenusageinformation/currencyamount.md)
- [DeferredPaymentDetails](applepaymerchanttokenusageinformation/deferredpaymentdetails.md)
- [PastPayment](applepaymerchanttokenusageinformation/pastpayment.md)
- [PaymentIssueDetails](applepaymerchanttokenusageinformation/paymentissuedetails.md)
- [RecurringPaymentDetails](applepaymerchanttokenusageinformation/recurringpaymentdetails.md)
- [UpcomingPayment](applepaymerchanttokenusageinformation/upcomingpayment.md)
- [UsageInformation](applepaymerchanttokenusageinformation/usageinformation.md)
