# MATCH API API

> MATCH API API on Apizie: 6 endpoints (Used by Acquirers to add a terminated a merchant in the MATCH system. Merchant information, and up to five…, Returns the contact information for the acquirer id requested. When MATCH returns a possible merchant match,…, Returns detailed information about Merchants, URLs and up to five principal owners, that have been…, Returns the summary of Retro matches for the given Acquirer Id. This resource will return the summary of…, …) returned as clean JSON through one API key. 6 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/open-data:mastercard-match/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Helps acquirers identify potentially high-risk merchants before entering to a merchant agreement.

## Endpoints

### Used by Acquirers to add a terminated a merchant in the MATCH system. Merchant information, and up to five…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-match/post-fraud-merchant-v3-add-merchant`

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

### Returns the contact information for the acquirer id requested. When MATCH returns a possible merchant match,…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-match/post-fraud-merchant-v3-common-contact-details`

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

### Returns detailed information about Merchants, URLs and up to five principal owners, that have been…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-match/post-fraud-merchant-v3-retro-retro-inquiry-details`

| Parameter | Type | Required | Description |
|---|---|---|---|
| AcquirerId | string | yes | The Member ICA number which is used to validate that the application has permission to hit the MATCH database. This number must be… |
| body | object | yes | JSON request body |

### Returns the summary of Retro matches for the given Acquirer Id. This resource will return the summary of…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-match/post-fraud-merchant-v3-retro-retro-list`

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

### Returns information on merchants that have been terminated and merchants that have inquired upon. Provides…
`POST https://zieapi.vercel.app/v1/open-data:mastercard-match/post-fraud-merchant-v3-termination-inquiry`

| Parameter | Type | Required | Description |
|---|---|---|---|
| PageOffset | number | yes | The zero-based offset to start at. The actual start position is this value +1. An offset of 10 starts at item 11. Combined with the… |
| PageLength | number | yes | The maximum number of items to retrieve within the current "page" of results. |
| body | object | yes | JSON request body |

### Returns information about Merchants, URLs and up to five principal owners, that have been terminated by an…
`GET https://zieapi.vercel.app/v1/open-data:mastercard-match/get-fraud-merchant-v3-termination-inquiry-irn`

| Parameter | Type | Required | Description |
|---|---|---|---|
| PageOffset | number | yes | The zero-based offset to start at. The actual start position is this value +1. An offset of 10 starts at item 11. Combined with the… |
| PageLength | number | yes | The maximum number of items to retrieve within the current "page" of results. |
| AcquirerId | string | yes | The Member ICA number which is used to validate that the application has permission to hit the MATCH database. This number must be… |
| IRN | string | yes | Inquiry Reference Number (IRN) A unique identifier generated by the MATCH system that is returned in the original, previously submitted… |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:mastercard-match/post-fraud-merchant-v3-add-merchant" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the MATCH API API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/open-data:mastercard-match/post-fraud-merchant-v3-add-merchant with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the MATCH API 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 MATCH API 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-match.

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