Transaction

transaction_category identifies the type of a transaction for both account and card transactions. The supported set of categories is consistent across all providers.

These are the supported set of transaction categories:

TypeDescription
ATMDeposit or withdrawal of funds using an ATM (Automated Teller Machine)
BILL_PAYMENTPayment of a bill
CASHCash deposited over the branch counter or using Cash and Deposit Machines
CASHBACKAn option retailers offer to withdraw cash while making a debit card purchase
CHEQUEA document ordering the payment of money from a bank account to another person or organisation
CORRECTIONCorrection of a transaction error
CREDITFunds added to your account
DIRECT_DEBITAn automatic withdrawal of funds initiated by a third party at regular intervals
DIVIDENDA payment to your account from shares you hold
FEE_CHARGEFees or charges in relation to a transaction
INTERESTCredit or debit associated with interest earned or incurred
OTHERMiscellaneous credit or debit
PURCHASEA payment made with your debit or credit card
STANDING_ORDERA payment instructed by the account-holder to a third party at regular intervals
TRANSFERTransfer of money between accounts
DEBITFunds taken out from your account, uncategorised by the bank
UNKNOWNNo classification of transaction category known

Transaction classification

transaction_classification returns detailed category information for account and card transactions.

This field, along with merchant_name, is currently supported for banks in UK, Ireland and France; we attempt to classify transactions from banks in unsupported countries with the classification system used for UK trasactions, but accuracy may be lower in this case.

Our classification system is built around purchase-related transactions; for this reason transactions with transaction_category equal to CREDIT are currently not supported.

It is possible that some transactions may not receive a category/subcategory classification. Additionally, the category/subcategory classification for a given transaction may change over time, as we improve our systems.

[
  {
    "classification_category": "Uncategorized",
    "sub_classification_categories": [
      "Cash & ATM",
      "Check"
    ]
  },
  {
    "classification_category": "Entertainment",
    "sub_classification_categories": [
      "Arts",
      "Music",
      "Dating",
      "Movies & DVDs",
      "Newspaper & Magazines",
      "Social Club",
      "Sport",
      "Games"
    ]
  },
  {
    "classification_category": "Education",
    "sub_classification_categories": [
      "Tuition",
      "Student Loan",
      "Books & Supplies"
    ]
  },
  {
    "classification_category": "Shopping",
    "sub_classification_categories": [
      "Pets",
      "Groceries",
      "General",
      "Clothing",
      "Home",
      "Books",
      "Electronics & Software",
      "Hobbies",
      "Sporting Goods"
    ]
  },
  {
    "classification_category": "Personal Care",
    "sub_classification_categories": [
      "Hair",
      "Laundry",
      "Beauty",
      "Spa & Massage"
    ]
  },
  {
    "classification_category": "Health & Fitness",
    "sub_classification_categories": [
      "Dentist",
      "Doctor",
      "Eye care",
      "Pharmacy",
      "Gym",
      "Pets",
      "Sports"
    ]
  },
  {
    "classification_category": "Food & Dining",
    "sub_classification_categories": [
      "Catering",
      "Coffee shops",
      "Delivery",
      "Fast Food",
      "Restaurants",
      "Bars"
    ]
  },
  {
    "classification_category": "Gifts & Donations",
    "sub_classification_categories": [
      "Gift",
      "Charity"
    ]
  },
  {
    "classification_category": "Investments",
    "sub_classification_categories": [
      "Equities",
      "Bonds",
      "Bank products",
      "Retirement",
      "Annuities",
      "Real-estate"
    ]
  },
  {
    "classification_category": "Bills and Utilities",
    "sub_classification_categories": [
      "Television",
      "Home Phone",
      "Internet",
      "Mobile Phone",
      "Utilities"
    ]
  },
  {
    "classification_category": "Auto & Transport",
    "sub_classification_categories": [
      "Auto Insurance",
      "Auto Payment",
      "Parking",
      "Public transport",
      "Service & Auto Parts",
      "Taxi",
      "Gas & Fuel"
    ]
  },
  {
    "classification_category": "Travel",
    "sub_classification_categories": [
      "Air Travel",
      "Hotel",
      "Rental Car & Taxi",
      "Vacation"
    ]
  },
  {
    "classification_category": "Fees & Charges",
    "sub_classification_categories": [
      "Service Fee",
      "Late Fee",
      "Finance Charge",
      "ATM Fee",
      "Bank Fee",
      "Commissions"
    ]
  },
  {
    "classification_category": "Business Services",
    "sub_classification_categories": [
      "Advertising",
      "Financial Services",
      "Office Supplies",
      "Printing",
      "Shipping",
      "Legal"
    ]
  },
  {
    "classification_category": "Personal Services",
    "sub_classification_categories": [
      "Advisory and Consulting",
      "Financial Services",
      "Lawyer",
      "Repairs & Maintenance"
    ]
  },
  {
    "classification_category": "Taxes",
    "sub_classification_categories": [
      "Federal Tax",
      "State Tax",
      "Local Tax",
      "Sales Tax",
      "Property Tax"
    ]
  },
  {
    "classification_category": "Gambling",
    "sub_classification_categories": [
      "Betting",
      "Lottery",
      "Casino"
    ]
  },
  {
    "classification_category": "Home",
    "sub_classification_categories": [
      "Rent",
      "Mortgage",
      "Secured loans",
      "Pension and insurances",
      "Pension payments",
      "Life insurance",
      "Buildings and contents insurance",
      "Health insurance"
    ]
  }
]
CategorySubcategory
UncategorizedCash & ATM
Check
EntertainmentArts
Music
Dating
Movies & DVDs
Newspaper & Magazines
Social Club
Sport
Games
EducationTuition
Student Loan
Books & Supplies
ShoppingPets
Groceries
General
Clothing
Home
Books
Electronics & Software
Hobbies
Sporting Goods
Personal CareHair
Laundry
Beauty
Spa & Massage
Health & FitnessDentist
Doctor
Eye care
Pharmacy
Gym
Pets
Sports
Food & DiningCatering
Coffee shops
Delivery
Fast Food
Restaurants
Bars
Gifts & DonationsGift
Charity
InvestmentsEquities
Bonds
Bank products
Retirement
Annuities
Real-estate
Bills & UtilitiesTelevision
Home Phone
Internet
Mobile Phone
Utilities
Auto & TransportAuto Insurance
Auto Payment
Parking
Public transport
Service & Auto Parts
Taxi
Gas & Fuel
TravelAir Travel
Hotel
Rental Car & Taxi
Vacation
Fees & ChargesService Fee
Late Fee
Finance Charge
ATM Fee
Bank Fee
Commissions
Business ServicesAdvertising
Financial Services
Office Supplies
Printing
Shipping
Legal
Personal ServicesAdvisory and Consulting
Financial Services
Lawyer
Repairs & Maintenance
TaxesFederal Tax
State Tax
Local Tax
Sales Tax
Property Tax
GamblingBetting
Lottery
Casino
HomeRent
Mortgage
Secured loans
Pension and insurancesPension payments
Life insurance
Buildings and contents insurance
Health insurance

Did this page help you?