Client / Client Cost Centres

Get a list of client cost centres

This method requires the ClientCostCentres:Get permission to be associated with your role.

GET

/fm/client-cost-centres

curl --request GET \
  --url 'https://api.catch-e.com/fm/client-cost-centres?client_id=%3Cstring%3E&description=%3Cstring%3E&include_inactive_flag=no&fields=%3Cstring%3E&page=1&page_size=25' \
  --header 'Authorization: <api-key>'

{
  "_embedded": {
    "fm_client_cost_centres": [
      {
        "address1": "<string>",
        "address2": "<string>",
        "area": "<string>",
        "client_cost_centre_id": "<string>",
        "client_id": "<string>",
        "contact_email": "<string>",
        "contact_job_title": "<string>",
        "contact_name": "<string>",
        "contact_note": "<string>",
        "contact_phone": "<string>",
        "description": "<string>",
        "no_of_ftes": "<string>",
        "postcode": "<string>",
        "site_visits": "<string>",
        "state": "<string>",
        "status_flag": "<string>",
        "user_id_cost_centre_manager": "<string>"
      }
    ]
  },
  "_links": {
    "self": {
      "href": "https://api.catch-e.com/fm/client-cost-centres"
    }
  },
  "page": 1,
  "page_count": 1,
  "page_size": 25,
  "total_items": 1
}

Authorizations

Authorizationstringheaderrequired

For accessing the API a valid token must be passed in all the queries in the 'Authorization' header.

A valid token is generated by the API and returned by the /authenticate method by supplying a valid username and password.

The following syntax must be used in the 'Authorization' header :

Bearer aaaaaa/bbbbbb.ccccccc.dddddd

Query Parameters

client_idstringqueryrequired

descriptionstringquery

This field supports the wildcard % operator.

include_inactive_flagenum<string>querydefault:no

Set to yes if inactive Client Cost Centres required in the list. Note 'deleted' records cannot be returned.

Available options: yes, no

fieldsstring[]query

Define fields required. If no fields are specified, then all fields are returned.

pageintegerquerydefault:1

Required range: -1 <= x <= 2147483647

page_sizeintegerquerydefault:25

Required range: -1 <= x <= 2147483647

Response

Success

_embeddedobject

Show child attributes

_linksobject

pageinteger

Example: 1

page_countinteger

Example: 1

page_sizeinteger

Example: 25

total_itemsinteger

Example: 1

Still need help? Ask the team