Complete reference for the MCC Explorer API
The MCC Explorer API provides programmatic access to merchant category codes and merchant mappings. Use it to categorize transactions, build financial tools, and enhance your fintech applications.
https://mccexplorer.com/api/v2.1# Option 1: x-api-key header
curl -H "x-api-key: mcc_your_api_key_here" ...
# Option 2: Authorization header
curl -H "Authorization: Bearer mcc_your_api_key_here" ...Get your API key from the API Dashboard.
| Feature | Free | Pro | Enterprise |
|---|---|---|---|
| MCC Codes List | |||
| Categories & Descriptions | |||
| MCC Details & Merchant Details | |||
| Merchant Mappings | |||
| Merchant Lookup | |||
| Vote Counts & Confidence Scores | |||
| Merchant Aliases | |||
| Monthly Requests | 500 | 50,000 | 500,000 |
| Rate Limit | 10/min | 100/min | 1,000/min |
/api/v2.1/mcc-codesfree| Name | Type | Required | Description |
|---|---|---|---|
| category | string | Optional | Filter by category name (partial match) |
| search | string | Optional | Search across code, description, and category |
| include | string | Optional | Set to 'merchants' to include merchant mappings (Pro+) |
| limit | number | Optional | Number of results (default: 50, max: 100) |
| offset | number | Optional | Pagination offset (default: 0) |
curl -X GET "https://mccexplorer.com/api/v2.1/mcc-codes?category=Retail&limit=10" \
-H "x-api-key: mcc_your_api_key_here"{
"data": [
{
"mcc_code": "5411",
"category": "Grocery Stores",
"description": "Grocery Stores, Supermarkets"
},
{
"mcc_code": "5412",
"category": "Grocery Stores",
"description": "Convenience Stores"
}
],
"meta": {
"total": 1038,
"limit": 10,
"offset": 0,
"has_more": true
}
}/api/v2.1/mcc-codes/:codefree| Name | Type | Required | Description |
|---|---|---|---|
| code | string | Required | The MCC code (e.g., '5411') |
| include | string | Optional | Set to 'merchants' to include merchant mappings (Pro+) |
curl -X GET "https://mccexplorer.com/api/v2.1/mcc-codes/5411?include=merchants" \
-H "x-api-key: mcc_your_api_key_here"{
"data": {
"mcc_code": "5411",
"category": "Grocery Stores",
"description": "Grocery Stores, Supermarkets",
"mcc_details": "Used for grocery and supermarket purchases...",
"merchant_count": 45,
"merchants": [
{
"name": "Walmart",
"is_primary": true,
"vote_count": 127,
"confidence_score": 0.95,
"aliases": ["WAL-MART", "WALMART.COM"]
},
{
"name": "Costco",
"is_primary": true,
"vote_count": 98,
"confidence_score": 0.92
}
]
}
}/api/v2.1/lookuppro| Name | Type | Required | Description |
|---|---|---|---|
| merchant | string | Required | Merchant name to search (min 2 characters) |
curl -X GET "https://mccexplorer.com/api/v2.1/lookup?merchant=amazon" \
-H "x-api-key: mcc_your_api_key_here"{
"data": {
"query": "amazon",
"match_count": 3,
"matches": [
{
"merchant": "Amazon",
"mcc_code": "5942",
"category": "Book Stores",
"description": "Book Stores",
"is_primary": true,
"confidence": 0.95,
"vote_count": 234,
"aliases": ["AMZN MKTP", "AMAZON.COM"]
},
{
"merchant": "Amazon Web Services",
"mcc_code": "7372",
"category": "Computer Programming",
"description": "Computer Programming, Data Processing",
"is_primary": true,
"confidence": 0.92
}
]
}
}| Status Code | Description |
|---|---|
200 | Success |
400 | Bad Request - Invalid parameters |
401 | Unauthorized - Invalid or missing API key |
403 | Forbidden - Feature not available in your tier |
404 | Not Found - Resource doesn't exist |
429 | Rate Limit Exceeded - Too many requests |
500 | Internal Server Error |
Create a free account and get your API key in seconds.