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
| Parameter | Type | In | Required | Description |
|---|---|---|---|---|
code | string | Query (GET) | No* | Single 4-digit code (e.g. 5812) or comma-separated list (e.g. 5812,5411). |
category | string | Query (GET) | No* | Taxonomy category slug (e.g. dining, supermarkets, travel_general, gas_and_ev). |
code | string or array | Body (POST) | No* | 4-digit code or array of codes (e.g. ["5812", "5411"]). |
category | string | Body (POST) | No* | Category slug filter. |
* At least one filter (code or category) must be provided.
Request Headers
| Header | Value | Description |
|---|---|---|
Accept | application/json | Expected response content type. |
Content-Type | application/json | Required 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
| Field | Type | Description |
|---|---|---|
status | string | Request status ("success" or "error"). |
count | integer | Number of MCC records returned. |
data | object or array | Single MCC record (when single code queried) or array of records. |
data.code | string | 4-digit ISO 18245 merchant category code. |
data.title | string | Canonical industry description. |
data.reward_category | string | High-level reward category (dining, supermarkets, travel, etc.). |
data.is_cash_advance | boolean | Whether transactions under this MCC are classified as cash advances. |
data.documentation_url | string | Canonical documentation page on AxeTip. |
data.optimal_card | object | The highest-earning credit card for this merchant category. |
data.optimal_card.id | string | Card slug. |
data.optimal_card.name | string | Card product name. |
data.optimal_card.annual_fee | MoneyAmount | Annual fee value object. |
data.optimal_card.reward_yield | RewardYield | Reward 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 Code | Description |
|---|---|
200 OK | Request succeeded. Matching MCC records returned. |
400 Bad Request | Missing required search filter (code or category). |
404 Not Found | Specified MCC code does not exist. |
429 Too Many Requests | Rate limit exceeded (60 requests/minute). |