# See all your companies in the Portfolio

> See each company that you manage with its workspaces, their revenue, MRR and customers, and the totals of the group.

The Portfolio shows each company that you own or manage, and the workspaces of each company. It gives the revenue, the refunds, the profit, the MRR, the customers and the disputes of each one in one place. It also gives the totals of each company and of the whole group.

## Terms

| Term      | Meaning                                                                              |
| --------- | ------------------------------------------------------------------------------------ |
| Company   | A company in Troopy. It is one legal entity, with one country and one currency.      |
| Workspace | A product of a company. Most companies have one workspace. Some companies have more. |
| Group     | All the companies that you see in the Portfolio.                                     |

## Who sees the Portfolio

The Portfolio shows each company where you are an owner, an admin or the accountant. If you are none of these in any company, Troopy does not show the Portfolio. A guest never sees it.

For the companies where you are the accountant, the Portfolio shows only the money and the paying customers. It shows no troop, no plan at Troopy and no customers at risk.

## Open the Portfolio

1. Select the workspace menu at the top of the sidebar.
2. Under the workspaces, select **Portfolio**.

You can also press ⌘K (Ctrl+K on Windows), type **Portfolio**, and press Enter.

## Read the chart

The **Chart** tab shows you at the top, each company under you, and each workspace under its company. A row has five companies at most.

- A company with one workspace is one card. The workspace is inside the card.
- A company with more workspaces has a line to each of its workspaces.
- A company card shows the logo, the name, the MRR, the revenue and the profit of the period. A company with no logo shows its flag. Under the name are the legal name, if it is different, the country and the currency.
- Owners and admins select the logo or the flag of a company to add a new logo. It saves at once. To remove the logo, open **Settings** > **Company** > **General**.
- A workspace shows its logo, its name, the faces of its troop, its MRR and its paying customers. A workspace with no payment provider shows a dash for its MRR.
- A bar under a workspace shows its part of the MRR of its company.
- A troop at work or a troop that its plan stopped also shows its state.

Drag the chart to move it. To zoom, pinch on a trackpad, or select **Zoom in** or **Zoom out** at the bottom right. **Fit the chart** shows all of it again. To open a workspace, use the workspace menu. On a phone, the companies are in one column and the chart does not zoom.

## Read the table

The **Table** tab has one group of rows for each company. The columns are **Revenue**, **Refunds**, **Profit**, **MRR**, **Customers**, **At risk**, **Disputes** and **Plan**. Each company has a total row. The last row is the total of the group. A workspace with no payment provider shows a dash for its MRR, and the totals count it as zero. On a phone, each row is a list of its numbers.

## Pick a period

Select a period at the top of the page: **This month**, **Last month**, **This quarter**, **This year** or **Last year**. On a phone, the periods are in a menu. The months of the period show beside the periods.

- A month and a quarter start and end at midnight UTC.
- A year is the fiscal year of each company. If two companies have different fiscal years, each company shows its own months.

## The money

- Revenue is the same sum that Analytics shows for the same window. A refund does not take revenue down. A free trial counts nothing.
- Profit is the revenue less the refunds. It is below zero when more money went back than came in.
- MRR is the MRR on the last day of the period that Troopy has.
- The customers, the customers at risk and the open disputes are the numbers of today.
- Each workspace shows its money in the currency of each payment.
- The total of a company is in the currency of the company.
- The total of the group is in the currency that you pick beside the period. Troopy picks the currency of the first company that has one, or USD.

A total that adds more than one currency uses the rates of the European Central Bank (ECB). The page gives the day of the rate. If the ECB gives no rate for a currency, the page shows the amounts by currency, and no total.

Profit takes off only the refunds. Troopy does not read costs, payroll, bank balances, or the tax and the fees of a payment.

## Add the legal details

A company with no country or no currency shows the link **Add the legal details** under its name.

1. Select **Add the legal details**. Troopy opens the workspace of that company, on **Settings** > **Company**.
2. Under **Legal details**, fill in the details. See [Use companies and workspaces](/docs/workspaces#add-the-legal-details).
3. Select **Save**.

## Give your accountant a report

The report for your accountant gives the revenue, the refunds and the disputes of one company in one fiscal year. It has one line for each month, each workspace and each currency.

1. In the Portfolio, select **Download for your accountant**.
2. Find the company, and pick the fiscal year. You can pick this year or one of the 3 years before it.
3. Select **CSV** to download a file for a spreadsheet, or **Page to print** to open the report.
4. On the report, select **Print**. To get a PDF, pick **Save as PDF** as the printer.

The page to print shows the legal details, a table of each month with a total, and one table for each workspace. The print has no sidebar and no buttons, in black on white on A4.

The money in the report:

- Each amount is in the currency that the customer paid. It is also in the currency of the company.
- The converted amount uses the reference rate of the ECB on the day of the payment. A weekend or a holiday uses the rate of the last day before it. Your accountant can use the official rate of your country in its place.
- A dispute counts in the month that it opened, with its status today.
- The revenue of the year is the same sum that the Portfolio shows for **This year** or **Last year**.
- If the ECB gives no rate for a currency, the report gives the amount in the paid currency only, and says why.
- If the company has no currency, the report converts nothing. Add the currency first.

The report does not hold costs, payroll, bank balances, or the tax and the fees of each payment.

The CSV has these columns: Company, Country, Fiscal year, Month, Workspace, Kind, Paid currency, Paid amount, Company currency, Converted amount, ECB rate, Day of the rate, Count and Dispute status. The ECB rate of a row is the average of the rates of its days, weighted by amount.

## Invite your accountant

Your accountant can read the Portfolio and the reports of a company in Troopy, and nothing else. An owner or an admin of the company sends the invite.

1. Open the workspace of the company.
2. Open **Settings**. Under **Company**, select **Admins**.
3. Under **Accountant**, enter the **Email** of the accountant.
4. Select **Invite an accountant**.

Troopy emails the link. The email says what the accountant sees. The link works one time, for that email, for 7 days. A company has 5 accountants at most, with the invites that wait. See [Invite people and choose their roles](/docs/people#the-accountant-of-the-company).

The accountant accepts the invite with a new account or with its own account. Then it opens Troopy on the Portfolio, at **/accountant**. It sees the legal details, the money of each workspace and the reports, with **CSV** and **Page to print**. It sees no workspace, no sidebar and no teammate. Troopy makes no company for it. **Start your own Troopy** on its page makes one, as a sign-up does.

An accountant of more than one company sees each company in one Portfolio. A person who has its own workspaces sees the companies of its accountant role in its own Portfolio, with the same limits.

To stop the access of an accountant, select **Remove** in its row under **Accountant**.

## Read the numbers with the API

An API key with the scope `company:read` reads the numbers of the company of the key. Only owners and admins can use it. A key never reads another company.

```bash
troopy company overview --from 2026-01-01 --to 2026-12-31
```

The same key reads the report for the accountant of a fiscal year. The year is the calendar year in which the fiscal year starts.

```bash
troopy company report --year 2026
```

A key with `company:read` lists the accountants and the invites that wait. A key with `company:write` invites an accountant, revokes an invite and removes an accountant. An accountant has no workspace, so it makes no API key.

```bash
troopy company accountants
troopy company invite-accountant --email books@example.com
```
