Edara API v3: Cost Centers
Read the guide first: authentication, paging, errors, rate limits and the shared PagedResult, BatchResult and *Reference shapes.
GET /v3/cost-centers: Lists cost centers.GET /v3/cost-centers/{id}: Gets a cost center by id.
Endpoints
GET /v3/cost-centers: Lists cost centers.
Operation GetCostCenters · permission read:cost-center
Query string: GetCostCentersQuery
| field | type | default | validation | description |
|---|---|---|---|---|
offset |
int? |
0 | >= 0 | Number of items to skip before returning results. Defaults to 0. |
limit |
int? |
100 | 1..1000 (out of range → 400) | Maximum number of items to return. Defaults to 100, maximum 1000. |
Responses: OK PagedResult<CostCenterResponse>: Paged list of cost centers.
Notes
- The list only includes cost centers the calling user has data permission for.
- Inactive cost centers are included, and both parent and leaf cost centers are returned.
- Results are ordered by classification code.
totalCountis the number of cost centers you are permitted to see, but it is 0 when the page is empty, including whenoffsetis past the end.
GET /v3/cost-centers/{id}: Gets a cost center by id.
Operation GetCostCenterById · permission read:cost-center
Parameters
| name | in | type | default | description |
|---|---|---|---|---|
id |
route | int |
The cost center id. |
Responses: OK CostCenterResponse: The cost center.
Notes
- A cost center the calling user has no data permission for returns
404, the same as an id that does not exist. - Inactive cost centers are returned.
Types
CostCenterResponse
Response describing a cost center.
| field | type | description |
|---|---|---|
id |
int |
The cost center identifier. |
code |
string |
The cost center code. |
description |
string |
The cost center description. |
classificationCode |
string |
The classification code. |