> For the complete documentation index, see [llms.txt](https://docs.powens.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powens.com/api-reference/products/data-aggregation/categorization.md). # Categorization {% hint style="warning" %} This feature is not activated by default on your domain. Please contact us to request access. {% endhint %} Upon activation, the property `categories` is available in the [Bank transactions](/api-reference/products/data-aggregation/bank-transactions.md) or in the [`ACCOUNT_CATEGORIZED`](/api-reference/products/data-aggregation/bank-accounts.md#account-categorized) webhook. ## List bank transactions categories `GET` `https://{domain}.biapi.pro/2.0/users/{userId}/transactions?expand=categories` List bank transactions with their associated categories of the Authenticated User. By default, only active (non-deleted) transactions are returned; use the `all` parameter to retrieve the complete list. ## Categories {% tabs %} {% tab title="French categories 🇫🇷 " %}

Parent category	Children category	Description
administration_and_taxes		Administrative expenses.
	legal_advice	Expenses on lawyers and expert legal advice.
	others_administration_and_taxes	Administration and taxes expenses which cannot be allocated to its child category.
	social_contributions	Social charges contribute to financing the French social security system, including healthcare coverage, retirement benefits, and social welfare programs.
	taxes	Tax expenses including income tax, real property tax, personal property tax, and taxes on assets etc.
bank_insurances		Insurance transactions and bank fees.
	banking_fees	Bank fees including monthly maintenance/service fee, out-of-network ATM fees, overdraft fees and wire transfer fees etc.
	insurance_repayments	Insurance proceeds.
	account_card_maintenance	Recurring charges related to the administration and servicing of bnak accounts and payment cards
	insurances	Insurance premium.
	others_bank_insurances	Bank / insurances expenses which cannot be allocated to its child category.
	retirement_insurance	Insurance for retirement.
	savings	Transactions for savings or transferd to savings account.
	unauthorized_debit_fees	Unauthorized debit card charges.
	irregularity_and_incident_fees	Charges applied when irregularities occur on the account, such as insufficient funds, unauthorized overdrafts, or failed transactions due to account issues.
	intervention_fees	Fees related to discretionary actions taken by the bank on the customer’s behalf, often to prevent further issues.
	foreign_exchange_fees	Charges incurred for currency conversion when making international transactions or payments in foreign currencies.
	withdrawal	Cash withdrawals made from ATMs or at bank counters; not a fee, but an operational transaction that may be useful for analyzing spending behavior.
	rejection_fees	Fees associated with the rejection of various transactions, including transfers, cheques, or standing orders or direct debit return fee.
	third_party_administrative_seizure	Deductions made under legal or administrative orders from external entities (e.g., tax authorities), typically due to unpaid debts or obligations.
	deposit	A credit transaction where funds are added to a bank account, as opposed to a withdrawal.
	savings_investments_and_crypto_assets	Transactions related to savings accounts, investment portfolios, and crypto asset purchases or sales.
food_and_restaurants		Expenses for food, drink and restaurants.
	baker	Expenses at bakery.
	bars_restaurants	Expenses for bar, restaurant or coffee shop.
	butcher_fishmongers_produce	Expenses for butchers, fishmongers and related food preparers.
	others_food_and_restaurants	Food and restaurants expenses which cannot be allocated to its child category.
	supermarket_and_groceries	Expense at supermarkets and groceries.
	vending	Purchases made at vending machines for snacks, beverages, or other goods.
household		House maintenance and repairs and child raises expenses.
	home_services_cleaning	Home maintenance expenses.
	kitchen_and_appliances	Kitchen equipment and home appliances expenses.
	others_household	Household expense which cannot be allocated to its child category.
	works_diy_gardening	Landscaping expenses like gardener, lawn care, lawn mowing.
	child_care_kindergarten	Childminder, nursery, and babysitting expenses.
	furniture_and_decoration	Interior decorating expenses like artwork, furniture etc.
	alimony_payment	Expense the noncustodial parent pays to the custodial parent, to help cover the child's basic needs.
	education_and_training	Expenses related to education, training courses, tuition fees, and professional development.
	pet_care	Expenses related to pets including veterinary care, pet food, grooming, and accessories.
	post_and_courier	Expenses for postal services, parcel delivery, and courier shipments.
healthcare		Medical expenses.
	doctors_specialist_dentists_hospitals	Expenses in hospital and specialist including dental, optical or physio treatment etc.
	health_insurance_fees	Health insurance cost.
	health_insurance_reimbursement	Reimbursement of medical costs.
	others_healthcare	Healthcare expenses which cannot be allocated to its child category.
	pharmacy	Pharmaceutical spending.
housing		Monthly expenses associated with home.
	energy	Expense of electricity and gaz.
	others_housing	Housing expenses which cannot be allocated to a its child category.
	rent	Base rent expense and recurring charges of additional rent.
	water	Expense of water.
leisure		Leisurely activities expenses.
	cinema_theater_culture	Expenses on cultural activities for concerts, exhibitions and theatres.
	hotels	Hotel and Airbnb expenses.
	others_leisure	Leisure expenses which cannot be allocated to its child category.
	sports	Expenses related to sports including membership to sports clubs, sport lessons and shopping in sporting goods retailer.
	tobacco_gambling	Expenses on tobacco and gambling including sports betting, casinos, lotteries, gaming and scratch cards.
	charity_ngo_unions_associations	Donations and contributions to charities, non-governmental organizations, unions, and associations.
loans		Disposal and payment of loans.
	consumer_loans_disposal	Disposal of consumer loans which refers to transactions other than real estate.
	mortgage_disposal	Disposal of mortgage loans.
	others_loans	Loans expense which cannot be allocated to its child category.
	consumer_loans_payment	Loan that is typically used for personal expense, such as buying a car or consolidating credit card debt.
	mortgage_payment	Loan that is used to purchase a home.
media_and_telecommunications		Media expenses.
	media_subscriptions	Expense on subscriptions to media like music streaming services.
	others_media_and_telecommunications	Media and telecommnunications expense which cannot be allocated to a its child category.
	phone_internet_tv	Phone, Internet, TV expenses.
others		All expense and income which cannot be allocated to explicit parent category.
	return_debit	Unsuccessful / refused payment.
	transfers	Bank transfers.
	online_transfers_and_payment_services	Transfers and payments made through online platforms and third-party payment services such as PayPal or Wise.
	others	All expense and income which cannot be allocated to explicit parent category.
revenue		Income received.
	others_revenue	Revenue incomes which cannot be allocated to its child category.
	pensions	Regular payment made by the state to retired people.
	rental_income	Amount of rent that a landlord receives from their tenants.
	salary	Paid for work or services.
	alimony	Payment the custodial parent receives from the non custodial parent, to help cover the child's basic needs.
	family_benefits	Family allowances such as Paje.
	unemployment_benefits	Unemployment benefit paid by a French governmental agency such as Pôle emploi.
	other_benefits	Other benefits like scholarship benefit or disability benefits etc.
	housing_benefits	Housing benefits such as CAF benefits.
	financial_income (Deprecated)	Distribution of profits to shareholders, or income earned on loaned money or investments.
	savings_disposal (Deprecated)	Transactions for savings, or received in savings account.
shopping		Online shopping and in-store shopping expenses.
	beauty_hairdressing_aesthetic	Expenses in beauty salons, hair salons and on aesthetic services and products.
	clothing_and_accessories	Clothes and accessories expenses like gloves, bracelets, watches etc.
	ecommerce	Online shopping expenses.
	multimedia_books_stationery	Expenses on books, stationery and multimedia products including e-learning courses, video games etc.
	others_shopping	Shopping expenses which cannot be allocated to its child category.
travel_and_transport		Travel expenses including airfare and transportation services.
	fuel_and_vehicle_charging	Fuel and oil expense which refers to gasoline, oil, and lubricants used in operating.
	others_travel_and_transport	Travel and transport expenses which cannot be allocated to its child category.
	parking_maintenance_tolls	Expenses for tolls, parking, mainetenance.
	plane_or_boat_travel	Expense for travel by airplane or boat.
	public_transportation	Expenses for public transportation including trams, buses, and coaches.
	rental_and_taxis	Expense for rental cars, taxis, private car services.
	train_travel	Expense for travel by train.

{% endtab %} {% tab title="Spanish categories 🇪🇸" %}

Parent category	Children category
social_security_benefits
	unemployement_benefit
	invalidity_benefit
	other_social_security_benefits
loans
	general_loans
	fast_loans
	consumer_loans
	credit_card_payment_and_transfers
	credit_line
	car_leasing
	mortgage
gambling
	sports_betting
	lottery
	casino
personal_transfers
	from_own_account
	to_own_account
	other_personal_transfers
other_incoming_movements
	other_transfers
	online_money_transfer
	online_payments
	transfer_from_payment_card
	unknown
food_and_supplies
	cafes_restaurants_bars
	groceries_and_supermarkets
	tobacco_and_alcohol
	other_supplies
utility_services
	rent_and_maintenance
	water
	natural_gas
	electricity
	telephone_internet_tv_computer
	security
leisure_activities_and_hobbies
	accommodation_travel_expenses
	books_newspapers_magazines_stationery
	pets
	sport_and_sports_goods
	theatre_music_cinema
	hobbies_and_other_leisure_activities
	gifts_and_florist
	charity
	shopping_mall_and_department_stores
transportation
	transportation_expenses
	fuel
	parking_and_tolls
	vehicle_maintenance_and_rental
education_health_and_beauty
	education_and_courses
	health_and_pharmaceuticals
	beauty_cosmetics
savings_and_investments
	savings
	investments
insurance
	life_insurance
	non_life_insurance
	other_insurance_expenses
online_transactions
	online_retail_purchases
	online_services
other_outgoing_movements
	other_transfers
	other_payments
	online_money_transfer
	online_payments
	transfer_to_payment_card
	unknown
salary
pension
cash_deposit
cheque_deposit
income_from_rent
alimony_and_child_support
savings
dividends_received
interest_received
invoices_and_business
tax_return
financial_services_and_commissions
return_debit
returned_payments
insurance_indemnity
bailiffs_and_debt_collection
unions_and_associations
postal_services
cash_withdrawal
cheque_withdrawal
clothing_shoes_and_complements
children
household_goods
taxes_and_government_fees

{% endtab %} {% tab title="European categories 🇪🇺" %}

Parent category	Children category	Description
employment _wages
	salary	Wage paid for work or services.
	other_employment_wages	Other employment income.
government_support
	unemployment_benefits	Unemployment benefit paid by a governmental agency.
	social_security	Social Security income and social contributions.
	pension	Regular payment made by the state to retired people.
	other_government_support	Government benefits income that cannot be allocated to any child category.
housing_and_utilities
	rent	Base rent expenses and recurring charges of additional rent.
	security_services	Expenses in security services.
	home_maintenance	Home maintenance services and cleaning.
	energy	Energy service expenses like electricity and gas.
	water	Expenses in water.
	internet_mobile_tv	PPV, mobile companies and Internet providers.
	pets	Pet shops and Vets.
	other_housing_and_utilities	Housing and utilities expenses and income that cannot be allocated to any child category.
groceries_and_stores
	supermarkets_and_groceries	Supermarkets and groceries, including big chains and small shops.
	organic_and_specialty_food	Fishmongers, fruit, candy stores, etc.
	bakery	Expenses in bakeries.
	tobacco_stores	Expenses in tobacco stores and machines.
	other_groceries_and_stores	Groceries and stores expenses, like vending machines.
dining_out_and_food
	restaurant_bar_coffee	Bars, restaurants or coffee shops.
	food_delivery	Food delivery services.
	other_dining_out_and_food	Food expenses which cannot be allocated to any child category.
vehicle_expenses
	fuel_and_gas	Fuel and oil expense which refers to gasoline, oil and lubricants used in operating, and electric car charging expenses.
	vehicle_maintenance_and_repairs	Expenses in vehicle maintenance and repair costs.
	parking_and_tolls	Expenses in parking and tolls.
	other_vehicle_expenses	Vehicle expenses which cannot be allocated to any child category.
transports
	local_transportation	Local transportation expenses for short distance or metropolitan area mobility: bus, metro, taxi, Uber, Cabify, Cooltra, etc.
	plane_train_boat_travel	Long distance transportation expenses: train, flights, boat travel, etc.
	car_rental	Rental car services.
	other_transports	Transport expenses which cannot be allocated to any child category.
travel_and_accommodation_expenses
	hotels_and_accommodation	Hotels, hostels and accommodation services.
	other_travel_and_accommodation_expenses	Travel expenses which cannot be allocated to any child category.
medical_expenses
	doctors_and_hospitals	Expenses in doctors, hospitals, dentist, vision care, dermathology, etc.
	other_medical_expenses	Medical expenses which cannot be allocated to any child category.
health_and_wellness
	pharmacy	Pharmaceutical spending.
	beauty_and_cosmetics	Expenses in beauty salons, cosmetics, hairdressing and aesthetic services and products.
	fitness_gym_spa_wellness	Membership to sport clubs and lessons, and expenses in SPA and wellness.
	other_health_and_wellness	Health and wellness expenses which cannot be allocated to any child category.
clothing_and_accessories
	clothing_and_shoes	Clothing and shoes expenses.
	jewelry_and_accessories	Expenses in jewelry and accessories like gloves, bracelets, watches, etc.
	other_clothing_and_accessories	Clothing and accessories expenses which cannot be allocated to any child category.
digital_entertainment_and_technology
	tech_accessories_and_electronics	Expenses in gadgets, computer hardware, TVs, etc.
	gaming_software_apps	Expenses in gaming, software, app purchases, etc.
	media_subscriptions	Streaming and other subscriptions like online press.
	other_digital_entertainment_technology	Digital entertainment and technology expenses which cannot be allocated to any child category.
general_shopping
	department_stores	Expenses in department stores.
	online_shopping	Online shopping and retail.
	homegoods_and_gardening	Furniture, kitchen equipment, bazars and landscaping expenses like garden equipment or gardener.
	books_media_stationery	Book stores, kiosks, stationery and multimedia products.
	gifts_and_florists	Gifts and florists expenses and income.
	sports_goods	Expenses in sporting goods retailer.
	other_general_shopping	General shopping which cannot be allocated to any child category.
activities_and_events
	theatre_cinema_and_culture	Cultural activities as theatre, cinema, concerts, museums, etc.
	sport_events	Sporting events ticket purchases.
	hobbies_and_recreation_activities	Expenses in hobbies, and recreation activities as sport practices, theme parks, clubbing, etc.
	other_activities_and_events	Activities and events which cannot be allocated to any child category.
taxes
	government_fees_and_taxes	Tax expenses including income tax, real property tax, personal property tax, taxes on assets, etc.
	fines_and_penalties	Bailiff and debt collectors.
	other_taxes	Taxes expenses and income which cannot be allocated to any child category.
loans_and_credit
	general_loans	Disposal and payment of general loans (long-term recurrent payments).
	fast_loans	Disposal and payment of fast loans (1 or 2 payments).
	leasing_and_renting	Payment of car leasing and renting.
	mortgage	Disposal and payment of mortgage loans.
	other_loans_and_credit	Loans disposal and payment which cannot be allocated to any child category.
insurance
	life_insurance	Life insurance expenses.
	medical_insurance	Medical insurance expenses.
	general_insurance	Insurance providers that offer a wide range of insurances.
	other_insurance	Insurance indemnity and other insurance expenses, like car insurance, home insurance, retirement insurance, etc.
education
	tuition	Expenses in child care, Kindergarten, School, College, University, etc.
	online_courses_training_certifications	Expenses in Masters, Bootcamps, online courses, certifications, etc.
	other_education	Education expenses which cannot be allocated to any child category.
professional
	professional_services	Miscellaneous invoices, bills and professional services.
	postal_services	Expenses in postal services.
	other_professional	Professional expenses and income which cannot be allocated to any child category.
transfers
	p2p_payments	Payments made with P2P platforms which cannot be allocated to any child category.
	refund	Refund money, returned payments, reimbursements.
	online_money_transfers	Transfers made with external services to the bank.
	wire_transfers	Transfers made bank to bank.
	other_transfers	Transfers that cannot be allocated to any child category.
savings_and_investments
	savings_deposits_and_investments	Saving deposits, dividends, interests, capital gains, etc.
	other_savings_and_investments	Savings or investments deposits and income which cannot be allocated to any child category.
support
	charity_religious contributions_ngo	Donations and contributions made to NGOs and religious institutions.
	alimony_and_child support	Expense the noncustodial parent pays to the custodial parent, to help cover the child's basic needs.
	unions_and_associations	Membership of a sport club or an association.
	other_support	Support expenses and income which cannot be allocated to any child category.
gambling
	sports_betting_and_casino	Expenses and income from sports betting and casino games.
	lottery	Expenses and income from lottery.
	other_gambling	Gambling expenses and income which cannot be allocated to any child category.
bank_and_fees
	deposit	Deposit movements by cash or cheque without concept or uncategorizable.
	withdrawal	Cash withdrawals made from ATMs or at bank counters.
	banking fees	Bank fees including monthly maintenance/service fee, out-of-network ATM fees, overdraft fees and wire transfer fees, etc.
	account_and_card_maintenance	Recurring charges related to the administration and servicing of bank accounts and payment cards.
	irregularity_and_incident_fees	Charges applied when irregularities occur on the account, such as insufficient funds, unauthorized overdrafts, or failed transactions due to account issues.
	intervention_fees	Fees related to discretionary actions taken by the bank on the customer’s behalf, often to prevent further issues.
	foreign_exchange_fees	Charges incurred for currency conversion when making international transactions or payments in foreign currencies.
	rejection_fees	Fees associated with the rejection of various transactions, including transfers, cheques, or standing orders or direct debit return fee.
	third_party_administrative_seizure	Deductions made under legal or administrative orders from external entities (e.g., tax authorities), typically due to unpaid debts or obligations.
	other_bank_and_fees	Other bank transactions which cannot be allocated to any child category.
misc
	other	Transactions that are known but do not fit into a defined category.
	unknown	The reason for the transaction cannot be determined.

{% endtab %} {% endtabs %}