Skip to navigation
EndpointsScreenings

Get worker's KYC details

Retrieves KYC verification details for a worker identified by worker_profile_id or profile_id; these two parameters are mutually exclusive. contract_id is required when multiple profiles are associated with the worker.

Token scopes: screenings:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

OR
AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

worker_profile_idstringOptionalformat: "uuid"

Worker’s HRIS profile public ID client requests to fetch KYC details for. This parameter is mutually exclusive with profile_id

contract_idstringOptional<=100 characters
Worker's contract ID. This parameter is required in case there are multiple profiles associated to the target worker. For example, when worker used to work for the former company he had another profile ID. So we need contract ID to properly resolve profile's KYC details. In case this parameter is not provided and multiple associated profiles are found, exception with 409 status code will be thrown
profile_idstringOptionalformat: "uuid"

Worker’s profile public ID client requests to fetch KYC details for, This parameter is mutually exclusive with worker_profile_id

Response

KYC details retrieved successfully
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
412
Precondition Failed Error
500
Internal Server Error