---
title: "List the actor's authorized legal entities"
method: GET
path: "/companies/{companyId}/entities"
tags: ["Company Settings"]
---

# List the actor's authorized legal entities

`GET /companies/{companyId}/entities`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/entities`
- Auth: HTTP bearer

Ordinary authenticated company-member discovery. Returns only concrete legal entities allowed by the actor's persisted entity grants; reporting scopes are separate and never appear here.

## Response `200`

List of entities

- EntitiesResponse
  - `success` boolean
  - `data` Entity[]
    - `id` string, uuid, required
    - `companyId` string, uuid, required
    - `name` string, required
    - `shortName` string, nullable
    - `role` string, nullable
    - `functionalCurrency` string, required: ISO 4217 functional currency code (e.g. USD, GBP).
    - `ownershipPct` number, nullable: Parent's ownership percentage of this entity, or null for the group/parent.
    - `parentEntityId` string, uuid, nullable
    - `isGroup` false, required: Deprecated compatibility field; Model A entities are always concrete.
    - `isPrimary` boolean, required: True for the one legal entity that owns legacy or otherwise unscoped accounting facts.

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)