Sign in

v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Companies

Get Company Restrictions

Returns details about the talents who are blocked from placement at the specified company.

get/v1/company-restrictions/{companyId}

Path parameters

companyIdstring required

The identifier for the company for which 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 Company Restrictions details.

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
  }
]