---
title: "List Org Units"
method: GET
path: "/api/v2/t3s/org-units"
tags: ["Org Unit"]
---

# List Org Units

`GET /api/v2/t3s/org-units`

Search org units using query parameters and get the complete org unit objects

## Query parameters

- `start` integer
- `limit` integer
- `filterQuery` string
- `query` string
- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- object
  - `data` OrgUnitSchema[]
    - `status` string, nullable — Org unit status
    - `updatedBy` string, nullable — Updated by
    - `orgUnitId` integer, nullable — Org unit id
    - `userGroups` RmUserGroup[], nullable — User groups associated with the org unit
      - `userGroupId` string, nullable — Unique identifier for the user group
    - `extOrgUnitId` string, nullable — External org unit id
    - `endDate` integer, nullable — End date timestamp
    - `createdBy` string, nullable — Created by
    - `description` string, nullable — Org unit description
    - `parentExtId` string, nullable — Parent external id
    - `startDate` integer, nullable — Start date timestamp
    - `systemId` string, nullable — Org unit system id
    - `type` string, nullable, required — Org unit type
    - `updatedAt` integer, nullable — Updated at timestamp
    - `customFields` object, nullable — Custom fields
    - `title` string, nullable, required — Org unit title
    - `tags` EntityTag[], nullable — Tags associated with the org unit
      - `type` 'user' | 'system', required — Type of the tag (user/system)
      - `name` string, required — Name of the tag
      - `category` 'inherited_tag' | 'null', nullable — Category of the tag (e.g. inherited_tag)
  - `meta` MetaSchema
    - `totalCount` integer, nullable
    - `pageTotalCount` integer, nullable
    - `pageStartIndex` integer, nullable

---

[API](https://skmtc.net/eightfold/apis/api-server-v2-service-service.md) · [All operations](https://skmtc.net/eightfold/apis/api-server-v2-service-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eightfold/api-server-v2-service-service/versions/0fb26f4e41bf/schema)