---
title: "List business entities in an org"
method: GET
path: "/v1/organization/business_entities"
tags: ["Organization management"]
---

# List business entities in an org

`GET /v1/organization/business_entities`

Use this endpoint to get a list of business entities that meet a specific filtering criteria.

## Query parameters

- `business_entity_type_id` string, uuid
- `business_entity_type_category` 'ORG_LEVEL' | 'MID_LEVEL' | 'FACILITY_LEVEL' | 'PROCESS_LEVEL'

## Response `200`

the list of business entities

- BusinessEntity[]
  - `id` string, uuid, required
  - `orgID` string, uuid
  - `parentID` string, uuid, nullable
  - `name` string, required — The name of the business entity
  - `description` string — A description of the business entity
  - `countryCode` string — The country code of the business entity.
  - `subIndustryCode` string, nullable — The sub-industry code of the business entity or functional unit, formatted as eight digits.
  - `facilityTypeID` string, uuid, nullable — The facility type of the business entity if it is a facility.
  - `processTypeID` string, uuid, nullable — The process type of the business entity if it is a process.
  - `businessEntityTypeID` string, uuid
  - `defaultFunctionalUnitID` string, uuid
  - `defaultDisplayUnit` string — The default display unit for the functional unit of the business entity
  - `activeStartTimestamp` number — The timestamp when the business entity becomes active, in milliseconds since epoch
  - `activeEndTimestamp` number — The timestamp when the business entity becomes inactive, in milliseconds since epoch

## Other responses

- `403` — You are not authorized to acess this object

---

[API](https://skmtc.net/sinai/apis/sinai-api.md) · [All operations](https://skmtc.net/sinai/apis/sinai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinai/sinai-api/revisions/495dab1b31fd/schema)