---
title: "Get Public Workforce Organization"
method: GET
path: "/v2/public/workforce-planning/organization"
tags: ["workforce-planning"]
---

# Get Public Workforce Organization

`GET /v2/public/workforce-planning/organization`

## Request

- Base URL: `https://api.sanka.com`
- URL: `https://api.sanka.com/v2/public/workforce-planning/organization`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sankahq/apis/sanka-public-api/docs/v2/public/workforce-planning/organization/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `workspace_id` string, nullable

## Headers

- `X-Workspace-Code` string

## Response `200`

Successful Response

- GetPublicWorkforceOrganization200Envelope
  - `success` true, required
  - `data` WorkforceOrganizationData, required
    - `can_manage_occupants` boolean
    - `nodes` WorkforcePositionData[]
      - `id` string, required
      - `display_id` integer, required
      - `parent_position_id` string, nullable
      - `title` string, required
      - `department` string, nullable
      - `team` string, nullable
      - `level` string, nullable
      - `location` string, nullable
      - `employment_type` string, nullable
      - `fte` number
      - `target_start_date` string, date, nullable
      - `planning_status` 'draft' | 'approved' | 'cancelled', required
      - `staffing_phase` 'planned' | 'ready_to_hire' | 'recruiting' | 'interviewing' | 'offer' | 'filled', required
      - `version` integer, required
      - `occupant` PositionOccupantData
        - `employee_id` string, nullable
        - `display_name` string, nullable
        - `profile_photo_url` string, nullable
        - `redacted` boolean
      - `job` PositionJobData
        - `id` string, required
        - `display_id` integer, required
        - `name` string, required
        - `status` string, required
        - `applicant_count` integer
        - `interview_count` integer
    - `unassigned_jobs` UnassignedJobData[]
      - `id` string, required
      - `display_id` integer, required
      - `name` string, required
      - `status` string, required
      - `applicant_count` integer
      - `interview_count` integer
    - `summary` WorkforceOrganizationSummary
      - `positions` integer
      - `planned` integer
      - `ready_to_hire` integer
      - `recruiting` integer
      - `interviewing` integer
      - `offer` integer
      - `filled` integer
      - `unassigned_jobs` integer
  - `meta` EnvelopeMeta, required
    - `ctx_id` string, required
    - `pagination` PaginationMeta
      - `page` integer, required
      - `page_size` integer, required
      - `total` integer, required
      - `next_cursor` string, nullable
    - `toast` ToastMessage
      - `variant` 'success' | 'error' | 'info' | 'warning', required
      - `code` string, required
      - `message` string, required
      - `i18n` ToastMessageI18n, required
        - `en` string, required
        - `ja` string, required

## Other responses

- `401`: Error response
- `422`: Error response

## Changes

- **2026-08-13** `aa943d5e3bd3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sankahq/apis/sanka-public-api/changes/v2/public/workforce-planning/organization/get.md)

---

[API](https://skmtc.dev/sankahq/apis/sanka-public-api.md) - [All operations](https://skmtc.dev/sankahq/apis/sanka-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sankahq/apis/sanka-public-api/revisions/16f03a9e3ab9?raw)