---
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`

## Request

- Base URL: `https://apiv2.eightfold.ai`
- URL: `https://apiv2.eightfold.ai/api/v2/resource_management/ext-systems/resourcing/ext-demands`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/eightfold/apis/api-server-v2-service-service/docs/api/v2/resource_management/ext-systems/resourcing/ext-demands/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/eightfold/apis/api-server-v2-service-service.md) - [All operations](https://skmtc.dev/eightfold/apis/api-server-v2-service-service/llms.txt) - [OpenAPI document](https://skmtc.dev/eightfold/apis/api-server-v2-service-service/revisions/9a8b3a927e93?raw)