Cost Centers

Retrieve a list of cost centers

GET

https://partner-api.monta.com

/api/v1/cost-centers

Required scope: cost-centers:read
Organization authorization: supported

Retrieve a list of cost centers › query Parameters

page

integer · int32

page number to retrieve (starts with 0)

Default: 0

perPage

integer · int32

number of items per page (between 1 and 100, default 10)

Default: 10

teamId

integer | null · int64

Allows to filter the list of cost centers by a team id.

Example: 10

includeDeleted

boolean

Filter to include deleted cost centers in the response

Example: false

Retrieve a list of cost centers › Responses

List of cost centers that match the criteria

OffsetBasedResponse_16

CostCenter[] · required

MontaPage.Meta · required

GET/api/v1/cost-centers

curl https://partner-api.monta.com/api/v1/cost-centers \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "operatorId": 1,
      "teamId": 10,
      "name": "Sales department",
      "externalId": "ACME-12345",
      "description": "Costs attributed to the sales department",
      "createdAt": "2022-05-12T15:56:45.99Z",
      "updatedAt": "2022-05-12T16:56:45.99Z",
      "teamsCount": 3,
      "teamMembersCount": 12,
      "teamMemberProfilesCount": 4,
      "vehiclesCount": 7,
      "chargeKeysCount": 9
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Create a cost center

POST

https://partner-api.monta.com

/api/v1/cost-centers

Creates a cost center for a given operator, optionally scoped to a team.

Required scope: cost-centers:write
Organization authorization: supported

Create a cost center › Request Body

CreateCostCenter

name

string · minLength: 1 · required

Name of the cost center.

Example: Sales department

externalId

string · minLength: 1 · required

External Id of this cost center, managed by you.

Example: ACME-12345

teamId

integer | null · int64

Id of the team this cost center belongs to. When omitted, the cost center is operator-scoped.

Example: 10

description

string | null

Description of the cost center.

Example: Costs attributed to the sales department

Create a cost center › Responses

Cost center created

CostCenter

name

string · required

Name of the cost center

Example: Sales department

externalId

string · required

External Id of this cost center, managed by you.

Example: ACME-12345

createdAt

string · date-time · required

Creation date of this cost center

Example: 2022-05-12T15:56:45.99Z

updatedAt

string · date-time · required

Date this cost center was last updated

Example: 2022-05-12T16:56:45.99Z

id

integer · int64

Id of this cost center

Example: 1

operatorId

integer · int64

Id of the operator this cost center belongs to

Example: 1

teamId

integer | null · int64

Id of the team this cost center belongs to. Null when the cost center is operator-scoped.

Example: 10

description

string | null

Description of the cost center

Example: Costs attributed to the sales department

teamsCount

integer | null · int64

Number of teams assigned to this cost center. Only returned when retrieving a single cost center.

Example: 3

teamMembersCount

integer | null · int64

Number of team members assigned to this cost center. Only returned when retrieving a single cost center.

Example: 12

teamMemberProfilesCount

integer | null · int64

Number of team member profiles assigned to this cost center. Only returned when retrieving a single cost center.

Example: 4

vehiclesCount

integer | null · int64

Number of vehicles assigned to this cost center. Only returned when retrieving a single cost center.

Example: 7

chargeKeysCount

integer | null · int64

Number of charge keys assigned to this cost center. Only returned when retrieving a single cost center.

Example: 9

POST/api/v1/cost-centers

curl https://partner-api.monta.com/api/v1/cost-centers \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "teamId": 10,
  "name": "Sales department",
  "externalId": "ACME-12345",
  "description": "Costs attributed to the sales department"
}'

Example Request Body

{
  "teamId": 10,
  "name": "Sales department",
  "externalId": "ACME-12345",
  "description": "Costs attributed to the sales department"
}

json

Example Responses

{
  "id": 1,
  "operatorId": 1,
  "teamId": 10,
  "name": "Sales department",
  "externalId": "ACME-12345",
  "description": "Costs attributed to the sales department",
  "createdAt": "2022-05-12T15:56:45.99Z",
  "updatedAt": "2022-05-12T16:56:45.99Z",
  "teamsCount": 3,
  "teamMembersCount": 12,
  "teamMemberProfilesCount": 4,
  "vehiclesCount": 7,
  "chargeKeysCount": 9
}

json

application/json

Retrieve a single cost center

GET

https://partner-api.monta.com

/api/v1/cost-centers/{costCenterId}

Returns a single cost center, including its usage counts.

Required scope: cost-centers:read
Organization authorization: supported

Retrieve a single cost center › path Parameters

costCenterId

integer · int64 · required

Retrieve a single cost center › Responses

Cost center with provided id

CostCenter

name

string · required

Name of the cost center

Example: Sales department

externalId

string · required

External Id of this cost center, managed by you.

Example: ACME-12345

createdAt

string · date-time · required

Creation date of this cost center

Example: 2022-05-12T15:56:45.99Z

updatedAt

string · date-time · required

Date this cost center was last updated

Example: 2022-05-12T16:56:45.99Z

id

integer · int64

Id of this cost center

Example: 1

operatorId

integer · int64

Id of the operator this cost center belongs to

Example: 1

teamId

integer | null · int64

Id of the team this cost center belongs to. Null when the cost center is operator-scoped.

Example: 10

description

string | null

Description of the cost center

Example: Costs attributed to the sales department

teamsCount

integer | null · int64

Number of teams assigned to this cost center. Only returned when retrieving a single cost center.

Example: 3

teamMembersCount

integer | null · int64

Number of team members assigned to this cost center. Only returned when retrieving a single cost center.

Example: 12

teamMemberProfilesCount

integer | null · int64

Number of team member profiles assigned to this cost center. Only returned when retrieving a single cost center.

Example: 4

vehiclesCount

integer | null · int64

Number of vehicles assigned to this cost center. Only returned when retrieving a single cost center.

Example: 7

chargeKeysCount

integer | null · int64

Number of charge keys assigned to this cost center. Only returned when retrieving a single cost center.

Example: 9

Update a cost center

PATCH

https://partner-api.monta.com

/api/v1/cost-centers/{costCenterId}

Required scope: cost-centers:write
Organization authorization: supported

Update a cost center › path Parameters

costCenterId

integer · int64 · required

Update a cost center › Request Body

PatchCostCenter

name

string | null

Name of the cost center.

Example: Sales department

externalId

string | null

External Id of this cost center, managed by you.

Example: ACME-12345

description

string | null

Description of the cost center.

Example: Costs attributed to the sales department

Update a cost center › Responses

Updated cost center with provided id

CostCenter

name

string · required

Name of the cost center

Example: Sales department

externalId

string · required

External Id of this cost center, managed by you.

Example: ACME-12345

createdAt

string · date-time · required

Creation date of this cost center

Example: 2022-05-12T15:56:45.99Z

updatedAt

string · date-time · required

Date this cost center was last updated

Example: 2022-05-12T16:56:45.99Z

id

integer · int64

Id of this cost center

Example: 1

operatorId

integer · int64

Id of the operator this cost center belongs to

Example: 1

teamId

integer | null · int64

Id of the team this cost center belongs to. Null when the cost center is operator-scoped.

Example: 10

description

string | null

Description of the cost center

Example: Costs attributed to the sales department

teamsCount

integer | null · int64

Number of teams assigned to this cost center. Only returned when retrieving a single cost center.

Example: 3

teamMembersCount

integer | null · int64

Number of team members assigned to this cost center. Only returned when retrieving a single cost center.

Example: 12

teamMemberProfilesCount

integer | null · int64

Number of team member profiles assigned to this cost center. Only returned when retrieving a single cost center.

Example: 4

vehiclesCount

integer | null · int64

Number of vehicles assigned to this cost center. Only returned when retrieving a single cost center.

Example: 7

chargeKeysCount

integer | null · int64

Number of charge keys assigned to this cost center. Only returned when retrieving a single cost center.

Example: 9

PATCH/api/v1/cost-centers/{costCenterId}

curl https://partner-api.monta.com/api/v1/cost-centers/:costCenterId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "Sales department",
  "externalId": "ACME-12345",
  "description": "Costs attributed to the sales department"
}'

Example Request Body

{
  "name": "Sales department",
  "externalId": "ACME-12345",
  "description": "Costs attributed to the sales department"
}

json

Example Responses

{
  "id": 1,
  "operatorId": 1,
  "teamId": 10,
  "name": "Sales department",
  "externalId": "ACME-12345",
  "description": "Costs attributed to the sales department",
  "createdAt": "2022-05-12T15:56:45.99Z",
  "updatedAt": "2022-05-12T16:56:45.99Z",
  "teamsCount": 3,
  "teamMembersCount": 12,
  "teamMemberProfilesCount": 4,
  "vehiclesCount": 7,
  "chargeKeysCount": 9
}

json

application/json

Delete an existing cost center

DELETE

https://partner-api.monta.com

/api/v1/cost-centers/{costCenterId}

Deletes a cost center. Fails with 409 Conflict when the cost center is still in use.

Required scope: cost-centers:delete
Organization authorization: supported

Delete an existing cost center › path Parameters

costCenterId

integer · int64 · required

Delete an existing cost center › Responses

Cost center deleted

No data returned

Consumer Countries