---
title: "Retrieve a list of cost centers"
method: GET
path: "/api/v1/cost-centers"
tags: ["Cost Centers"]
---

# Retrieve a list of cost centers

`GET /api/v1/cost-centers`

## Request

- Base URL: `https://partner-api.monta.com`
- URL: `https://partner-api.monta.com/api/v1/cost-centers`
- Auth: HTTP bearer

Required scope: `cost-centers:read` </br>Organization authorization: `supported`

## Query parameters

- `page` integer
- `perPage` integer
- `teamId` integer, nullable: Allows to filter the list of cost centers by a team id.
- `includeDeleted` boolean: Filter to include deleted cost centers in the response

## Response `200`

List of cost centers that match the criteria

- OffsetBasedResponse16
  - `data` CostCenter[], required
    - `id` integer: Id of this cost center
    - `operatorId` integer: Id of the operator this cost center belongs to
    - `teamId` integer, nullable: Id of the team this cost center belongs to. Null when the cost center is operator-scoped.
    - `name` string, required: Name of the cost center
    - `externalId` string, required: External Id of this cost center, managed by you.
    - `description` string, nullable: Description of the cost center
    - `createdAt` string, date-time, required: Creation date of this cost center
    - `updatedAt` string, date-time, required: Date this cost center was last updated
    - `teamsCount` integer, nullable: Number of teams assigned to this cost center. Only returned when retrieving a single cost center.
    - `teamMembersCount` integer, nullable: Number of team members assigned to this cost center. Only returned when retrieving a single cost center.
    - `teamMemberProfilesCount` integer, nullable: Number of team member profiles assigned to this cost center. Only returned when retrieving a single cost center.
    - `vehiclesCount` integer, nullable: Number of vehicles assigned to this cost center. Only returned when retrieving a single cost center.
    - `chargeKeysCount` integer, nullable: Number of charge keys assigned to this cost center. Only returned when retrieving a single cost center.
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400`: The request is invalid
- `401`: Consumer with provided credentials was not found
- `403`: Operator doesn't have access to resource
- `404`: Entity with the provided id was not found

## Changes

- **2026-11-03** `0ca400461c52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monta/apis/monta-partner-api/changes/api/v1/cost-centers/get.md)

---

[API](https://skmtc.dev/monta/apis/monta-partner-api.md) - [All operations](https://skmtc.dev/monta/apis/monta-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monta/apis/monta-partner-api/revisions/0ca400461c52?raw)