Cost Centres

A Cost Centre is used to report against different parts of your organisation.

Name Type Path
GetCostCentres GET /api/CostCentre]
Get a list of cost centres with a search filter.
GetCostCentre GET /api/CostCentre/{costCentreRef}
Get a cost centre.
CreateCostCentre POST /api/CostCentre
Create a cost centre
LockCostCentre POST /api/CostCentre/{costCentreRef}/lock
Lock the cost centre
UnlockCostCentre POST /api/CostCentre/{costCentreRef}/unlock
Unlock the cost centre
UpdateCostCentre PATCH /api/CostCentre/{costCentreRef}
Update a cost centre

Searching existing cost centres

Existing cost centres can be searched using GET /api/costcentre.

Note this is a paginated response, and will return by default up to 100 results. Use the skip and take query parameters to get next pages: GET /api/costcentre?skip=300&take=100

See reference for supported search criteria: GET /api/costcentre

Loading additional details:

A cost centre can be retrieved by its id or code:

  • GET /api/costcentre/26c18ab0-691e-47d3-6773-08dbffbe216b
  • GET /api/costcentre/CC100

Additional details can be included:

  • resources
  • subCostCentres: child cost centres

The details can be loaded with the include parameter:

  • GET /api/costcentre/CC100?include=resources,subCostcentres

This is the minimal example to create a cost centre:

POST /api/costcentre

{
    "code": "CC100",
    "description": "CostCentre100"
}

Complete example:

This is a complete example that contains all supported fields.

Note the codes might vary in your environment so be sure to consult the available reference catalogs in iplicit or via the catalogs endpoints

POST /api/costcentre

{
    "code": "CC100",
    "description": "CostCentre100",
    "legacyRef": "CC1",
    "legalEntityId": "LEGEA",
    "parentCostCentreId": "CC000"
}

See reference for supported create criteria: POST /api/costcentre


Updated September 2025