---
title: "Get Demand"
method: GET
path: "/api/v2/resource_management/demands/{demandId}"
tags: ["Demand"]
---

# Get Demand

`GET /api/v2/resource_management/demands/{demandId}`

Given a demand id, it returns all attributes of the demand

## Path parameters

- `demandId` string, required

## Query parameters

- `include` string
- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- DemandSchema
  - `isArchived` boolean, nullable — Whether the demand has been archived or not
  - `demandManager` PersonSchema
    - `email` string, nullable — email
    - `name` string, nullable, required — Name
  - `capacity` number, float, nullable, required — Capacity of the demand
  - `serviceLine` string, nullable — Service Line of the demand
  - `rmUserGroups` RmUserGroup[], nullable — User groups associated with the demand
    - `userGroupId` string, nullable — Unique identifier for the user group
  - `publishSettings` DemandPublishSettings
    - `publishMode` string, nullable — Publish mode (local, custom, local_and_custom)
    - `publishedToUserGroups` RmUserGroup[], nullable — User groups the demand is published to
      - `userGroupId` string, nullable — Unique identifier for the user group
  - `name` string, nullable — Title of the Demand
  - `userId` string, nullable — User who created the demand
  - `followers` string[], nullable — all the followers of the demand
  - `startDate` integer, nullable, required — Start date of the demand
  - `demandOrgUnits` DemandOrgUnit[], nullable — Org units (program, project) associated with the demand
    - `externalId` string, nullable — external id
    - `id` integer, nullable — id
    - `isArchived` boolean, nullable — is archived
    - `status` string, nullable — status
    - `userGroups` RmUserGroup[], nullable — User groups associated with the demand
      - `userGroupId` string, nullable — Unique identifier for the user group
    - `mainOwner` PersonSchema
      - `email` string, nullable — email
      - `name` string, nullable, required — Name
    - `endDate` integer, nullable — end date in epoch timestamp
    - `otherOwners` PersonSchema[], nullable — other owners
      - `email` string, nullable — email
      - `name` string, nullable, required — Name
    - `parentExtId` string, nullable — parent external id
    - `startDate` integer, nullable — start date in epoch timestamp
    - `type` string, nullable — org unit type
    - `customFields` object, nullable — custom fields
    - `title` string, nullable — title
    - `tags` EntityTag[] — Tags associated with the demand 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)
  - `demandId` integer, nullable — Demand id
  - `endDate` integer, nullable, required — End date of the demand
  - `demandStatus` string, nullable, required — Status of the demand
  - `numOpenings` integer, nullable — The number of openings for this demand
  - `calibrationConfirmedBy` string, nullable — User who confirmed the calibration
  - `resourceManager` PersonSchema
    - `email` string, nullable — email
    - `name` string, nullable, required — Name
  - `calibrationConfirmedAt` integer, nullable — Confirmed timestamp for the calibration
  - `calibrationData` DemandCalibrationData
    - `flags` string[], nullable — flags
    - `skillProficiencies` SkillProficiency[], nullable — skill proficiencies
      - `proficiency` number, float, nullable — proficiency of the role
      - `skillGroupList` SkillGroupList[], nullable — skill group list of a role
        - `proficiency` number, float, nullable — group proficiency of the skill group
        - `groupName` string, nullable — name of the skill group
        - `level` string, nullable — level of the role
        - `skillCategory` string, nullable — skill category of the skill group
      - `level` string, nullable — level of the role
      - `name` string, nullable — name of the role
    - `minExperience` integer, nullable — min experience
    - `workCategories` string[], nullable — work categories
    - `demandTitle` string, nullable — demand title
    - `notes` string, nullable — notes
    - `numOpenings` integer, nullable — number of openings
    - `relocation` string[], nullable — relocation
    - `skills` string[], nullable — skills
    - `seniorities` string[], nullable — seniorities
    - `titles` string[], nullable — alternative demand titles
    - `idealResources` string[], nullable — ideal resources
    - `locations` string[], nullable — locations
    - `maxExperience` integer, nullable — max experience
    - `customFields` object, nullable — custom fields
    - `idealResourceUrls` string[], nullable — ideal resources url
    - `tags` EntityTag[] — Tags associated with the demand
      - `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)
  - `subServiceLine` string, nullable — Sub service line of the demand
  - `role` RoleSchema
    - `templates` CalibrationTemplate[], nullable — all calibration templates associated with the role
      - `id` integer, nullable — id of the calibration template
      - `name` string, nullable — Name of the calibration template
    - `name` string, nullable — name of the role
  - `description` string, nullable — Detailed Description in a text format

---

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