---
title: "List Matched Demands for Employee"
method: GET
path: "/api/v2/core/employees/{profileId}/matched-demands"
tags: ["Employee", "Demand"]
---

# List Matched Demands for Employee

`GET /api/v2/core/employees/{profileId}/matched-demands`

## Request

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

Returns all the matching demands for an employee profile. Only works for employee profiles, not candidates. By default, demands are filtered by the employee's location and a minimum star rating threshold of 3.5. Results are sorted by match score (highest to lowest). Use ignoreLocation=true to search globally and minStarThreshold to adjust the quality threshold.

## Path parameters

- `profileId` string, required

## Query parameters

- `start` integer
- `limit` integer
- `filterQuery` string
- `applyMarketplaceFilters` boolean
- `applyMatchedDemandsWidgetFilters` boolean
- `ignoreLocation` boolean
- `minStarThreshold` number, float
- `exclude` string
- `keyList` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- object
  - `data` MatchingDemandsSchema[]
    - `missingSkills` string[], nullable: Demand skills missing in resource's profile
    - `skillScoreRelevance` number, float, nullable: Skill relevance score based on matching of demand and resource profile
    - `demand` ConciseDemandSchema
      - `demandId` integer, nullable: Demand ID
      - `extDemandId` string, nullable: External demand ID in the ATS system
      - `name` string, nullable: Title of the demand
      - `locations` string[], nullable: The location(s) of the demand
    - `validatedSkills` string[], nullable: Demand skills validated in resource's profile
    - `finalScore` number, float, nullable: The matching score (range 0 to 5) of demand and resource profile
    - `titleScoreRelevance` number, float, nullable: Title relevance score based on matching demand's hiring title with resource's experience titles
  - `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)