Charge Auth Tokens

Retrieve list of charge auth tokens.

GET

https://partner-api.monta.com

/api/v1/charge-auth-tokens

Required scope: charge-auth-tokens:read
Organization authorization: supported

Retrieve list of charge auth tokens. › query Parameters

teamId

integer · int64

Filter to retrieve charges auth tokens with specified teamId

partnerExternalId

string

Filter charge auth tokens by partnerExternalId, to filter only resources without partnerExternalId use partnerExternalId=""

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

Retrieve list of charge auth tokens. › Responses

List of charge auth tokens that match the criteria

OffsetBasedResponse_5

ChargeAuthToken[] · required

MontaPage.Meta · required

GET/api/v1/charge-auth-tokens

curl https://partner-api.monta.com/api/v1/charge-auth-tokens \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "identifier": "38C58DB85F4",
      "type": "vehicleId",
      "teamId": 13,
      "userId": 1,
      "vehicleId": 1,
      "partnerExternalId": "ACME-12345",
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "name": "Monta Team Key",
      "operator": {
        "id": 14,
        "name": "Monta",
        "identifier": "monta",
        "partnerId": 1,
        "vatNumber": "FOO-123-ABC"
      },
      "montaNetwork": true,
      "roamingNetwork": true,
      "operatorNetwork": true,
      "activeUntil": "2023-01-11T00:00:00Z",
      "blockedAt": "2023-01-11T00:00:00Z",
      "createdAt": "2022-05-12T15:56:45.99Z",
      "updatedAt": "2022-05-12T16:56:45.99Z",
      "deleted": false,
      "rollingSpendLimit": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "dailyChargeCountLimit": 10,
      "concurrentChargesLimit": 2
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Create a new charge auth token

POST

https://partner-api.monta.com

/api/v1/charge-auth-tokens

Required scope: charge-auth-tokens:write
Organization authorization: supported

Create a new charge auth token › Request Body

CreateChargeAuthToken

teamId

integer · int64 · required

Id of the team the charge auth token belongs

Example: 42

identifier

string · minLength: 1 · pattern: ^(?!VID:)[\s\S]* · required

Identifier of the the charge auth token, Note: without prefix e.g VID:

Example: 38C58DB85F4

type

string · enum · required

Type of the charge auth token

Enum values:

rfid

vehicleId

Example: vehicleId

userId

integer | null · int64

Id of the user the charge auth token should be associated to

Example: 1

vehicleId

integer | null · int64

Id of the vehicle to link to this charge auth token

Example: 1

name

string | null

Name of the charge auth token

Example: Monta Office Charge Key

montaNetwork

boolean

If the charge auth token should be active in the Monta network

Example: true

Default: true

roamingNetwork

boolean

If the charge auth token should be active in the Roaming network

Example: true

Default: true

operatorNetwork

boolean | null

Indicates that the charge auth token can be used on other teams charge points underthe same operator

Example: true

Default: true

activeUntil

string | null · date-time

Indicates until when this charge auth token should be active, null means indefinitely

Example: 2023-01-11T00:00:00Z

blockedAt

string | null · date-time

If the charge auth token is blocked, it will not be able to charge.

null = not blocked
date-time = blocked since date-time

Example: 2023-01-11T00:00:00Z

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys. The payload is limited to 1000 characters.

Example: {"internalId":"ACME-12345","department":"Fleet"}

Create a new charge auth token › Responses

Charge Auth Token Created

ChargeAuthToken

identifier

string · required

The identifier of the charge auth token, Note: without prefix e.g VID:

Example: 38C58DB85F4

type

string · enum · required

The method type used for this charge auth token

Enum values:

vehicleId

rfid

Example: vehicleId

createdAt

string · date-time · required

Creation date of this charge auth token

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

updatedAt

string · date-time · required

Update date of this charge auth token

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

id

integer · int64

The id of the charge auth token

Example: 1

teamId

integer · int64

Id of the team that the charge auth token belongs to

Example: 13

userId

integer | null · int64

Id of the user that the charge auth token is associated to

Example: 1

vehicleId

integer | null · int64

Id of the vehicle linked to this charge auth token

Example: 1

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

name

string | null

Name of the charge auth token

Example: Monta Team Key

object

Operator of this charge auth token

montaNetwork

boolean

If the charge auth token is active in the Monta network

Example: true

roamingNetwork

boolean

If the charge auth token is active in the Roaming network

Example: true

operatorNetwork

boolean

Allow this charge auth token to be used on other teams charge points under the same operator

Example: true

activeUntil

string | null · date-time

Indicates until when this charge auth token is active, null means indefinitely

Example: 2023-01-11T00:00:00Z

blockedAt

string | null · date-time

If the charge auth token is blocked, it will not be able to charge.

null = not blocked
date-time = blocked since date-time

Example: 2023-01-11T00:00:00Z

deleted

boolean

If the charge auth token is deleted

Example: false

object

Maximum cumulative spend allowed on this charge auth token over a rolling 30-day window. null means no limit is set. Limits are currently always in EUR. The write side of this field takes a plain decimal amount in the same currency.

dailyChargeCountLimit

integer | null · int32

Maximum number of charges this charge auth token may start in a rolling 24-hour window. null means no limit is set.

Example: 10

concurrentChargesLimit

integer | null · int32

Maximum number of concurrent active charges this charge auth token may have. null means no limit is set.

Example: 2

POST/api/v1/charge-auth-tokens

curl https://partner-api.monta.com/api/v1/charge-auth-tokens \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "teamId": 42,
  "userId": 1,
  "vehicleId": 1,
  "identifier": "38C58DB85F4",
  "type": "vehicleId",
  "name": "Monta Office Charge Key",
  "montaNetwork": true,
  "roamingNetwork": true,
  "operatorNetwork": true,
  "activeUntil": "2023-01-11T00:00:00Z",
  "blockedAt": "2023-01-11T00:00:00Z",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  }
}'

Example Request Body

{
  "teamId": 42,
  "userId": 1,
  "vehicleId": 1,
  "identifier": "38C58DB85F4",
  "type": "vehicleId",
  "name": "Monta Office Charge Key",
  "montaNetwork": true,
  "roamingNetwork": true,
  "operatorNetwork": true,
  "activeUntil": "2023-01-11T00:00:00Z",
  "blockedAt": "2023-01-11T00:00:00Z",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  }
}

json

Example Responses

{
  "id": 1,
  "identifier": "38C58DB85F4",
  "type": "vehicleId",
  "teamId": 13,
  "userId": 1,
  "vehicleId": 1,
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "name": "Monta Team Key",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "montaNetwork": true,
  "roamingNetwork": true,
  "operatorNetwork": true,
  "activeUntil": "2023-01-11T00:00:00Z",
  "blockedAt": "2023-01-11T00:00:00Z",
  "createdAt": "2022-05-12T15:56:45.99Z",
  "updatedAt": "2022-05-12T16:56:45.99Z",
  "deleted": false,
  "rollingSpendLimit": {
    "amount": 12312,
    "currency": {
      "id": 1,
      "master": true,
      "identifier": "DKK",
      "name": "Danish krone",
      "decimals": 2
    },
    "locale": "en"
  },
  "dailyChargeCountLimit": 10,
  "concurrentChargesLimit": 2
}

json

application/json

List operator charge auth token inventory

GET

https://partner-api.monta.com

/api/v1/charge-auth-tokens/inventory

Required scope: charge-key-inventory:read
Organization authorization: supported

📘 Feature flag required — Charge auth token inventory is not available by default. It must be explicitly enabled for your operator account upon request. Please contact your Monta Business Partner to request access to this feature.

List operator charge auth token inventory › query Parameters

status

string · enum

Filter by lifecycle status (available, claimed, blocked)

Enum values:

available

claimed

blocked

printedIdentifier

string

Filter by the exact value printed on the card

identifier

string

Filter by exact card UID

includeDeleted

boolean

Includes deleted resources in the response

Default: false

page

integer · int32

Default: 0

perPage

integer · int32

Default: 10

List operator charge auth token inventory › Responses

List of inventory entries that match the criteria

OffsetBasedResponse_6

ChargeAuthTokenInventory[] · required

MontaPage.Meta · required

GET/api/v1/charge-auth-tokens/inventory

curl https://partner-api.monta.com/api/v1/charge-auth-tokens/inventory \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": 1024,
      "identifier": "38C58DB85F4A21",
      "printedIdentifier": "TEST-4471-B",
      "status": "available",
      "chargeAuthTokenId": 5567,
      "claimedByTeamId": 42,
      "claimedAt": "2024-08-25T15:00:00Z",
      "blockedAt": "2024-08-25T15:00:00Z",
      "createdAt": "2024-08-25T15:00:00Z",
      "updatedAt": "2024-08-25T15:00:00Z",
      "deletedAt": "2024-08-25T15:00:00Z"
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Bulk-load card UIDs into operator inventory

POST

https://partner-api.monta.com

/api/v1/charge-auth-tokens/inventory/bulk

Required scope: charge-key-inventory:write
Organization authorization: supported

Loads card UIDs as available stock. Each identifier is validated and inserted independently; already-loaded identifiers are reported in errors while new ones are still created.

Bulk-load card UIDs into operator inventory › Request Body

ChargeAuthTokenInventoryBulkLoad

ChargeAuthTokenInventoryBulkLoadItem[] · minItems: 1 · maxItems: 1000 · required

Cards to load as available stock. Each entry is either a bare UID string or an object carrying the UID and the value printed on the card. Each is validated independently; malformed or already-loaded entries are reported in errors while valid new ones are still created.

Bulk-load card UIDs into operator inventory › Responses

All identifiers loaded

No data returned

Retrieve a charge auth token inventory entry

GET

https://partner-api.monta.com

/api/v1/charge-auth-tokens/inventory/{inventoryId}

Required scope: charge-key-inventory:read
Organization authorization: supported

Removed entries are returned too, with deletedAt set.

Retrieve a charge auth token inventory entry › path Parameters

inventoryId

integer · int64 · required

Retrieve a charge auth token inventory entry › Responses

Inventory entry with provided id

An operator-owned charge auth token stock entry.

ChargeAuthTokenInventory

identifier

string · required

The card UID.

Example: 38C58DB85F4A21

status

string · required

Lifecycle status.

Example: available

id

integer · int64

Inventory entry id.

Example: 1024

printedIdentifier

string | null

Human readable value printed on the physical card. Used to look the card up when the UID cannot be scanned. Not used for charge authorisation.

Example: TEST-4471-B

chargeAuthTokenId

integer | null · int64

Id of the charge auth token created when the card was claimed, otherwise null.

Example: 5567

claimedByTeamId

integer | null · int64

Team the card was claimed by, otherwise null.

Example: 42

claimedAt

string | null · date-time

When the card was claimed, otherwise null.

blockedAt

string | null · date-time

When the card was blocked, otherwise null.

createdAt

string | null · date-time

When the entry was created.

updatedAt

string | null · date-time

When the entry was last updated.

deletedAt

string | null · date-time

When the entry was removed

Remove a stock entry from the inventory

DELETE

https://partner-api.monta.com

/api/v1/charge-auth-tokens/inventory/{inventoryId}

Required scope: charge-key-inventory:delete
Organization authorization: supported

Removes an unclaimed stock entry. Returns 409 if the entry has already been claimed. The entry stays readable by id, with deletedAt set.

Remove a stock entry from the inventory › path Parameters

inventoryId

integer · int64 · required

Remove a stock entry from the inventory › Responses

Inventory entry removed

No data returned

Block (recall) a stock card

POST

https://partner-api.monta.com

/api/v1/charge-auth-tokens/inventory/{inventoryId}/block

Required scope: charge-key-inventory:write
Organization authorization: supported

Block (recall) a stock card › path Parameters

inventoryId

integer · int64 · required

Block (recall) a stock card › Responses

Inventory entry blocked

An operator-owned charge auth token stock entry.

ChargeAuthTokenInventory

identifier

string · required

The card UID.

Example: 38C58DB85F4A21

status

string · required

Lifecycle status.

Example: available

id

integer · int64

Inventory entry id.

Example: 1024

printedIdentifier

string | null

Human readable value printed on the physical card. Used to look the card up when the UID cannot be scanned. Not used for charge authorisation.

Example: TEST-4471-B

chargeAuthTokenId

integer | null · int64

Id of the charge auth token created when the card was claimed, otherwise null.

Example: 5567

claimedByTeamId

integer | null · int64

Team the card was claimed by, otherwise null.

Example: 42

claimedAt

string | null · date-time

When the card was claimed, otherwise null.

blockedAt

string | null · date-time

When the card was blocked, otherwise null.

createdAt

string | null · date-time

When the entry was created.

updatedAt

string | null · date-time

When the entry was last updated.

deletedAt

string | null · date-time

When the entry was removed

Unblock a stock card

POST

https://partner-api.monta.com

/api/v1/charge-auth-tokens/inventory/{inventoryId}/unblock

Required scope: charge-key-inventory:write
Organization authorization: supported

Unblock a stock card › path Parameters

inventoryId

integer · int64 · required

Unblock a stock card › Responses

Inventory entry returned to available stock

An operator-owned charge auth token stock entry.

ChargeAuthTokenInventory

identifier

string · required

The card UID.

Example: 38C58DB85F4A21

status

string · required

Lifecycle status.

Example: available

id

integer · int64

Inventory entry id.

Example: 1024

printedIdentifier

string | null

Human readable value printed on the physical card. Used to look the card up when the UID cannot be scanned. Not used for charge authorisation.

Example: TEST-4471-B

chargeAuthTokenId

integer | null · int64

Id of the charge auth token created when the card was claimed, otherwise null.

Example: 5567

claimedByTeamId

integer | null · int64

Team the card was claimed by, otherwise null.

Example: 42

claimedAt

string | null · date-time

When the card was claimed, otherwise null.

blockedAt

string | null · date-time

When the card was blocked, otherwise null.

createdAt

string | null · date-time

When the entry was created.

updatedAt

string | null · date-time

When the entry was last updated.

deletedAt

string | null · date-time

When the entry was removed

Search charge auth tokens with cursor-based pagination.

GET

https://partner-api.monta.com

/api/v1/charge-auth-tokens/search

Required scope: charge-auth-tokens:read
Organization authorization: supported

Use this endpoint for high-volume fleets where offset pagination is prohibitive. Filters are intersected with the caller's operator and team scope; ids outside the consumer's scope are rejected with 403.

Search charge auth tokens with cursor-based pagination. › query Parameters

operatorIds

string

Restrict results to these operator ids (comma-separated). Caller must have access to every id supplied.

teamIds

string

Restrict results to these team ids (comma-separated). Caller must have access to every id supplied.

userIds

string

Restrict results to charge auth tokens owned by these users (comma-separated).

search

string

Free-text search on identifier and name.

blocked

boolean

Filter by blocked status.

includeSubOperators

boolean

Include sub-operators when filtering by operator. Defaults to true when operatorIds is omitted, false otherwise.

size

integer · int32

Maximum number of items per page (1-100, default 10).

Default: 10

sort

string

Sort expression, e.g. name,ASC or created_at,DESC. Default name,ASC.

after

string

Cursor for the next page. Use meta.after from the previous response.

before

string

Cursor for the previous page. Ignored when after is also provided.

Search charge auth tokens with cursor-based pagination. › Responses

Cursor-paginated list of charge auth tokens matching the criteria

CursorBasedResponse_3

ChargeAuthToken[] · required

CursorBasedPageMeta · required

GET/api/v1/charge-auth-tokens/search

curl https://partner-api.monta.com/api/v1/charge-auth-tokens/search \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "identifier": "38C58DB85F4",
      "type": "vehicleId",
      "teamId": 13,
      "userId": 1,
      "vehicleId": 1,
      "partnerExternalId": "ACME-12345",
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "name": "Monta Team Key",
      "operator": {
        "id": 14,
        "name": "Monta",
        "identifier": "monta",
        "partnerId": 1,
        "vatNumber": "FOO-123-ABC"
      },
      "montaNetwork": true,
      "roamingNetwork": true,
      "operatorNetwork": true,
      "activeUntil": "2023-01-11T00:00:00Z",
      "blockedAt": "2023-01-11T00:00:00Z",
      "createdAt": "2022-05-12T15:56:45.99Z",
      "updatedAt": "2022-05-12T16:56:45.99Z",
      "deleted": false,
      "rollingSpendLimit": {
        "amount": 12312,
        "currency": {
          "id": 1,
          "master": true,
          "identifier": "DKK",
          "name": "Danish krone",
          "decimals": 2
        },
        "locale": "en"
      },
      "dailyChargeCountLimit": 10,
      "concurrentChargesLimit": 2
    }
  ],
  "meta": {
    "itemCount": 10,
    "perPage": 50,
    "after": "1290",
    "before": "1200"
  }
}

json

application/json

Retrieve a charge auth token.

GET

https://partner-api.monta.com

/api/v1/charge-auth-tokens/{chargeAuthTokenId}

Required scope: charge-auth-tokens:read
Organization authorization: supported

Retrieve a charge auth token. › path Parameters

chargeAuthTokenId

integer · int64 · required

Retrieve a charge auth token. › Responses

Charge Auth Token with provided id

ChargeAuthToken

identifier

string · required

The identifier of the charge auth token, Note: without prefix e.g VID:

Example: 38C58DB85F4

type

string · enum · required

The method type used for this charge auth token

Enum values:

vehicleId

rfid

Example: vehicleId

createdAt

string · date-time · required

Creation date of this charge auth token

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

updatedAt

string · date-time · required

Update date of this charge auth token

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

id

integer · int64

The id of the charge auth token

Example: 1

teamId

integer · int64

Id of the team that the charge auth token belongs to

Example: 13

userId

integer | null · int64

Id of the user that the charge auth token is associated to

Example: 1

vehicleId

integer | null · int64

Id of the vehicle linked to this charge auth token

Example: 1

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

name

string | null

Name of the charge auth token

Example: Monta Team Key

object

Operator of this charge auth token

montaNetwork

boolean

If the charge auth token is active in the Monta network

Example: true

roamingNetwork

boolean

If the charge auth token is active in the Roaming network

Example: true

operatorNetwork

boolean

Allow this charge auth token to be used on other teams charge points under the same operator

Example: true

activeUntil

string | null · date-time

Indicates until when this charge auth token is active, null means indefinitely

Example: 2023-01-11T00:00:00Z

blockedAt

string | null · date-time

If the charge auth token is blocked, it will not be able to charge.

null = not blocked
date-time = blocked since date-time

Example: 2023-01-11T00:00:00Z

deleted

boolean

If the charge auth token is deleted

Example: false

object

dailyChargeCountLimit

integer | null · int32

Maximum number of charges this charge auth token may start in a rolling 24-hour window. null means no limit is set.

Example: 10

concurrentChargesLimit

integer | null · int32

Maximum number of concurrent active charges this charge auth token may have. null means no limit is set.

Example: 2

GET/api/v1/charge-auth-tokens/{chargeAuthTokenId}

curl https://partner-api.monta.com/api/v1/charge-auth-tokens/:chargeAuthTokenId \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": 1,
  "identifier": "38C58DB85F4",
  "type": "vehicleId",
  "teamId": 13,
  "userId": 1,
  "vehicleId": 1,
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "name": "Monta Team Key",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "montaNetwork": true,
  "roamingNetwork": true,
  "operatorNetwork": true,
  "activeUntil": "2023-01-11T00:00:00Z",
  "blockedAt": "2023-01-11T00:00:00Z",
  "createdAt": "2022-05-12T15:56:45.99Z",
  "updatedAt": "2022-05-12T16:56:45.99Z",
  "deleted": false,
  "rollingSpendLimit": {
    "amount": 12312,
    "currency": {
      "id": 1,
      "master": true,
      "identifier": "DKK",
      "name": "Danish krone",
      "decimals": 2
    },
    "locale": "en"
  },
  "dailyChargeCountLimit": 10,
  "concurrentChargesLimit": 2
}

json

application/json

Patch an existing charge auth token

PATCH

https://partner-api.monta.com

/api/v1/charge-auth-tokens/{chargeAuthTokenId}

Required scope: charge-auth-tokens:write
Organization authorization: supported

Patch an existing charge auth token › path Parameters

chargeAuthTokenId

integer · int64 · required

Patch an existing charge auth token › Request Body

PatchChargeAuthToken

teamId

integer | null · int64

Id of the team the charge auth token belongs to

Example: 42

userId

integer | null · int64

Id of the user the charge auth token should be associated to

Example: 1

vehicleId

integer | null · int64

Id of the vehicle to link to this charge auth token

Example: 1

name

string | null

Name of the charge auth token

Example: Monta Office Charge Key

montaNetwork

boolean | null

If the charge auth token should be active in the Monta network

Example: true

Default: true

roamingNetwork

boolean | null

If the charge auth token should be active in the Roaming network

Example: true

Default: true

operatorNetwork

boolean | null

Indicates that the charge auth token can be used on other teams charge points underthe same operator

Example: true

Default: true

activeUntil

string | null · date-time

Indicates until when this charge auth token is active, null means indefinitely. Note: Use ../block and ../unblock endpoints to (un)block a charge auth token.

Example: 2023-01-11T00:00:00Z

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys. The payload is limited to 1000 characters.

Example: {"internalId":"ACME-12345","department":"Fleet"}

costCenterId

integer | null · int64

Id of the cost center to assign to the charge auth token. Send null to clear the assignment; omit the field to leave it unchanged.

Example: 42

rollingSpendLimit

number | null

Maximum cumulative spend allowed on this charge auth token over a rolling 30-day window, as a plain decimal amount in the currency of rollingSpendLimit on read (currently always EUR). Omit the field to leave it unchanged. Must be strictly positive, and may not exceed the cap that applies to the owning operator — a request above the cap is rejected. Send null to remove the limit; this is only accepted when no cap applies, otherwise null is rejected and a value up to the cap is required.

Example: 500

dailyChargeCountLimit

integer | null · int32

Maximum number of charges this charge auth token may start in a rolling 24-hour window. Omit the field to leave it unchanged. Must be strictly positive, and may not exceed the cap that applies to the owning operator. Send null to remove the limit; this is only accepted when no cap applies, otherwise null is rejected and a value up to the cap is required.

Example: 10

concurrentChargesLimit

integer | null · int32

Maximum number of concurrent active charges this charge auth token may have. Omit the field to leave it unchanged. Must be strictly positive, and may not exceed the cap that applies to the owning operator. Send null to remove the limit; this is only accepted when no cap applies, otherwise null is rejected and a value up to the cap is required.

Example: 2

Patch an existing charge auth token › Responses

Charge auth token updated

ChargeAuthToken

identifier

string · required

The identifier of the charge auth token, Note: without prefix e.g VID:

Example: 38C58DB85F4

type

string · enum · required

The method type used for this charge auth token

Enum values:

vehicleId

rfid

Example: vehicleId

createdAt

string · date-time · required

Creation date of this charge auth token

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

updatedAt

string · date-time · required

Update date of this charge auth token

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

id

integer · int64

The id of the charge auth token

Example: 1

teamId

integer · int64

Id of the team that the charge auth token belongs to

Example: 13

userId

integer | null · int64

Id of the user that the charge auth token is associated to

Example: 1

vehicleId

integer | null · int64

Id of the vehicle linked to this charge auth token

Example: 1

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

name

string | null

Name of the charge auth token

Example: Monta Team Key

object

Operator of this charge auth token

montaNetwork

boolean

If the charge auth token is active in the Monta network

Example: true

roamingNetwork

boolean

If the charge auth token is active in the Roaming network

Example: true

operatorNetwork

boolean

Allow this charge auth token to be used on other teams charge points under the same operator

Example: true

activeUntil

string | null · date-time

Indicates until when this charge auth token is active, null means indefinitely

Example: 2023-01-11T00:00:00Z

blockedAt

string | null · date-time

If the charge auth token is blocked, it will not be able to charge.

null = not blocked
date-time = blocked since date-time

Example: 2023-01-11T00:00:00Z

deleted

boolean

If the charge auth token is deleted

Example: false

object

dailyChargeCountLimit

integer | null · int32

Maximum number of charges this charge auth token may start in a rolling 24-hour window. null means no limit is set.

Example: 10

concurrentChargesLimit

integer | null · int32

Maximum number of concurrent active charges this charge auth token may have. null means no limit is set.

Example: 2

PATCH/api/v1/charge-auth-tokens/{chargeAuthTokenId}

curl https://partner-api.monta.com/api/v1/charge-auth-tokens/:chargeAuthTokenId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "teamId": 42,
  "userId": 1,
  "vehicleId": 1,
  "name": "Monta Office Charge Key",
  "montaNetwork": true,
  "roamingNetwork": true,
  "operatorNetwork": true,
  "activeUntil": "2023-01-11T00:00:00Z",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "costCenterId": 42,
  "rollingSpendLimit": 500,
  "dailyChargeCountLimit": 10,
  "concurrentChargesLimit": 2
}'

Example Request Body

{
  "teamId": 42,
  "userId": 1,
  "vehicleId": 1,
  "name": "Monta Office Charge Key",
  "montaNetwork": true,
  "roamingNetwork": true,
  "operatorNetwork": true,
  "activeUntil": "2023-01-11T00:00:00Z",
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "costCenterId": 42,
  "rollingSpendLimit": 500,
  "dailyChargeCountLimit": 10,
  "concurrentChargesLimit": 2
}

json

Example Responses

{
  "id": 1,
  "identifier": "38C58DB85F4",
  "type": "vehicleId",
  "teamId": 13,
  "userId": 1,
  "vehicleId": 1,
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "name": "Monta Team Key",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "montaNetwork": true,
  "roamingNetwork": true,
  "operatorNetwork": true,
  "activeUntil": "2023-01-11T00:00:00Z",
  "blockedAt": "2023-01-11T00:00:00Z",
  "createdAt": "2022-05-12T15:56:45.99Z",
  "updatedAt": "2022-05-12T16:56:45.99Z",
  "deleted": false,
  "rollingSpendLimit": {
    "amount": 12312,
    "currency": {
      "id": 1,
      "master": true,
      "identifier": "DKK",
      "name": "Danish krone",
      "decimals": 2
    },
    "locale": "en"
  },
  "dailyChargeCountLimit": 10,
  "concurrentChargesLimit": 2
}

json

application/json

Deletes a charge auth token.

DELETE

https://partner-api.monta.com

/api/v1/charge-auth-tokens/{chargeAuthTokenId}

Required scope: charge-auth-tokens:delete
Organization authorization: supported

Deletes a charge auth token. › path Parameters

chargeAuthTokenId

integer · int64 · required

Deletes a charge auth token. › Responses

Deleted charge auth token successfully

No data returned

Block a charge auth token

POST

https://partner-api.monta.com

/api/v1/charge-auth-tokens/{chargeAuthTokenId}/block

Required scope: charge-auth-tokens:write
Organization authorization: supported

Block a charge auth token › path Parameters

chargeAuthTokenId

integer · int64 · required

Block a charge auth token › Responses

Charge auth token blocked

ChargeAuthToken

identifier

string · required

The identifier of the charge auth token, Note: without prefix e.g VID:

Example: 38C58DB85F4

type

string · enum · required

The method type used for this charge auth token

Enum values:

vehicleId

rfid

Example: vehicleId

createdAt

string · date-time · required

Creation date of this charge auth token

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

updatedAt

string · date-time · required

Update date of this charge auth token

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

id

integer · int64

The id of the charge auth token

Example: 1

teamId

integer · int64

Id of the team that the charge auth token belongs to

Example: 13

userId

integer | null · int64

Id of the user that the charge auth token is associated to

Example: 1

vehicleId

integer | null · int64

Id of the vehicle linked to this charge auth token

Example: 1

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

name

string | null

Name of the charge auth token

Example: Monta Team Key

object

Operator of this charge auth token

montaNetwork

boolean

If the charge auth token is active in the Monta network

Example: true

roamingNetwork

boolean

If the charge auth token is active in the Roaming network

Example: true

operatorNetwork

boolean

Allow this charge auth token to be used on other teams charge points under the same operator

Example: true

activeUntil

string | null · date-time

Indicates until when this charge auth token is active, null means indefinitely

Example: 2023-01-11T00:00:00Z

blockedAt

string | null · date-time

If the charge auth token is blocked, it will not be able to charge.

null = not blocked
date-time = blocked since date-time

Example: 2023-01-11T00:00:00Z

deleted

boolean

If the charge auth token is deleted

Example: false

object

dailyChargeCountLimit

integer | null · int32

Maximum number of charges this charge auth token may start in a rolling 24-hour window. null means no limit is set.

Example: 10

concurrentChargesLimit

integer | null · int32

Maximum number of concurrent active charges this charge auth token may have. null means no limit is set.

Example: 2

POST/api/v1/charge-auth-tokens/{chargeAuthTokenId}/block

curl https://partner-api.monta.com/api/v1/charge-auth-tokens/:chargeAuthTokenId/block \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": 1,
  "identifier": "38C58DB85F4",
  "type": "vehicleId",
  "teamId": 13,
  "userId": 1,
  "vehicleId": 1,
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "name": "Monta Team Key",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "montaNetwork": true,
  "roamingNetwork": true,
  "operatorNetwork": true,
  "activeUntil": "2023-01-11T00:00:00Z",
  "blockedAt": "2023-01-11T00:00:00Z",
  "createdAt": "2022-05-12T15:56:45.99Z",
  "updatedAt": "2022-05-12T16:56:45.99Z",
  "deleted": false,
  "rollingSpendLimit": {
    "amount": 12312,
    "currency": {
      "id": 1,
      "master": true,
      "identifier": "DKK",
      "name": "Danish krone",
      "decimals": 2
    },
    "locale": "en"
  },
  "dailyChargeCountLimit": 10,
  "concurrentChargesLimit": 2
}

json

application/json

Unblock a charge auth token

POST

https://partner-api.monta.com

/api/v1/charge-auth-tokens/{chargeAuthTokenId}/unblock

Required scope: charge-auth-tokens:write
Organization authorization: supported

Unblock a charge auth token › path Parameters

chargeAuthTokenId

integer · int64 · required

Unblock a charge auth token › Responses

Charge auth token unblocked

ChargeAuthToken

identifier

string · required

The identifier of the charge auth token, Note: without prefix e.g VID:

Example: 38C58DB85F4

type

string · enum · required

The method type used for this charge auth token

Enum values:

vehicleId

rfid

Example: vehicleId

createdAt

string · date-time · required

Creation date of this charge auth token

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

updatedAt

string · date-time · required

Update date of this charge auth token

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

id

integer · int64

The id of the charge auth token

Example: 1

teamId

integer · int64

Id of the team that the charge auth token belongs to

Example: 13

userId

integer | null · int64

Id of the user that the charge auth token is associated to

Example: 1

vehicleId

integer | null · int64

Id of the vehicle linked to this charge auth token

Example: 1

partnerExternalId

string | null

External Id of this entity, managed by you.

Example: ACME-12345

object | null

Custom JSON payload for this entity, managed by you.
Note: the expected shape is a flat JSON object with named keys.

Example: {"internalId":"ACME-12345","department":"Fleet"}

name

string | null

Name of the charge auth token

Example: Monta Team Key

object

Operator of this charge auth token

montaNetwork

boolean

If the charge auth token is active in the Monta network

Example: true

roamingNetwork

boolean

If the charge auth token is active in the Roaming network

Example: true

operatorNetwork

boolean

Allow this charge auth token to be used on other teams charge points under the same operator

Example: true

activeUntil

string | null · date-time

Indicates until when this charge auth token is active, null means indefinitely

Example: 2023-01-11T00:00:00Z

blockedAt

string | null · date-time

If the charge auth token is blocked, it will not be able to charge.

null = not blocked
date-time = blocked since date-time

Example: 2023-01-11T00:00:00Z

deleted

boolean

If the charge auth token is deleted

Example: false

object

dailyChargeCountLimit

integer | null · int32

Maximum number of charges this charge auth token may start in a rolling 24-hour window. null means no limit is set.

Example: 10

concurrentChargesLimit

integer | null · int32

Maximum number of concurrent active charges this charge auth token may have. null means no limit is set.

Example: 2

POST/api/v1/charge-auth-tokens/{chargeAuthTokenId}/unblock

curl https://partner-api.monta.com/api/v1/charge-auth-tokens/:chargeAuthTokenId/unblock \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": 1,
  "identifier": "38C58DB85F4",
  "type": "vehicleId",
  "teamId": 13,
  "userId": 1,
  "vehicleId": 1,
  "partnerExternalId": "ACME-12345",
  "partnerCustomPayload": {
    "internalId": "ACME-12345",
    "department": "Fleet"
  },
  "name": "Monta Team Key",
  "operator": {
    "id": 14,
    "name": "Monta",
    "identifier": "monta",
    "partnerId": 1,
    "vatNumber": "FOO-123-ABC"
  },
  "montaNetwork": true,
  "roamingNetwork": true,
  "operatorNetwork": true,
  "activeUntil": "2023-01-11T00:00:00Z",
  "blockedAt": "2023-01-11T00:00:00Z",
  "createdAt": "2022-05-12T15:56:45.99Z",
  "updatedAt": "2022-05-12T16:56:45.99Z",
  "deleted": false,
  "rollingSpendLimit": {
    "amount": 12312,
    "currency": {
      "id": 1,
      "master": true,
      "identifier": "DKK",
      "name": "Danish krone",
      "decimals": 2
    },
    "locale": "en"
  },
  "dailyChargeCountLimit": 10,
  "concurrentChargesLimit": 2
}

json

application/json

CDRs Charge Key Limit Caps