Sign in

v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Companies

Get Company Restrictions by Talent ID

Returns a list of companies where the specified talent is blocked from placement.

get/v1/company-restrictions/talent/{talentId}

Path parameters

talentIdstring required

The identifier for the talent whose company restrictions are being retrieved.

Headers

RequestIdstring uuid

The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.

Unique request identifier (UUID) used to correlate request data with log entries and events.

FrontOfficeTenantIdinteger

An integer identifier for the tenant that the request is being made for. Required when Tenant header is not provided.

Tenantstring

Tenant company code that determines data access scope during the request. Required when FrontOfficeTenantId header is not provided.

Response

The list of companies where the specified talent is blocked from placement.

idinteger

The identifier for the company restriction.

companyIdinteger

The identifier for the company the restriction applies to.

branchIdsstring

The string representation of the array of identifiers for the departments the restriction applies to.

talentNamestring

The name of the talent who has been restricted from placement.

notesstring

Notes on the restriction.

userIdinteger

The identifier for the user who has added the restriction.

userNamestring

The name of the user who has added a restriction.

companyNamestring

The name of the company the restriction applies to.

talentIdinteger

The identifier for the talent who is blocked from placement at the selected company or office.

restrictionDatestring date-time

The date when the restriction has been added. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.

Example response

[
  {
    "id": 123456,
    "companyId": 284997,
    "branchIds": "[1835, 1383, 1922]",
    "talentName": "John Doe",
    "notes": "This talent is not eligible for placement due to previous performance issues.",
    "userId": 12345,
    "userName": "Jane Smith",
    "companyName": "Acme Corp",
    "talentId": 123456
  }
]