List Merchant Categories

The merchant category endpoint returns all available merchant categories used across the Netevia Banking platform. Each category is associated with a Merchant Category Code (MCC), the industry-standard system for classifying businesses by the type of goods or services they provide. This list is intended for use in front-end applications for dropdowns, filters, search, and reporting.

Endpoint

GET /api/enums/merchantCategory

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when building front-end interfaces that require users to select or filter by merchant category, such as transaction filters, spend controls, or reporting dashboards. It is also useful when configuring card-level merchant restrictions or when populating category selection dropdowns during account or card setup. This endpoint returns a static reference list and can be cached on the client side to reduce API calls.

Response

200 OK

Returns an array of merchant category objects.

[
  {
    "name": "AIRLINES",
    "id": 3000,
    "description": "Airlines and Air Carriers",
    "groupName": "Travel",
    "endpoints": [
      "/api/cards/spendControls",
      "/api/transactions/filter"
    ]
  },
  {
    "name": "GROCERY_STORES",
    "id": 5411,
    "description": "Grocery Stores and Supermarkets",
    "groupName": "Retail",
    "endpoints": [
      "/api/cards/spendControls",
      "/api/transactions/filter"
    ]
  },
  {
    "name": "GAS_STATIONS",
    "id": 5541,
    "description": "Service Stations (with or without Ancillary Services)",
    "groupName": "Automotive",
    "endpoints": [
      "/api/cards/spendControls",
      "/api/transactions/filter"
    ]
  }
]

Error Codes

Common Mistakes

• This endpoint returns a reference list that changes infrequently; avoid calling it on every page load — cache the response on the client side instead.
• The id field corresponds to the industry MCC value; do not confuse it with an internal Netevia record ID.
• The endpoints array indicates where a given merchant category enum value is accepted; verify the relevant endpoint before submitting a category value in a request body.

Related Endpoints

• GET /api/enums/transactionType — Returns a list of supported transaction type enumerations
• GET /api/enums/cardStatus — Returns valid card status values used across card management endpoints

Example

curl -X GET https://api.banking.netevia.dev/api/enums/merchantCategory \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"