Skip to main content

Business Categories

MX defines roughly 180 business categories, which are, of course, geared toward the requirements of businesses rather than personal finances. This list is separate from the standard personal categories. Business category GUIDs begin with an FCT prefix rather than the standard CAT prefix.

Business Category Fields

FieldData TypeDefinition
guidStringThe unique identifier for the category. Defined by MX.
is_defaultBooleanThis indicates whether the category is a default, MX-created category. This will always be false for custom categories.
nameStringThe name of the category.
parent_guidStringThe unique identifier for the parent category. Defined by MX.

List All Business Categories

Use this endpoint to retrieve a list of all business categories and subcategories.

Endpoint: GET /users/{user_guid}/categories/business

Request
Response
Language:shell

_10
curl -i GET 'https://int-api.mx.com/users/USR-fa7537f3-48aa-a683-a02a-b18940482f54/categories/business' \
_10
-u 'client_id:api_key' \
_10
-H 'Accept: application/vnd.mx.api.v1+json'

Read a Category

Use this endpoint to read the attributes of either a default category or a custom category. This included both standard personal categories and business categories.

caution

Attempting to read a business category when the business suite has not been enabled will result in a 403 Forbidden error with the message Client does not have access to business suite features.

Endpoint: GET /users/{user_guid}/categories/{category_guid}

Request
Response
Language:shell

_10
curl -i 'https://int-api.mx.com/users/USR-11141024-90b3-1bce-cac9-c06ced52ab4c/categories/FCT-14d28538-489a-441f-b13a-91659a93b96e' \
_10
-u 'client_id:api_key' \
_10
-H 'Accept: application/vnd.mx.api.v1+json'