Business Insights
These domains give a deeper view into the company's operational structure: who works there, who it does business with, where it pays internationally, and how its spending is distributed.
Staff
Required scope: company-staff · Endpoint: GET /staff
Estimates personnel costs and employee headcount from salary-related transactions and contracts. The analysis distinguishes between gross salary expenses and additional wage costs (e.g. social insurance contributions).
Response structure
| Field | Description |
|---|---|
salary.totalMonthly | Combined estimated monthly personnel cost |
salary.totalMonthlyExpenses | Gross salary component |
salary.totalMonthlyAdditionalWageCosts | Additional wage costs (social contributions, etc.) |
employees.minNumberOfEmployees | Lower bound of estimated employee count |
employees.maxNumberOfEmployees | Upper bound of estimated employee count |
sources.contracts | Contracts that contributed to the analysis |
sources.transactionIDs | Transaction IDs used for collective payment detection |
Employee count is estimated from individually detected salary contracts and collective salary transfers. It is provided as a range rather than an exact value.
Customers & Suppliers
Required scope: company-customer-supplier · Endpoint: GET /customer-supplier
Ranks the company's most significant payment partners. Partners with predominantly incoming payments are classified as customers; those with predominantly outgoing payments as suppliers. Each partner receives a combined ranking score based on transaction volume and frequency.
Response structure
Both customers and suppliers contain a partnerList array, sorted by ranking:
| Field | Description |
|---|---|
paymentPartner | Name, IBAN, and other counterparty details |
ranking.rank | Combined score (average of revenue rank and occurrence rank) |
ranking.revenueRank | Rank by total transaction amount |
ranking.revenueScore | Share of total revenue (percentage) |
ranking.occurrenceRank | Rank by number of transactions |
ranking.occurrenceScore | Share of total occurrences (percentage) |
total | Aggregated amount and count over the entire observed period |
monthlyOverview[] | Month-by-month breakdown of payments to/from this partner |
paymentTimespan | First and last transaction date with this partner |
Top Categories
Required scope: company-top-category · Endpoint: GET /top-categories
Shows how company is distributed across transaction categories. For each detected category, a monthly and daily time series of amounts is provided.
Response structure
| Field | Description |
|---|---|
categories[] | List of detected spending categories |
categories[].category | Category identifier |
categories[].paymentType | Payment type: earning / spending |
categories[].monthlyOverview[] | Monthly amounts, sorted ascending by month |
monthlyOverview[].month | Month in YYYY-MM format |
monthlyOverview[].amount | Total amount for the month |
monthlyOverview[].dailyOverview[] | Per-day breakdown within the month |
monthlyOverview[].dailyOverview[].date | Date in YYYY-MM-DD format |
monthlyOverview[].dailyOverview[].amount | Total amount for that day |
monthlyOverview[].dailyOverview[].transactionIDs | IDs of the underlying transactions |