Categories are automatically assigned to a given transaction by the MX system. There are more than a hundred default MX categories and subcategories. The endpoints that follow allow you to list and read those default categories with their attributes.


Delete Category

Endpoint: DELETE /users/:user_guid/categories/:category_guid

This endpoint is used to delete a specific custom category according to its unique GUID. The API will respond with an empty object and a status of 204 No Content.

Parameters

For the Request

Example Request

curl -X DELETE /users/:user_guid/categories/:category_guid \\
  -H 'Content-Type: application/json' \\
	-H "Authorization: Bearer {access_token}" \\

Read Category

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

This endpoint returns a list of account numbers associated with the specified account.

Parameters

For the Request

Example Request

curl -X GET /users/:user_guid/categories/:category_guid \\
  -H 'Content-Type: application/json' \\
	-H "Authorization: Bearer {access_token}" \\

Response

{
  "category": {
    "created_at": null,
    "guid": "CAT-7829f71c-2e8c-afa5-2f55-fa3634b89874",
    "is_default": true,
    "is_income": false,
    "metadata": null,
    "name": "Auto & Transport",
    "parent_guid": null,
    "updated_at": null
  }
}

Update a Custom Category