---
title: "List Demands"
method: GET
path: "/api/v2/resource_management/demands"
tags: ["Demand"]
---

# List Demands

`GET /api/v2/resource_management/demands`

Search demands using query parameters and get the complete demand objects

## Query parameters

- `start` integer
- `limit` integer
- `extDemandId` string
- `filterQuery` string
- `query` string
- `includeArchived` boolean
- `include` string
- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- object
  - `data` 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
  - `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)