Developer API

CheckMCC Public API Documentation

Free, no-auth API for MCC code lookup, merchant search, and credit card rewards eligibility. Build credit card tools on top of CheckMCC data.

Base URL

text
https://check-mcc.vercel.app

Rate Limits

All endpoints are rate-limited to protect the service. Limits are applied per IP address.

  • Standard endpoints: 100 requests per 15 minutes
  • Response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
  • 429 Response: Includes Retry-After header with seconds until reset
Endpoints
GET/api/store-by-domain?domain={domain}

Look up a merchant by website domain. Returns MCC, category, country, and eligible credit cards.

Example Request

bash
curl "https://check-mcc.vercel.app/api/store-by-domain?domain=shopee.sg"

Response

json
{
  "id": "abc123",
  "Store": "Shopee",
  "MCC": "5399",
  "type": "online",
  "Country": "SG",
  "Category": "Miscellaneous General Merchandise",
  "cards": [...],
  "url": "https://shopee.sg",
  "eligibleCards": [
    {
      "name": "UOB Preferred Platinum Visa",
      "shortName": "PPV",
      "eligible": true,
      "mpd": "4 MPD",
      "spendCap": "Cap at $1,000 a month"
    },
    {
      "name": "DBS Woman's Card",
      "shortName": "WWMC",
      "eligible": true,
      "mpd": "4 MPD",
      "spendCap": "Cap at $1,000 a month"
    }
  ]
}
GET/api/store/search?q={query}

Search stores by name. Returns matching merchants with MCC and category.

Example Request

bash
curl "https://check-mcc.vercel.app/api/store/search?q=cold+storage"

Response

json
{
  "success": true,
  "results": [
    {
      "Store": "Cold Storage",
      "MCC": "5411",
      "type": "offline",
      "Country": "SG",
      "Category": "Grocery Stores, Supermarkets"
    }
  ],
  "total": 1
}
GET/api/mcc?mcc={code}&region={region}

Get MCC code details with eligible credit cards for a specific region.

Example Request

bash
curl "https://check-mcc.vercel.app/api/mcc?mcc=5812&region=SG"

Response

json
{
  "success": true,
  "mcc": "5812",
  "description": "Eating Places, Restaurants",
  "category": "Dining",
  "eligibleCards": [
    {
      "name": "HSBC Revolution Card",
      "shortName": "CRMC",
      "eligible": true,
      "mpd": "4 MPD",
      "spendCap": "No cap"
    }
  ]
}
GET/api/mcc/codes

Get the full list of MCC codes with descriptions. Lighter response than the main MCC endpoint.

Example Request

bash
curl "https://check-mcc.vercel.app/api/mcc/codes"

Response

json
{
  "success": true,
  "codes": {
    "5812": "Eating Places, Restaurants",
    "5814": "Fast Food Restaurants",
    "5411": "Grocery Stores, Supermarkets",
    "5541": "Service Stations (with or without Ancillary Services)",
    "5399": "Miscellaneous General Merchandise"
  }
}
GET/api/cards

Get credit card details including reward structures, categories, and spending caps.

Example Request

bash
curl "https://check-mcc.vercel.app/api/cards"

Response

json
{
  "success": true,
  "cards": [
    {
      "name": "UOB Preferred Platinum Visa",
      "shortName": "PPV",
      "bank": "UOB",
      "type": "Visa",
      "rewardRate": "4 MPD",
      "categories": ["5399", "5411"],
      "spendCap": "$1,000/month"
    }
  ]
}

Response format

Success

json
{ "success": true, "data": { ... } }

Error

json
{ "error": "Merchant not found" }    // 404
{ "error": "Missing domain parameter" }  // 400
{ "error": "slow down", "retryAfter": 120 }  // 429

Integrate with AI agents

CheckMCC also supports OpenClaw for AI agent integration. Let ChatGPT, Claude, and other AI tools query MCC data directly.

πŸ’¬Contact me via Telegram