Visa · Example Payload

Visa Merchant Search Example

AccountBankingCredit CardsDigital CommerceDigital WalletFintechForeign ExchangeFraud PreventionMerchantsMoney MovementPaymentsTokenizationFortune 500

Visa Merchant Search Example is an example object payload from Visa, with 2 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

requestresponse

Example Payload

{
  "request": {
    "method": "POST",
    "path": "/merchantsearch/v1/search",
    "headers": {
      "Content-Type": "application/json"
    },
    "body": {
      "header": {
        "messageDateTime": "2026-05-03T12:00:00.000Z",
        "requestMessageId": "req-1234567890",
        "startIndex": 0
      },
      "merchantName": "Starbucks",
      "merchantCountryCode": "840",
      "merchantCity": "San Francisco",
      "merchantState": "CA",
      "merchantPostalCode": "94104"
    }
  },
  "response": {
    "status": 200,
    "body": {
      "header": {
        "responseMessageId": "res-1234567890",
        "status": {
          "statusCode": "CDI000",
          "statusDescription": "Success"
        },
        "requestMessageId": "req-1234567890",
        "noOfRecordsReturned": 2
      },
      "merchantList": [
        {
          "visaMerchantId": "12345678",
          "visaStoreId": "87654321",
          "merchantName": "Starbucks",
          "merchantCountryCode": "840",
          "merchantCity": "San Francisco",
          "merchantState": "CA",
          "merchantPostalCode": "94104",
          "merchantStreetAddress": "1 Market Street"
        }
      ]
    }
  }
}

Work with this as data

Every example 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 examples

4 MCP tools reach this

find_examplesBrowse and filter every example 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.

All 92 tools

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/visa-merchant-search-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.