---
title: "List cost centers"
method: POST
path: "/v3/companies/{companyId}/cost-centers/list"
tags: ["Cost Centers"]
---

# List cost centers

`POST /v3/companies/{companyId}/cost-centers/list`

This endpoint lists cost centers of a company.

## Request body

- ListCostCentersRequest — Request body for list cost centers API.
  - `searchText` string — Search string entered by the user
  - `paginationParams` OffsetBasedPaginationRequestParams, required — Pagination parameters for requests.
    - `offset` integer — The starting index in the list from which results are returned. The value must be greater than or equal to 0.
    - `limit` integer — Maximum number of results to be fetched.
  - `filters` ListCostCentersFilter[] — List of filters. Cost centers matching with any filter would be returned.
    - `externalIds` string[] — List of external ids.
    - `costCenterIds` string[] — List of cost center ids.

## Response `200`

OK

- ListCostCentersResponse — Response for list cost centers API.
  - `paginationParams` OffsetBasedPaginationResponseParams, required — Pagination parameters for response.
    - `totalNumResults` integer, required — Total number of results.
  - `costCenters` CostCenterInfo[] — List of cost centers containing id and name.
    - `id` string, uuid, required
    - `name` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — The specified resource was not found.

---

[API](https://skmtc.net/spotnana/apis/company-api.md) · [All operations](https://skmtc.net/spotnana/apis/company-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spotnana/company-api/revisions/36b1305ad44a/schema)