v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB

Placements

Get an Extended Placement

Returns details about the specified placement, with updates from the specified extension.

get/v1/placement/{placementId}/extension/{extensionId}

Path parameters

placementIdstring required

The identifier for the placement to be retrieved.

extensionIdstring required

The identifier for the extension to be applied to the placement retrieval.

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 requested placement and extension details.

placementGuidstring uuid

The unique identifier for the placement, formatted as a GUID.

branchGuidstring uuid

The unique identifier for the branch associated with the talent, formatted as a GUID.

backOfficeAssignmentIdinteger

The ID of the Assignment in the Back Office.

isW2boolean

An indication of whether the placement is a W2 placement (true) or a contract placement (false).

agencyGuidstring uuid

The vendor agency GUID, used when the placement is a contract placement (IsW2 = false) and payment should be directed to the vendor instead of the talent.

jobTitlestring

Job title for the placement, as defined on the Job.

Example response

{
  "WorkSiteAddress": {
    "addressGuid": "cb63d8fc-6d06-f011-87a7-a0595061251e",
    "street1": "123 Main St.",
    "street2": "Suite 250",
    "city": "Minneapolis",
    "state": "MN",
    "postalCode": "55435",
    "country": "US"
  }
}