---
title: "Get a company by ID"
method: GET
path: "/companies/{companyId}"
tags: ["Companies"]
---

# Get a company by ID

`GET /companies/{companyId}`

## Request

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

## Response `200`

Company details

- CompanyResponse
  - `success` boolean
  - `data` Company
    - `fiscalYearEnd` string, nullable: Fiscal year end as MM-DD (companies.fiscal_year_end). Null means not confirmed; it is never defaulted to 12-31. Writes must be a real MM-DD date (422 otherwise). A value other than 12-31 flags month-end close and statements for review, because non-calendar fiscal years are not supported yet (#2019).
    - `clientStatus` 'test' | 'active' | 'inactive': Lifecycle marker (migration 089). Used by the accountant app to hide internal test tenants in production and filter customer lists by lifecycle stage. 'active' is the default on creation; 'test' is for internal QA / demo companies; 'inactive' is for customers no longer serviced.

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Company 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)