Skip to content
Recruso API

List a site contact's cost centres

GET
/v1/clients/{clientId}/sites/{siteId}/contact-persons/{contactPersonId}/cost-centres
curl --request GET \
  --url https://api2.recruso.co.uk/v1/clients/1/sites/1/contact-persons/1/cost-centres \
  --header 'Authorization: <Authorization>'

Returns every cost centre linked to one contact at one of your own agency’s sites.

This list is not paged and takes no filters. Each entry carries the link’s own id, which is what RemoveSiteContactCostCentre takes, not the cost centre id.

The list carries ids only. Read the cost centres themselves through the branch’s cost centre endpoints for their names and details.

The client, site and contact in the route must line up — the site must belong to the client and the contact to the site — and any mismatch returns 404 rather than 403.

Access. Requires a client-credentials access token. Tokens issued through the interactive user login are rejected.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
clientId
required
integer format: int32

The clientId path parameter

siteId
required
integer format: int32

The siteId path parameter

contactPersonId
required
integer format: int32

The contactPersonId path parameter

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json

Every cost centre linked to the site contact. Not paged.

object
costCentres

The cost centres linked to this contact, as link records.

Array<object>

One cost centre linked to the site contact.

object
contactPersonCostCentreId

The link’s own identifier. This is what RemoveSiteContactCostCentre takes, not the cost centre id.

integer format: int32
contactPersonId

The site contact the cost centre is linked to.

integer format: int32
costCentreId

The cost centre being linked. Must belong to the same branch as the site.

integer format: int16
Example
{
  "costCentres": [
    {
      "contactPersonCostCentreId": 204,
      "contactPersonId": 88,
      "costCentreId": 19
    }
  ]
}

401

Section titled “401”

Unauthorized

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

403

Section titled “403”

Forbidden

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

404

Section titled “404”

Not Found

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}