Reference

Merchant category code (MCC) lookup API

Resolve an ISO 18245 4-digit merchant category code to its official description plus a high-level group (Retail, Restaurants, Travel, Financial, etc.) so payment agents can classify transactions. Answers 'what is MCC 5411', 'category for grocery stores', 'group for 4111', 'describe merchant code 5812'.

Price$0.01per request

MethodPOST

Route/v1/ref/mcc

StatusLive

MIME typeapplication/json

Rate limit60/minute

CacheNo cache

refmccmerchant-category-codeiso-18245paymentscardcategorymerchant

API URLhttps://x402.hexl.dev/v1/ref/mcc

Integration docs

Example request

{
  "code": "5411"
}

Example response

{
  "code": "5411",
  "description": "Grocery Stores and Supermarkets",
  "group": "Retail",
  "found": true
}

Input schema

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "examples": [
        "5411",
        "5812"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}