Mastercard · Schema
MerchantSearch
Merchant Search Request Info
Credit CardsDigital IdentityFinancial-ServicesFraud DetectionOpen BankingPaymentsFortune 500
Properties
| Name | Type | Description |
|---|---|---|
| addressLine1 | string | Line 1 of the street address for the merchant location. Usually includes the street number and name. This parameter is ignored if latitude and longitude are provided. If you provide this parameter you |
| addressLine2 | string | Line 2 of the street address usually an apartment number or suite number. This parameter is used rarely and is ignored if latitude and longitude are provided. If you provide this parameter you must al |
| city | string | The name of the city for a merchant location. This parameter is ignored if latitude and longitude are provided. If you provide this parameter you must also provide the Country parameter. |
| countryCode | string | Any two digit country code for a Merchant location. Valid values are two digit alpha country code. This parameter is ignored if latitude and longitude are provided. This parameter is required if any o |
| countrySubdivisionCode | string | The state or province for a merchant location (only supported for US and Canada locations). This parameter is ignored if latitude and longitude are provided. If you provide this parameter you must als |
| latitude | string | The latitude of a merchant location. If latitude is provided longitude must also be provided. |
| longitude | string | The longitude of a merchant location. If longitude is provided latitude must also be provided. |
| merchantCategory | string | Category Id of the merchant location. See the Categories resource for a list of valid categories. Input may be a comma delimited list of category ids. |
| merchantType | string | Type of merchant location. Options are 'paypass' 'repower' 'easysavings' and 'cashback'. |
| offerMerchantId | string | Unique identifier that represents the merchant sponsor of an offer. Any valid merchant ID. |
| postalCode | string | The zip code or postal code for a Merchant location. This parameter is ignored if latitude and longitude are provided. If you provide this parameter you must also provide the Country parameter. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "MerchantSearch",
"type": "object",
"description": "Merchant Search Request Info",
"properties": {
"addressLine1": {
"type": "string",
"description": "Line 1 of the street address for the merchant location. Usually includes the street number and name. This parameter is ignored if latitude and longitude are provided. If you provide this parameter you must also provide the Country parameter and either City parameter or PostalCode parameter."
},
"addressLine2": {
"type": "string",
"description": "Line 2 of the street address usually an apartment number or suite number. This parameter is used rarely and is ignored if latitude and longitude are provided. If you provide this parameter you must also provide the Country parameter and either City parameter or PostalCode parameter."
},
"city": {
"type": "string",
"description": "The name of the city for a merchant location. This parameter is ignored if latitude and longitude are provided. If you provide this parameter you must also provide the Country parameter."
},
"countryCode": {
"type": "string",
"description": "Any two digit country code for a Merchant location. Valid values are two digit alpha country code. This parameter is ignored if latitude and longitude are provided. This parameter is required if any other address information is provided including AddressLine1 AddressLine2 City PostalCode or CountrySubdivision."
},
"countrySubdivisionCode": {
"type": "string",
"description": "The state or province for a merchant location (only supported for US and Canada locations). This parameter is ignored if latitude and longitude are provided. If you provide this parameter you must also provide the Country parameter."
},
"latitude": {
"type": "string",
"description": "The latitude of a merchant location. If latitude is provided longitude must also be provided."
},
"longitude": {
"type": "string",
"description": "The longitude of a merchant location. If longitude is provided latitude must also be provided."
},
"merchantCategory": {
"type": "string",
"description": "Category Id of the merchant location. See the Categories resource for a list of valid categories. Input may be a comma delimited list of category ids."
},
"merchantType": {
"type": "string",
"description": "Type of merchant location. Options are 'paypass' 'repower' 'easysavings' and 'cashback'."
},
"offerMerchantId": {
"type": "string",
"description": "Unique identifier that represents the merchant sponsor of an offer. Any valid merchant ID."
},
"postalCode": {
"type": "string",
"description": "The zip code or postal code for a Merchant location. This parameter is ignored if latitude and longitude are provided. If you provide this parameter you must also provide the Country parameter."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/mastercard-merchant-locations-merchant-search"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.