# MDES Customer Service API

> MDES Customer Service API on Apizie: 15 endpoints (Allows issuers to display customized messages per token within the Apple Pay wallet, below the digitized…, Provides the ability to search for tokens based on Account PAN, Alternate Account Identifier, Token Unique…, Returns the overall system status of the Mastercard Digital Enablement Service., Used to activate a token for a digitization that has been approved and provisioned, but requires additional…, …) returned as clean JSON through one API key. 15 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/open-data:mastercard-mdes/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:mastercard-mdes`
- Category: Open Data
- Status: live
- Source: https://mastercard.com
- Page: https://zieapi.vercel.app/api/open-data/mastercard-mdes
- OpenAPI: https://zieapi.vercel.app/api/open-data/mastercard-mdes/openapi.json

This API provides our Issuer partners with resources to help resolve consumer queries about payment accounts enabled through our digitization platform.

## Endpoints

### Allows issuers to display customized messages per token within the Apple Pay wallet, below the digitized…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-accountholdermessaging`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Provides the ability to search for tokens based on Account PAN, Alternate Account Identifier, Token Unique…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-search`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Returns the overall system status of the Mastercard Digital Enablement Service.
`GET https://zieapi.vercel.app/v1/open-data:mastercard-mdes/get-systemstatus`

### Used to activate a token for a digitization that has been approved and provisioned, but requires additional…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-token-activate`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Used to retrieve the available Activation Methods for a token that is awaiting activation. Activation…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-token-activationmethods`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Used to retrieve all comments associated with a token. Typically the response includes comments created…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-token-comments`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Used to delete a token so that it may not initiate any new transactions. All authorizations for a deleted…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-token-delete`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Used to trigger the process of generating and sending a new Activation Code (for a specific token) to the…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-token-resendactivationcode`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Used to request that the Mobile PIN for a Mastercard Cloud-Based Payment token in a single issuer wallet is…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-token-resetmobilepin`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Used to retrieve the historical statuses and lifecycle events for a token, such as when it was initially…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-token-statushistory`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Used to suspend an active token so that it may not initiate any new transactions. All authorizations for a…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-token-suspend`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Used to unsuspend or resume a suspended token and return it to the active state where it may initiate new…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-token-unsuspend`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Used to update Account PAN Mapping Information or Issuer Product Configuration ID associated to a…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-token-update`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Used to retrieve transactions performed by a token. It only returns transactions performed within the last…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-transactions`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Used after an issuer has performed additional cardholder authentication to indicate an increased level of…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-updatetokenassurance`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-accountholdermessaging" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the MDES Customer Service API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/open-data:mastercard-mdes/post-accountholdermessaging with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the MDES Customer Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the MDES Customer Service API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:mastercard-mdes.

### What is the status of the MDES Customer Service API?
Live: works with just an Apizie key
