> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Categories Overview

> A transaction can have its category set to one of MX's default categories or a custom category for a specific user.

See [Default Categories and Subcategories](/api-reference/platform-api/reference/categories#default-categories-and-subcategories) for a complete list.

Use these endpoints to:

* Retrieve those categories and their attributes.
* Create and update custom categories for a specific `user`.
* Delete a custom category for a specific `user`.

## Default Categories and Subcategories

<AccordionGroup>
  <Accordion title="Auto & Transport">
    * Auto Insurance
    * Auto Payment
    * Gas & Fuel
    * Parking
    * Public Transportation
    * Ride Sharing
    * Service & Parts
  </Accordion>

  <Accordion title="Bills & Utilities">
    * Gas & Electric
    * Internet
    * Mobile Phone
    * Phone
    * Television
    * Trash
    * Water
  </Accordion>

  <Accordion title="Business Services">
    * Advertising
    * Legal
    * Office Supplies
    * Printing
    * Shipping
  </Accordion>

  <Accordion title="Education">
    * Books & Supplies
    * Student Loan
    * Tuition
  </Accordion>

  <Accordion title="Entertainment">
    * Arts
    * Movies & DVDs
    * Music
    * Newspapers & Magazines
    * Sports
  </Accordion>

  <Accordion title="Fees & Charges">
    * ATM Fee
    * Bank Fee
    * Finance Charge
    * Late Fee
    * Overdraft
    * Service Fee
    * Trade Commissions
  </Accordion>

  <Accordion title="Financial">
    * Financial Advisor
    * Life Insurance
    * Investment
  </Accordion>

  <Accordion title="Food & Dining">
    * Alcohol & Bars
    * Coffee Shops
    * Fast Food
    * Groceries
    * Restaurants
  </Accordion>

  <Accordion title="Gifts & Donations">
    * Charity
    * Gift
  </Accordion>

  <Accordion title="Health & Fitness">
    * Dentist
    * Doctor
    * Eye Care
    * Gym
    * Health Insurance
    * Pharmacy
    * Sports
  </Accordion>

  <Accordion title="Home">
    * Furnishings
    * Home Improvement
    * Home Insurance
    * Home Services
    * Home Supplies
    * Lawn & Garden
    * Mortgage & Rent
  </Accordion>

  <Accordion title="Income">
    * Bonus
    * Interest Income
    * Paycheck
    * Reimbursement
    * Rental Income
  </Accordion>

  <Accordion title="Investments">
    * Buy
    * Deposit
    * Dividend & Cap Gains
    * Sell
    * Withdrawal
  </Accordion>

  <Accordion title="Kids">
    * Baby Supplies
    * Babysitter & Daycare
    * Child Support
    * Kids Activities
    * Toys
  </Accordion>

  <Accordion title="Personal Care">
    * Hair
    * Laundry
    * Spa & Massage
  </Accordion>

  <Accordion title="Pets">
    * Pet Food & Supplies
    * Pet Grooming
    * Veterinary
  </Accordion>

  <Accordion title="Shopping">
    * Books
    * Clothing
    * Electronics & Software
    * Hobbies
    * Sporting Goods
  </Accordion>

  <Accordion title="Taxes">
    * Federal Tax
    * Local Tax
    * Property Tax
    * Sales Tax
    * State Tax
  </Accordion>

  <Accordion title="Transfer">
    * Credit Card Payment
    * Transfer
  </Accordion>

  <Accordion title="Travel">
    * Air Travel
    * Hotel
    * Rental Car & Taxi
    * Vacation
  </Accordion>

  <Accordion title="Uncategorized" />
</AccordionGroup>

## Category Fields

| Field         | Data Type | Description                                                                                                               |
| :------------ | :-------- | :------------------------------------------------------------------------------------------------------------------------ |
| `created_at`  | String    | The date and time the category was created. This field will always be `null` when `is_default` is true.                   |
| `guid`        | String    | The unique identifier for the category. Defined by MX.                                                                    |
| `is_default`  | Boolean   | This indicates whether the category is an MX-created default category. This will always be `false` for custom categories. |
| `is_income`   | Boolean   | This indicates whether the category represents income. This will always be `false` for custom categories.                 |
| `metadata`    | String    | This is additional information a partner can store on the custom category.                                                |
| `name`        | String    | The name of the custom category.                                                                                          |
| `parent_guid` | String    | The unique identifier for the parent category. Defined by MX.                                                             |
| `updated_at`  | String    | The date and time the category was last updated. This field will always be `null` when `is_default` is true.              |