List Matched Demands for Employee

get

https://apiv2.{domain}.ai/api/v2/core/employees/{profileId}/matched-demands

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

profileId

string

required

Employee Profile ID (supports both encoded and decoded ID)

Query Params

start

integer

Specifies the offset value to start for the page

limit

integer

Specifies the number of entries to be returned for the page

filterQuery

string

Demand Filter Query using predefined filter arguments documented here

applyMarketplaceFilters

boolean

Defaults to false

When true, applies the same filters used in the Demand Marketplace (Career Hub), including user group access control and configured visibility rules. Default: false

applyMatchedDemandsWidgetFilters

boolean

Defaults to false

When true, applies the same filters used in the Matched Demands widget on the employee profile page in Resource Management. Default: false

ignoreLocation

boolean

Defaults to false

When true, ignores the profile's location when matching demands. By default, demands are filtered to match the employee's location. Default: false

minStarThreshold

float

1 to 5

Defaults to 3.5

Minimum star rating threshold (1.0 to 5.0) for matched demands. Only demands with match scores at or above this threshold will be returned. Default: 3.5

exclude

string

Exclude specific fields in the response. Possible values are the names of the top level fields present in corresponding API schema. To check API schema, expand the response section below.

keyList

string

Allows selective control over the fields returned in the API response. If the keyList is empty, all fields will be returned. Possible values are the names of the top level fields present in corresponding API schema. To check API schema, expand the response section below.

Headers

Authorization

string

required

The secret key to access the api. It starts with the bearer token

Response

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK