Get talent scans for account

Try it

See Talent scan properties for a detailed description of the json elements below.

Request parameters

Specify the parameters below to filter an account's talent scans.

Name	Description	Default value
accountId	A valid accountId must be provided.	/
externalRef	To specify the talent scan's reference at the account side (if there is one).	empty
shouldHaveExpectations	Set to true if you only want the talent scans that already have expectations calculated.	false
includeExpectations	Set to true if you want the results to contain the talent scan's expectations.	false
teamRoleIds	A comma-separated list of team role ids to filter on team roles.1	empty
workValueIds	A comma-separated list of work value ids to filter on work values.1	empty
offset	Sets the starting point of the query, e.g. if there are 10 talent scans, then offset = 5 will get you talent scans 6 to 10.	0
count	The maximum number of talent scans to return.	100
sort	To sort the result on one or more field(s). Use the hyphen sign for sorting in descending order, e.g. -contactlastname, -createdon will first sort on last name in descending order and then on the date of creation, also in descending order.	createdon
search	To filter on name and email. Partial matches are allowed.	empty
domainIds	A comma-separated list of domain ids2 to retrieve the talent scans with these domains.	empty
atsClientId	For talent scans linked to an applicant tracking system.	empty

¹ See Filter on expectations for a detailed explanation.

² Use the call Get domains to obtain these ids.

Response

Returns a list of talent scans that match the filter parameters.

[
  {
    "clientId": "guid",
    "createdOn": "datetime",
    "expectations": [
      {
        "expectationId": "guid",
        "score": number,
        "outDated": boolean,
        "rank": number,
        "reportRank": number
      }
    ],
    "id": "guid",
    "atsClientId": "guid",
    "clusterIds": [
      "guid"
    ],
    "domainIds": [
      "guid"
    ],
    "email": "string",
    "externalRef": "string",
    "firstName": "string",
    "lastName": "string",
    "nationality": "string",
    "phone": "string",
    "schoolIds": [
      "guid"
    ]
  }
]

Permission scopes

• read:talentscans