# Categorization

{% hint style="warning" %}
This feature is not activated by default on your domain. Please contact us to request access.&#x20;
{% endhint %}

Upon activation, the property `categories` is available in the [bank-transactions](https://docs.powens.com/api-reference/products/data-aggregation/bank-transactions "mention") or in the  [`ACCOUNT_CATEGORIZED`](https://docs.powens.com/api-reference/products/bank-accounts#account-categorized) webhook.&#x20;

## List bank transactions categories&#x20;

<mark style="color:blue;">`GET`</mark> `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 🇫🇷  " %}

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

{% endtab %}

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

<table><thead><tr><th>Parent category</th><th width="257">Children category</th></tr></thead><tbody><tr><td>social_security_benefits</td><td></td></tr><tr><td></td><td>unemployement_benefit</td></tr><tr><td></td><td>invalidity_benefit</td></tr><tr><td></td><td>other_social_security_benefits</td></tr><tr><td>loans</td><td></td></tr><tr><td></td><td>general_loans</td></tr><tr><td></td><td>fast_loans</td></tr><tr><td></td><td>consumer_loans</td></tr><tr><td></td><td>credit_card_payment_&#x26;_transfers</td></tr><tr><td></td><td>credit_line</td></tr><tr><td></td><td>car_leasing</td></tr><tr><td></td><td>mortgage</td></tr><tr><td>gambling</td><td></td></tr><tr><td></td><td>sports_betting</td></tr><tr><td></td><td>lottery</td></tr><tr><td></td><td>casino</td></tr><tr><td>personal_transfers</td><td></td></tr><tr><td></td><td>from_own_account</td></tr><tr><td></td><td>other_personal_transfers</td></tr><tr><td>other_incoming_movements</td><td></td></tr><tr><td></td><td>other_transfers</td></tr><tr><td></td><td>online_money_transfer</td></tr><tr><td></td><td>online_payments</td></tr><tr><td></td><td>transfer_from_payment_card</td></tr><tr><td></td><td>unknown</td></tr><tr><td>food_&#x26;_supplies</td><td></td></tr><tr><td></td><td>cafes_restaurants_bars</td></tr><tr><td></td><td>groceries_&#x26;_supermarkets</td></tr><tr><td></td><td>tobacco_and_alcohol</td></tr><tr><td></td><td>other_supplies</td></tr><tr><td>utility_services</td><td></td></tr><tr><td></td><td>rent_and_maintenance</td></tr><tr><td></td><td>water</td></tr><tr><td></td><td>natural_gas</td></tr><tr><td></td><td>electricity</td></tr><tr><td></td><td>telephone_internet_tv_computer</td></tr><tr><td></td><td>security</td></tr><tr><td>leisure_activities_and_hobbies</td><td></td></tr><tr><td></td><td>accommodation_travel_expenses</td></tr><tr><td></td><td>books_newspapers, magazines_stationery</td></tr><tr><td></td><td>pets</td></tr><tr><td></td><td>sport_and_sports_goods</td></tr><tr><td></td><td>theatre_music_cinema</td></tr><tr><td></td><td>hobbies_and_other_leisure_activities</td></tr><tr><td></td><td>gifts_&#x26;_florist</td></tr><tr><td></td><td>charity</td></tr><tr><td></td><td>shopping_mall_&#x26;_department stores</td></tr><tr><td>transportation</td><td></td></tr><tr><td></td><td>transportation_expenses</td></tr><tr><td></td><td>fuel</td></tr><tr><td></td><td>parking_&#x26;_tolls</td></tr><tr><td></td><td>vehicle_maintenance_and_rental</td></tr><tr><td>education_health_and_beauty</td><td></td></tr><tr><td></td><td>education_and_courses</td></tr><tr><td></td><td>health_and_pharmaceuticals</td></tr><tr><td></td><td>beauty_cosmetics</td></tr><tr><td>loans</td><td></td></tr><tr><td></td><td>general_loans</td></tr><tr><td></td><td>fast_loans</td></tr><tr><td></td><td>consumer_loans</td></tr><tr><td></td><td>credit_card_payment_&#x26;_transfers</td></tr><tr><td></td><td>credit_line</td></tr><tr><td></td><td>car_leasing</td></tr><tr><td></td><td>mortgage</td></tr><tr><td>gambling</td><td></td></tr><tr><td></td><td>sports_betting</td></tr><tr><td></td><td>lottery</td></tr><tr><td></td><td>casino</td></tr><tr><td>savings_and_investments</td><td></td></tr><tr><td></td><td>savings</td></tr><tr><td></td><td>investments</td></tr><tr><td>insurance</td><td></td></tr><tr><td></td><td>life_insurance</td></tr><tr><td></td><td>non-life_insurance</td></tr><tr><td></td><td>other_insurance_expenses</td></tr><tr><td>online_transactions</td><td></td></tr><tr><td></td><td>online_retail_purchases</td></tr><tr><td></td><td>online_services</td></tr><tr><td>personal_transfers</td><td></td></tr><tr><td></td><td>to_own_account</td></tr><tr><td></td><td>other_personal_transfers</td></tr><tr><td>other_outgoing_movements</td><td></td></tr><tr><td></td><td>other_transfers</td></tr><tr><td></td><td>other_payments</td></tr><tr><td></td><td>online_money_transfer</td></tr><tr><td></td><td>online_payments</td></tr><tr><td></td><td>transfer_to_payment_card</td></tr><tr><td></td><td>unknown</td></tr></tbody></table>
{% endtab %}

{% tab title="\[Coming] - European categories  🇪🇺" %}

<table><thead><tr><th>Parent category</th><th width="257">Children category</th><th>Description</th></tr></thead><tbody><tr><td>employment _wages</td><td></td><td></td></tr><tr><td></td><td>salary</td><td>Wage paid for work or services.</td></tr><tr><td></td><td>other_employment_wages</td><td>Other employment income.</td></tr><tr><td>government_support</td><td></td><td></td></tr><tr><td></td><td>unemployment_benefits</td><td></td></tr><tr><td></td><td>social_security</td><td></td></tr><tr><td></td><td>pension</td><td></td></tr><tr><td></td><td>other_government_support</td><td></td></tr><tr><td>housing_utilities</td><td></td><td></td></tr><tr><td></td><td>rent</td><td></td></tr><tr><td></td><td>security_services</td><td></td></tr><tr><td></td><td>home_maintenance</td><td></td></tr><tr><td></td><td>energy</td><td></td></tr><tr><td></td><td>water</td><td></td></tr><tr><td></td><td>internet_mobile_tv</td><td></td></tr><tr><td></td><td>pets</td><td></td></tr><tr><td></td><td>other_housing_utilities</td><td></td></tr><tr><td>groceries_stores</td><td></td><td></td></tr><tr><td></td><td>supermarkets_groceries</td><td></td></tr><tr><td></td><td>organic_specialty_food</td><td></td></tr><tr><td></td><td>bakery</td><td></td></tr><tr><td></td><td>tobacco_stores</td><td></td></tr><tr><td></td><td>other_groceries_stores</td><td></td></tr><tr><td>dining_out_food</td><td></td><td></td></tr><tr><td></td><td>restaurant_bar_coffee</td><td></td></tr><tr><td></td><td>food_delivery</td><td></td></tr><tr><td></td><td>other_dining_out_food</td><td></td></tr><tr><td>vehicle_expenses</td><td></td><td></td></tr><tr><td></td><td>fuel_gas</td><td></td></tr><tr><td></td><td>vehicle_maintenance_repairs</td><td></td></tr><tr><td></td><td>parking_tolls</td><td></td></tr><tr><td></td><td>other_vehicle_expenses</td><td></td></tr><tr><td>transports</td><td></td><td></td></tr><tr><td></td><td>local_transportation</td><td></td></tr><tr><td></td><td>plane_train_boat_travel</td><td></td></tr><tr><td></td><td>car_rental</td><td></td></tr><tr><td></td><td>other_transports</td><td></td></tr><tr><td>travel_accommodation_expenses</td><td></td><td></td></tr><tr><td></td><td>hotels_accommodation</td><td></td></tr><tr><td></td><td>other_travel_accommodation_expenses</td><td></td></tr><tr><td>medical_expenses</td><td></td><td></td></tr><tr><td></td><td>doctors_hospitals</td><td></td></tr><tr><td></td><td>other_medical_expenses</td><td></td></tr><tr><td>health_wellness</td><td></td><td></td></tr><tr><td></td><td>pharmacy</td><td></td></tr><tr><td></td><td>beauty_cosmetics</td><td></td></tr><tr><td></td><td>fitness_gym_spa_wellness</td><td></td></tr><tr><td></td><td>other_health_wellness</td><td></td></tr><tr><td>clothing_accessories</td><td></td><td></td></tr><tr><td></td><td>clothing_shoes</td><td></td></tr><tr><td></td><td>jewelry_accessories</td><td></td></tr><tr><td>digital_entertainment_technology</td><td></td><td></td></tr><tr><td></td><td>tech_accessories_electronics</td><td></td></tr><tr><td></td><td>gaming_software_apps</td><td></td></tr><tr><td></td><td>media_subscriptions</td><td></td></tr><tr><td></td><td>other_digital_entertainment_technology</td><td></td></tr><tr><td>general_shopping</td><td></td><td></td></tr><tr><td></td><td>department_stores</td><td></td></tr><tr><td></td><td>online_shopping</td><td></td></tr><tr><td></td><td>homegoods_gardening</td><td></td></tr><tr><td></td><td>books_media_stationery</td><td></td></tr><tr><td></td><td>gifts_florists</td><td></td></tr><tr><td></td><td>sports_goods</td><td></td></tr><tr><td></td><td>other_general_shopping</td><td></td></tr><tr><td>activities_events</td><td></td><td></td></tr><tr><td></td><td>theatre_cinema_culture</td><td></td></tr><tr><td></td><td>sport_events</td><td></td></tr><tr><td></td><td>hobbies_recreation_activities</td><td></td></tr><tr><td></td><td>other_activities_events</td><td></td></tr><tr><td>taxes</td><td></td><td></td></tr><tr><td></td><td>government_fees_taxes</td><td></td></tr><tr><td></td><td>fines_penalties</td><td></td></tr><tr><td></td><td>other_taxes</td><td></td></tr><tr><td>loans_credit</td><td></td><td></td></tr><tr><td></td><td>general_loans</td><td></td></tr><tr><td></td><td>fast_loans</td><td></td></tr><tr><td></td><td>leasing_renting</td><td></td></tr><tr><td></td><td>mortgage</td><td></td></tr><tr><td></td><td>other_loans_credit</td><td></td></tr><tr><td>insurance</td><td></td><td></td></tr><tr><td></td><td>life_insurance</td><td></td></tr><tr><td></td><td>medical_insurance</td><td></td></tr><tr><td></td><td>general_insurance</td><td></td></tr><tr><td></td><td>other_insurance</td><td></td></tr><tr><td>education</td><td></td><td></td></tr><tr><td></td><td>tuition</td><td></td></tr><tr><td></td><td>online_courses_training_certifications</td><td></td></tr><tr><td></td><td>other_education</td><td></td></tr><tr><td>professional</td><td></td><td></td></tr><tr><td></td><td>professional_services</td><td></td></tr><tr><td></td><td>postal_services</td><td></td></tr><tr><td></td><td>other_professional</td><td></td></tr><tr><td>transfers</td><td></td><td></td></tr><tr><td></td><td>p2p_payments</td><td></td></tr><tr><td></td><td>refund</td><td></td></tr><tr><td></td><td>online_money_transfers</td><td></td></tr><tr><td></td><td>wire_transfers</td><td></td></tr><tr><td></td><td>other_transfers</td><td></td></tr><tr><td>savings_investments</td><td></td><td></td></tr><tr><td></td><td>savings_deposits_investments</td><td></td></tr><tr><td></td><td>other_savings_investments</td><td></td></tr><tr><td>support</td><td></td><td></td></tr><tr><td></td><td>charity_religious contributions_ngo</td><td></td></tr><tr><td></td><td>alimony_child support</td><td></td></tr><tr><td></td><td>unions_associations</td><td></td></tr><tr><td></td><td>other_support</td><td></td></tr><tr><td>gambling</td><td></td><td></td></tr><tr><td></td><td>sports_betting_casino</td><td></td></tr><tr><td></td><td>lottery</td><td></td></tr><tr><td></td><td>other_gambling</td><td></td></tr><tr><td>bank_fees</td><td></td><td></td></tr><tr><td></td><td>deposit</td><td></td></tr><tr><td></td><td>withdrawal</td><td></td></tr><tr><td></td><td>banking fees</td><td></td></tr><tr><td></td><td>account_card_maintenance</td><td></td></tr><tr><td></td><td>irregularity_incident_fees</td><td></td></tr><tr><td></td><td>intervention_fees</td><td></td></tr><tr><td></td><td>foreign_exchange_fees</td><td></td></tr><tr><td></td><td>rejection_fees</td><td></td></tr><tr><td></td><td>third_party_administrative_seizure</td><td></td></tr><tr><td></td><td>other_bank_fees</td><td></td></tr><tr><td>misc</td><td></td><td></td></tr><tr><td></td><td>other</td><td></td></tr><tr><td></td><td>unknown</td><td></td></tr></tbody></table>
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powens.com/api-reference/products/data-aggregation/categorization.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
