The /api/mcc endpoint provides programmatic access to 1,067 official Merchant Category Codes governed by the ISO 18245:2023 international standard. Every entry includes official industry titles, multi-network regulatory citations (Visa, Mastercard, and American Express merchant data manuals), taxonomy reward categories, and mathematically optimal credit card yields.

To test this endpoint interactively, use the API Explorer.


Request

GET  https://www.axetip.com/api/mcc?code={code}
GET  https://www.axetip.com/api/mcc?category={category}
POST https://www.axetip.com/api/mcc

Parameters

ParameterTypeInRequiredDescription
codestringQuery (GET)No*Single 4-digit code (e.g. 5812) or comma-separated list (e.g. 5812,5411).
categorystringQuery (GET)No*Taxonomy category slug (e.g. dining, supermarkets, travel_general, gas_and_ev).
codestring or arrayBody (POST)No*4-digit code or array of codes (e.g. ["5812", "5411"]).
categorystringBody (POST)No*Category slug filter.

* At least one filter (code or category) must be provided.

Request Headers

HeaderValueDescription
Acceptapplication/jsonExpected response content type.
Content-Typeapplication/jsonRequired for POST requests.

Cross-Network Regulatory Citations

Classification rules and definitions are verified against official network interchange manuals:

  • Visa Inc.: Visa Merchant Data Standards Manual (ISO 18245 Compliance)
  • Mastercard International: Quick Reference Booklet — Merchant Edition (MCC Listings)
  • American Express: Merchant Category Codes Policy Guide

Response Schema

FieldTypeDescription
statusstringRequest status ("success" or "error").
countintegerNumber of MCC records returned.
dataobject or arraySingle MCC record (when single code queried) or array of records.
data.codestring4-digit ISO 18245 merchant category code.
data.titlestringCanonical industry description.
data.reward_categorystringHigh-level reward category (dining, supermarkets, travel, etc.).
data.is_cash_advancebooleanWhether transactions under this MCC are classified as cash advances.
data.documentation_urlstringCanonical documentation page on AxeTip.
data.optimal_cardobjectThe highest-earning credit card for this merchant category.
data.optimal_card.idstringCard slug.
data.optimal_card.namestringCard product name.
data.optimal_card.annual_feeMoneyAmountAnnual fee value object.
data.optimal_card.reward_yieldRewardYieldReward yield value object with units and basis points.

Example Responses

1. Single Code Lookup (GET /api/mcc?code=5812)

{
  "status": "success",
  "count": 1,
  "data": {
    "code": "5812",
    "title": "Eating Places And Restaurants",
    "reward_category": "dining",
    "is_cash_advance": false,
    "documentation_url": "https://www.axetip.com/reg/iso/18245/mcc/5812/",
    "optimal_card": {
      "id": "hilton-honors-aspire",
      "name": "Hilton Honors American Express Aspire Card",
      "issuer": "American Express",
      "annual_fee": {
        "value": 550.0,
        "cents": 55000,
        "formatted": "$550.00",
        "currency": "USD"
      },
      "reward_yield": {
        "value": 7.0,
        "unit": "x",
        "formatted": "7.0x",
        "basis_points": 700
      },
      "canonical_url": "https://www.axetip.com/card/hilton-honors-aspire/"
    }
  }
}

2. Category Filter (GET /api/mcc?category=supermarkets)

Returns all MCCs classified under the supermarkets reward category (e.g. 5411, 5422, 5499).

3. Batch POST Lookup

POST https://www.axetip.com/api/mcc
Content-Type: application/json

{
  "code": ["5812", "5411", "5541"]
}

Code Samples

cURL

curl -s "https://www.axetip.com/api/mcc?code=5812"

TypeScript / Node.js

interface MccRecord {
  code: string;
  title: string;
  reward_category: string;
  optimal_card: {
    name: string;
    annual_fee: { formatted: string };
    reward_yield: { formatted: string };
  } | null;
}

const res = await fetch("https://www.axetip.com/api/mcc?code=5812");
const data = await res.json();
const rec: MccRecord = data.data;

console.log(`MCC ${rec.code}: ${rec.title} (${rec.reward_category})`);
if (rec.optimal_card) {
  console.log(`  Top Card: ${rec.optimal_card.name} (${rec.optimal_card.reward_yield.formatted})`);
}

Python

import httpx

url = "https://www.axetip.com/api/mcc"
params = {"code": "5812"}
response = httpx.get(url, params=params, timeout=10.0)
data = response.json()
rec = data["data"]

print(f"MCC {rec['code']}: {rec['title']} [{rec['reward_category']}]")
if rec.get("optimal_card"):
    opt = rec["optimal_card"]
    print(f"  Top Card: {opt['name']} ({opt['reward_yield']['formatted']})")

Go

package main

import (
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

type MccResponse struct {
	Data struct {
		Code        string `json:"code"`
		Title       string `json:"title"`
		OptimalCard *struct {
			Name        string `json:"name"`
			RewardYield struct {
				Formatted string `json:"formatted"`
			} `json:"reward_yield"`
		} `json:"optimal_card"`
	} `json:"data"`
}

func main() {
	resp, _ := http.Get("https://www.axetip.com/api/mcc?code=5812")
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)

	var res MccResponse
	json.Unmarshal(body, &res)
	fmt.Printf("MCC %s: %s\n", res.Data.Code, res.Data.Title)
	if res.Data.OptimalCard != nil {
		fmt.Printf("  Optimal Card: %s (%s)\n", res.Data.OptimalCard.Name, res.Data.OptimalCard.RewardYield.Formatted)
	}
}

Status Codes

Status CodeDescription
200 OKRequest succeeded. Matching MCC records returned.
400 Bad RequestMissing required search filter (code or category).
404 Not FoundSpecified MCC code does not exist.
429 Too Many RequestsRate limit exceeded (60 requests/minute).