GET
/api/v1/mcc-codesfreeList MCC Codes
Retrieve a paginated list of all MCC codes with optional filtering.
Parameters
| 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 up to 10 merchants per code (Starter+; max 10 codes per page, 1 request per merchant returned) |
| limit | number | Optional | Number of results (default: 50, max: 100; 10 with merchants) |
| offset | number | Optional | Pagination offset (default: 0) |
Example Request
Request
curl -X GET "https://www.mccexplorer.com/api/v1/mcc-codes?category=Retail&limit=10" \
-H "x-api-key: mcc_your_api_key_here"Example Response
Response
{
"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
}
}