# Find a company and see its activity

> Open Data Platform › Companies, search for a B2B company and open it to see its details, linked profiles and aggregated statistics.

The **Companies** page lists the B2B customer companies of your shop. Open a company to see its contact details and custom fields, the people linked to it, its recent events and its aggregated statistics.

Companies come in through the [B2B API](https://releva.ai/documentation/reference/companies/overview/) or the **Add Company** form. People are linked to a company only through the roles API. See [Companies and roles](https://releva.ai/documentation/learn/companies/companies-and-roles/).

> **For developers**
>
> Companies and roles, and the calls that create companies and link people to them, are in **Developers › Customer data**: start with [Companies and roles](https://releva.ai/documentation/learn/companies/companies-and-roles/) and [Create or update companies](https://releva.ai/documentation/reference/companies/create-or-update-companies/).

## Before you start

* Your shop has at least one company. An empty list shows **0 Companies**.
* Your plan includes the Companies page. If the **Companies** menu item is greyed out, ask your account owner to unlock it.
* You know the company’s exact Company ID, email address, phone number or full name.

## Steps

1. In the left menu, select **Data Platform › Companies**.

   ![Step 1](https://releva.ai/documentation/_astro/step-1.LIbLAhit_ZzihrE.webp)

2. In the search box, enter the Company ID, email, phone number or full company name.

   The search matches whole values only. See [What the search matches](https://releva.ai/documentation/guides/companies/find-a-company/#what-the-search-matches).

   ![Step 2](https://releva.ai/documentation/_astro/step-2.Di0T9lOX_Z1Qylim.webp)

3. Select **Search**.

   **Search** stays disabled while the box is empty.

   ![Step 3](https://releva.ai/documentation/_astro/step-3.Ble2cEwo_25qFoP.webp)

4. The list shows the matching company.

   Each row shows the name, email, phone number and the time of the last change.

   ![Step 4](https://releva.ai/documentation/_astro/step-4.Bg3DlgKU_Z15E0vL.webp)

5. Select the company name to open it.

   ![Step 5](https://releva.ai/documentation/_astro/step-5.CK46qVBg_1hQsXf.webp)

6. The company card shows the Company ID, email, phone number and any custom fields sent through the API.

   Custom fields appear on the right as `customString`, `customNumeric` and `customDate`. Tags are not shown here; open **Edit** to see them. The **Recent Events** tab below lists the events your shop sent with this company’s id.

   ![Step 6](https://releva.ai/documentation/_astro/step-6.BAUrEB30_Z9ThFH.webp)

7. Select **Profiles** to see the people linked to this company.

   ![Step 7](https://releva.ai/documentation/_astro/step-7.BQrVpaB1_1kGflQ.webp)

8. Each profile linked to the company through the roles API is listed here.

   The role name is not shown. Select a profile to open it.

   ![Step 8](https://releva.ai/documentation/_astro/step-8.BsUDOawF_Z1dMr5w.webp)

9. Select **Aggregated Statistics**.

   ![Step 9](https://releva.ai/documentation/_astro/step-9.5cbmpdsA_vQumG.webp)

10. See product views, orders, customer value, average order value and average order size for the last month or the last 3 months.

    The numbers count the events that carry this company’s id. Switch between **Last Month** and **Last 3 Months** above the table.

    ![Step 10](https://releva.ai/documentation/_astro/step-10.CfqndSlW_ZKB6Pg.webp)

## What the search matches

| You enter    | Matches when                                                                                                                 |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| Company ID   | Exactly the stored id, including letter case. `DEMO-CO-1001` finds the company; `demo-co-1001` does not.                     |
| Email        | Exactly the stored address, any letter case.                                                                                 |
| Phone number | Exactly the stored number, including the leading `+`.                                                                        |
| Name         | The whole name typed in lower case. `demo wholesale ltd` finds “Demo Wholesale Ltd”; `Demo Wholesale Ltd` and `demo` do not. |

There are no partial matches.

## Check it worked

* After step 4 the card above the table reads **1 Companies** and the row shows the company you searched for.
* The company card shows the **Company ID** you expect under the `#` sign.
* The browser tab title reads **Releva | Companies | \<company name> | Details**.

## Troubleshooting

**The list shows 0 Companies for a company you know exists.** Check the value against the table above: Company ID and phone number must match exactly, and a name must be the full name in lower case. Also check that the company was not deleted.

**I want the full list back after a search.** Emptying the box does not help, because **Search** is disabled when the box is empty. Select **Companies** in the left menu again, or **Companies** in the breadcrumb on a company page.

**A company I just added is not in the list.** Companies are written a few seconds after you save or send them. Open **Companies** again after a few seconds.

**The count above the table is higher than the number of rows.** The count still includes companies that were deleted. It is a known issue; the rows are correct.

**The company card shows N/A for the email although the company has one.** The card shows the email only when the company also has a phone number. It is a known display issue; the email is still stored and shown in the list and on the **Edit** form.

**The same person appears twice on the Profiles tab.** The tab lists every stored version of a profile that was updated more than once, while the count above it counts each person once. It is a known issue.

**Orders, Customer Value and the averages read 0 although the company has orders.** The **Aggregated Statistics** tab counts the product views correctly but does not pick up the order rows. It is a known issue; see the orders on the **Recent Events** tab or on each linked profile.

**The Companies menu item is disabled.** Your plan does not include the Companies page. Users who manage the subscription see an unlock button next to the item.

## Next steps

* [Add a company](https://releva.ai/documentation/guides/companies/add-a-company/): Create a company by hand with the id your own systems use.
* [Edit or delete a company](https://releva.ai/documentation/guides/companies/edit-a-company/): Change a company’s name, contact details and tags, or remove it.
* [Companies and roles](https://releva.ai/documentation/learn/companies/companies-and-roles/): Learn how people are linked to companies and how updates and deletes behave.
* [B2B API overview](https://releva.ai/documentation/reference/companies/overview/): Create companies and link profiles to them from your own systems.