---
title: "Get one read-only reporting identity"
method: GET
path: "/companies/{companyId}/reporting-scopes/{reportingScopeId}"
tags: ["Company Settings"]
---

# Get one read-only reporting identity

`GET /companies/{companyId}/reporting-scopes/{reportingScopeId}`

## Request

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

## Response `200`

Reporting scope

- ReportingScopeResponse
  - `success` boolean, required
  - `data` ReportingScope, required: A read-only consolidated reporting identity within one company. It is not a legal entity and cannot own postings, integrations, schedules, AR/AP items, Forecast state, or any other accounting fact.
    - `id` string, uuid, required
    - `companyId` string, uuid, required
    - `kind` 'consolidated', required
    - `label` string, required
    - `rootEntityId` string, uuid, required: The company's one persisted primary legal entity.
    - `createdByUserId` string, uuid, nullable, required
    - `createdAt` string, date-time, required
    - `retiredAt` string, date-time, nullable, required

## 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)