---
title: "List External Demands"
method: GET
path: "/api/v2/resource_management/ext-systems/resourcing/ext-demands"
tags: ["Ext Demand"]
---

# List External Demands

`GET /api/v2/resource_management/ext-systems/resourcing/ext-demands`

Search external demands using query parameters and get the complete external demand objects

## Query parameters

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

## Headers

- `Authorization` string, required

## Response `200`

OK

- object
  - `data` ExtDemandDataSchema[]
    - `createdAt` integer, nullable, required — creation timestamp in epoch format
    - `locationCountry` string, nullable — location country
    - `workLocationOption` string, nullable — Indicates the option for working location e.g. onsite, remote_global, remote_local, hybrid
    - `skillDetails` ATSSkillDetail[], nullable — skill details of the demand
      - `skillGroups` ATSSkillGroup[], nullable — Skill groups
        - `proficiency` string, nullable — Proficiency
        - `skillGroup` string, nullable — Skill Group
      - `proficiency` string, nullable — Proficiency. Note: proficiency must be specified only for each skill group when skill groups are present
      - `evaluationTimestamp` integer, nullable — Evaluation timestamp
      - `dataSource` string, nullable — Data source of the skill
      - `skill` string, nullable — Skill
    - `demandManager` PersonSchema
      - `email` string, nullable — email
      - `name` string, nullable, required — Name
    - `skills` string[], nullable — skills
    - `locationCity` string, nullable — location city
    - `lastUpdated` integer, nullable, required — last modified date time in epoch format
    - `demandBand` string, nullable — Demand Band
    - `rmUserGroups` RmUserGroup[], nullable — User groups associated with the demand
      - `userGroupId` string, nullable — Unique identifier for the user group
    - `openings` ExtDemandOpeningsData
      - `numOpenings` integer, nullable, required — Number of openings
      - `numOpeningsFilled` integer, nullable — Number of openings filled
    - `publishSettings` DemandPublishSettingsSchema
      - `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
    - `followers` PersonSchema[], nullable — all the followers of the demand such as resource manager etc.
      - `email` string, nullable — email
      - `name` string, nullable, required — Name
    - `restrictAccess` boolean, nullable — restrict access
    - `tags` ExtEntityTag[] — Tags associated with the demand
      - `type` 'user' | 'system', required — Type of the tag (user/system)
      - `name` string, required — Name of the tag
    - `title` string, nullable, required — demand title
    - `demandOrgUnits` ExtDemandOrgUnitsData
      - `programId` string, nullable — Program id
      - `projectId` string, nullable, required — Project id
    - `demandId` integer, nullable — Internal demand ID
    - `locationFlexibility` string, nullable — Indicates the flexibility on location e.g. not_flexible, flexible_within_country, flexible_global
    - `extDemandId` string, nullable, required — demand id in the external system
    - `maxExperience` integer, nullable — Maximum experience in years
    - `customFields` object, nullable — custom fields
    - `resourceManager` PersonSchema
      - `email` string, nullable — email
      - `name` string, nullable, required — Name
    - `workflowTemplateId` string, nullable — Indicates which workflow this demand belongs to
    - `displayDemandId` string, nullable — display demand id
    - `open` boolean, nullable, required — status of the demand: open or not
    - `minExperience` integer, nullable — Minimum experience in years
    - `requiredSkills` string[], nullable — required skills
    - `locationState` string, nullable — location state
    - `demandCode` string, nullable — Demand Code
    - `locations` string[], nullable — locations
    - `description` string, nullable — demand description
  - `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)