List Merchant Categories

This endpoint returns all supported merchant banking categories as a reference enumeration. Each entry includes a numeric identifier, a human-readable name, a description, and a group classification. Use this list to map transaction or card-control categories throughout your integration.

Endpoint

GET /api/enums/bankingCategory

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

Call this endpoint when you need to display or select merchant categories in your application — for example, when configuring card spending controls by category, filtering transaction history, or populating a category picker in a partner UI. The returned values are stable enumerations that can be cached and refreshed periodically.

Response

200 OK

Returns an array of category objects.

[
  {
    "name": "GROCERIES",
    "id": 1,
    "description": "Grocery stores and supermarkets",
    "groupName": "Food & Dining",
    "endpoints": [
      "/api/cards/spendingControls",
      "/api/transactions/filter"
    ]
  },
  {
    "name": "TRAVEL",
    "id": 2,
    "description": "Airlines, hotels, and travel agencies",
    "groupName": "Travel",
    "endpoints": [
      "/api/cards/spendingControls",
      "/api/transactions/filter"
    ]
  },
  {
    "name": "ENTERTAINMENT",
    "id": 3,
    "description": "Entertainment venues, streaming services, and events",
    "groupName": "Entertainment",
    "endpoints": [
      "/api/cards/spendingControls",
      "/api/transactions/filter"
    ]
  }
]

Error Codes

Common Mistakes

• Hardcoding category IDs without verifying against this endpoint — IDs are stable but should be confirmed during integration setup rather than assumed.
• Not refreshing the cached list periodically — new categories may be added over time; refresh at application startup or on a daily schedule.

Related Endpoints

• GET /api/enums/transactionType — Returns the list of supported transaction type enumerations
• GET /api/enums/cardStatus — Returns the list of supported card status enumerations
• PUT /api/cards/{cardId}/spendingControls — Apply category-based spending controls to a card using category IDs from this endpoint

Example

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