---
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`

## Request

- Base URL: `https://api-ext-sboxmeta.partners.spotnana.com`
- URL: `https://api-ext-sboxmeta.partners.spotnana.com/v3/companies/{companyId}/cost-centers/list`
- Auth: HTTP bearer

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.dev/spotnana/apis/company-api.md) - [All operations](https://skmtc.dev/spotnana/apis/company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spotnana/apis/company-api/revisions/184a1b415751?raw)