# Transactions labeling

## Schema

Category value is returned in the `tag` field.

## Dictionary

The dictionary is a living document and will continue to evolve over time. New entries may be added, and existing ones may be modified as the business and analytical needs develop.

Category dictionary:

- `income:salary` - employment contract
- `income:bonus` - bonus
- `income:freelance:contract` - civil law contracts
- `income:freelance:b2b` - B2B
- `income:rental` - rental income
- `income:invoicing` - income from invoices
- `income:pension` - pension
- `income:other` - other or unrecognized income
- `income:bond` - bonds / securities
- `income:dividend` - dividends
- `income:gains` - investment gains
- `income:crypto` - cryptocurrencies
- `income:inharitance` - inheritance
- `income:donation` - donation
- `income:interest` - bank account interest
- `benefit:social:state` - general social benefits, e.g. social assistance
- `benefit:social:agricultural` - social insurance for farmers
- `benefit:child` - child benefit (500+)
- `benefit:unemployment` - employment office benefits
- `benefit:alimony:direct` - alimony paid directly by the obligated person
- `benefit:alimony:fund` - alimony fund
- `benefit:housing` - housing subsidies
- `benefit:health` - health reimbursements
- `benefit:pension` - pension / retirement benefits
- `benefit:grant` - grants
- `benefit:other` - other or unrecognized benefits
- `refund` - refund
- `refund:tax` - tax refund
- `refund:merchant` - store / e-commerce refund
- `refund:cashback` - cashback
- `compensation:insurance` - insurance refund
- `compensation:claim` - loan return, correction, complaint
- `compensation:damages` - compensation from court judgment
- `lending:mortgage` - mortgage loan
- `lending:loan` - consumer loan
- `lending:microloan` - payday loans
- `lending:non_bank_loan` - non-bank financial institution loans
- `lending:leasing` - leasing
- `lending:factoring` - factoring
- `lending:repayment:on_time` - loan repayments
- `lending:repayment:card` - credit card repayment
- `lending:repayment:late` - delayed repayments
- `transfer:investment_ops` - deposit/withdrawal from investment/deposit account
- `transfer:savings` - deposits/withdrawals from savings account
- `transfer:bank` - bank transactions
- `transfer:bank:fee` - fees
- `transfer:bank:commission` - commissions
- `transfer:own` - between own accounts
- `transfer:foreign` - foreign transfers
- `transfer:foreign:fx` - currency exchange
- `transfer:domestic` - domestic transfers
- `transfer:domestic:provider` - transactions via online payment provider
- `transfer:domestic:express` - e.g. BLIK
- `transfer:domestic:card` - card transactions
- `transfer:atm` - ATM transactions
- `transfer:atm:deposit` - ATM deposits
- `transfer:atm:withdrawal` - ATM withdrawals
- `transfer:overdraft` - overdraft transactions
- `transfer:overdraft:withdrawal` - overdraft usage
- `transfer:overdraft:repayment` - overdraft repayment
- `transfer:verification` - identity verification transactions
- `transfer:other` - other transfers
- `housing:rent` - rent
- `housing:maintenance` - maintenance / renovations
- `bills` - bills
- `bills:electricity` - electricity
- `bills:heating` - heating
- `bills:gas` - gas
- `bills:water` - water
- `bills:internet` - internet, TV
- `bills:phone` - phone
- `bills:waste` - waste disposal
- `bills:multidistributor` - multi-utility provider
- `bills:other` - other fees
- `bills:streaming` - Netflix, HBO, Spotify
- `shopping` - shopping
- `shopping:groceries` - groceries
- `shopping:clothing` - clothing
- `shopping:electronics` - electronics
- `shopping:homegoods` - home goods
- `shopping:cosmetics` - cosmetics
- `shopping:jewelry` - jewelry
- `shopping:sports` - sports accessories
- `shopping:press` - press
- `shopping:press:books` - books and newspapers
- `shopping:press:magazines` - magazines
- `shopping:online` - online games
- `shopping:multibrand` - multi-brand retail chains
- `shopping:other` - other
- `shopping:ecommerce` - e-commerce
- `shopping:tobacco` - tobacco expenses
- `shopping:alcohol` - alcohol expenses
- `shopping:pets` - pet expenses
- `shopping:flowers` - florists
- `shopping:children` - expenses related to children
- `transport` - transport
- `transport:fuel` - fuel
- `transport:taxi` - taxi, uber etc.
- `transport:parking` - parking
- `transport:highway` - highways
- `transport:repair` - service, repairs
- `transport:public` - public transport
- `transport:other` - other
- `food:restaurant` - restaurants
- `food:bar` - pubs, bars
- `food:delivery` - take-away / food delivery
- `travel` - travel
- `travel:ticket` - tickets
- `travel:hotel` - hotels, apartments, campsites
- `travel:agency` - organized holidays
- `travel:bussiness` - business trips
- `travel:other` - other travel
- `leisure` - leisure
- `leisure:entertainment` - cinema, theatre tickets
- `leisure:sports` - sports events tickets
- `leisure:others` - other leisure
- `health` - health
- `health:doctor` - doctor
- `health:dentist` - dentist
- `health:pharmacy` - pharmacy
- `education` - education
- `education:tuition` - tuition, schools
- `education:course` - courses, training
- `education:books` - books, textbooks
- `education:scholarship` - scholarships and educational grants
- `insurance` - insurance
- `insurance:car` - car insurance
- `insurance:life` - life insurance
- `insurance:home` - home insurance
- `insurance:other` - other insurance
- `insurance:travel` - travel insurance
- `insurance:indemnity` - indemnity insurance
- `tax` - tax
- `tax:property` - property tax
- `tax:income` - includes all personal income taxes
- `tax:income:monthly` - monthly personal income tax
- `tax:income:quartaly` - quarterly personal income tax
- `tax:income:b2b` - business income tax (B2B)
- `tax:vat` - value-added tax (VAT)
- `tax:vat:monthly` - monthly VAT
- `tax:vat:quartaly` - quarterly VAT
- `tax:social` - social contributions
- `tax:corporate` - includes all corporate income taxes
- `tax:corporate:monthly` - monthly corporate income tax
- `tax:corporate:quartaly` - quarterly corporate income tax
- `tax:other` - other taxes
- `tax:transfer_tax` - civil law transaction tax
- `tax:agricultural` - agricultural social insurance
- `tax:penalty` - fines, interest, tax penalties
- `services:legal` - lawyer
- `services:accounting` - accountant
- `services:repair` - repairs
- `services:cleaning` - cleaning
- `services:delivery` - delivery, couriers
- `services:other` - other
- `gambling` - gambling
- `gambling:betting` - sports betting
- `gambling:lotteries` - lotteries
- `gambling:casinos` - casinos
- `gambling:other` - other
- `donations:charity` - public benefit organization
- `donations:ngo` - non-governmental organizations
- `donations:other` - other
- `debt` - debt
- `debt:private` - private debt collection
- `debt:public` - public institution debt collection
- `debt:public:tax` - tax office debt collection
- `debt:public:social` - social insurance (ZUS) debt collection
- `debt:court` - court, bailiff, or enforcement costs
- `debt:other` - other
- `other:monthly` - recurring monthly transactions with similar title, date, and amount
- `other:uncategorized` - uncategorize