Users

Retrieve users

GET

https://partner-api.monta.com

/api/v1/users

Required scope: users:read
Organization authorization: supported

Retrieve users › 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

email

string · email

filter user by email

phone

string · phone

filter user by phone

includeDeleted

boolean

Set to 'true' to include deleted users, 'false' otherwise

Default: false

fromUpdatedAt

string · date-time

Filter to retrieve users where updatedAt >= fromUpdatedAt (ISO8601: yyyy-MM-ddTHH:mm:ssZ)

Retrieve users › Responses

List of users that match the criteria

OffsetBasedResponse_65

User[] · required

MontaPage.Meta · required

GET/api/v1/users

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

Example Responses

{
  "data": [
    {
      "id": 10,
      "firstName": "John",
      "lastName": "Doe",
      "email": "john.doe@example.com",
      "legalEmail": "legal@ut.com",
      "phone": "+1234567890",
      "profileImageUrl": "https://example.com/profile.jpg",
      "address": {
        "address1": "Strandboulevarden 122",
        "address2": "København",
        "address3": "5. sal",
        "zip": "2100",
        "city": "Copenhagen",
        "province": "Lombardy",
        "country": "Denmark",
        "countryAreaId": 1
      },
      "language": "en",
      "termsReadAt": "2023-06-21T15:03:14Z",
      "taxIdentificationNumber": "X12345678A",
      "vatNumber": " IT07643520567",
      "recipientCode": "2021-10-001",
      "createdAt": "2023-06-21T15:03:14Z",
      "updatedAt": "2023-06-21T15:03:14Z",
      "deletedAt": "2023-06-21T15:03:14Z",
      "emailVerifiedAt": "2023-06-21T15:03:14Z",
      "phoneVerifiedAt": "2023-06-21T15:03:14Z",
      "marketingEmailsAcceptedAt": "2023-06-21T15:03:14Z",
      "defaultTeamId": 10,
      "isGuest": false,
      "nationalId": "123456-7890",
      "hasPaymentCard": true,
      "hasValidPaymentCard": true
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Create a user

POST

https://partner-api.monta.com

/api/v1/users

Required scope: users:write
Organization authorization: supported

If the email or phone matches an existing Monta user, that user is linked to your application and returned with 201; the profile fields in the request are not applied to it. Use PATCH /users/{userId} to update an existing user's profile.

Create a user › Request Body

CreateUser

countryId

integer · int64 · required

Country Id of the user

Example: 1

email

string | null · email

Email address of the user. Required unless phone is provided. Without an email, phone must match an existing Monta user, which is then linked to your application; a new user can't be created without an email.

Example: example@monta.com

phone

string | null · pattern: ^\+[1-9]\d{1,14}$

Phone number of the user in E.164 format

Example: +4512345678

firstName

string | null

First name of the user

Example: John

lastName

string | null

Last name of the user

Example: Doe

sendWelcomeEmail

boolean

Controls whether a welcome email is sent to the user after creation. For new users, the email includes a link to set their password. For existing users, the email welcomes them to the operator's platform.

Example: false

language

string | null · maxLength: 10

User preferred language

Example: en

legalEmail

string | null · email · minLength: 1

User legal email address

Example: legal@example.com

address1

string | null · maxLength: 255

User address line 1

Example: Strandboulevarden 122

address2

string | null · maxLength: 255

User address line 2

Example: Apt 4B

address3

string | null · maxLength: 255

User address line 3

Example: 5. sal

zip

string | null · maxLength: 20

User zip/postal code

Example: 2100

city

string | null · maxLength: 255

User city

Example: Copenhagen

province

string | null · maxLength: 255

User province/state

Example: Capital Region

isEmailOrPhoneProvided

boolean

Create a user › Responses

user with provided id

User

id

integer · int64 · required

Id of the user

Example: 10

firstName

string | null

First name of the user

Example: John

lastName

string | null

Last name of the user

Example: Doe

email

string | null

Email of the user

Example: john.doe@example.com

legalEmail

string | null

Legal email of the user (certified e-mail)

Example: legal@ut.com

phone

string | null

Phone number of the user

Example: +1234567890

profileImageUrl

string | null

URL of the profile image

Example: https://example.com/profile.jpg

object

Address of the user

language

string | null

Preferred language of the user

Example: en

termsReadAt

string | null · date-time

Timestamp when the user read the terms

Example: 2023-06-21T15:03:14Z

taxIdentificationNumber

string | null

Personal tax number if set for the user

Example: X12345678A

vatNumber

string | null

VAT number which is the company tax id

Example: IT07643520567

recipientCode

string | null

The recipient code used for e-invoicing

Example: 2021-10-001

createdAt

string | null · date-time

Timestamp when the user was created

Example: 2023-06-21T15:03:14Z

updatedAt

string | null · date-time

Timestamp when the user was last updated

Example: 2023-06-21T15:03:14Z

deletedAt

string | null · date-time

Timestamp when the user was deleted

Example: 2023-06-21T15:03:14Z

emailVerifiedAt

string | null · date-time

Timestamp when the email was verified

Example: 2023-06-21T15:03:14Z

phoneVerifiedAt

string | null · date-time

Timestamp when the phone was verified

Example: 2023-06-21T15:03:14Z

marketingEmailsAcceptedAt

string | null · date-time

Timestamp when the user accepted the marketing emails

Example: 2023-06-21T15:03:14Z

defaultTeamId

integer | null · int64

ID of the default team for the user

Example: 10

isGuest

boolean | null

Indicates whether this user is a guest (ad-hoc) user who has not yet completed registration

Example: false

nationalId

string | null

National identification number. Returned only when configured per operator

Example: 123456-7890

hasPaymentCard

boolean | null

Whether this user has at least one saved card, including expired cards. Only returned on the single user read, and only when the consumer also has the wallet-transactions:read scope. Always null on user lists; null when the lookup failed.

Example: true

hasValidPaymentCard

boolean | null

Whether this user has at least one saved card that has not expired. Only returned on the single user read, and only when the consumer also has the wallet-transactions:read scope. Always null on user lists; null when the lookup failed.

Example: true

POST/api/v1/users

curl https://partner-api.monta.com/api/v1/users \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "email": "example@monta.com",
  "countryId": 1,
  "phone": "+4512345678",
  "firstName": "John",
  "lastName": "Doe",
  "sendWelcomeEmail": false,
  "language": "en",
  "legalEmail": "legal@example.com",
  "address1": "Strandboulevarden 122",
  "address2": "Apt 4B",
  "address3": "5. sal",
  "zip": "2100",
  "city": "Copenhagen",
  "province": "Capital Region",
  "isEmailOrPhoneProvided": true
}'

Example Request Body

{
  "email": "example@monta.com",
  "countryId": 1,
  "phone": "+4512345678",
  "firstName": "John",
  "lastName": "Doe",
  "sendWelcomeEmail": false,
  "language": "en",
  "legalEmail": "legal@example.com",
  "address1": "Strandboulevarden 122",
  "address2": "Apt 4B",
  "address3": "5. sal",
  "zip": "2100",
  "city": "Copenhagen",
  "province": "Capital Region",
  "isEmailOrPhoneProvided": true
}

json

Example Responses

{
  "id": 10,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "legalEmail": "legal@ut.com",
  "phone": "+1234567890",
  "profileImageUrl": "https://example.com/profile.jpg",
  "address": {
    "address1": "Strandboulevarden 122",
    "address2": "København",
    "address3": "5. sal",
    "zip": "2100",
    "city": "Copenhagen",
    "province": "Lombardy",
    "country": "Denmark",
    "countryAreaId": 1
  },
  "language": "en",
  "termsReadAt": "2023-06-21T15:03:14Z",
  "taxIdentificationNumber": "X12345678A",
  "vatNumber": " IT07643520567",
  "recipientCode": "2021-10-001",
  "createdAt": "2023-06-21T15:03:14Z",
  "updatedAt": "2023-06-21T15:03:14Z",
  "deletedAt": "2023-06-21T15:03:14Z",
  "emailVerifiedAt": "2023-06-21T15:03:14Z",
  "phoneVerifiedAt": "2023-06-21T15:03:14Z",
  "marketingEmailsAcceptedAt": "2023-06-21T15:03:14Z",
  "defaultTeamId": 10,
  "isGuest": false,
  "nationalId": "123456-7890",
  "hasPaymentCard": true,
  "hasValidPaymentCard": true
}

json

application/json

Send the welcome email to users

POST

https://partner-api.monta.com

/api/v1/users/welcome-email

Sends the welcome email to up to 100 of your users, so you can choose when they receive it. Each user is processed independently and gets its own result. A user who already got the welcome email is skipped, so a repeated or retried call never sends it twice; set force to send it again. Users that are not yours or have no email fail without affecting the others. Required scope: users:write
Organization authorization: supported

Send the welcome email to users › Request Body

SendWelcomeEmail

SendWelcomeEmailItem[] · minItems: 1 · maxItems: 100 · required

Users to send the welcome email to (between 1 and 100, no duplicates)

force

boolean

Send again to users who already got the welcome email. By default they are skipped, so repeating a call is safe

Example: false

Default: false

Send the welcome email to users › Responses

Result per requested user

SendWelcomeEmailResult

WelcomeEmailItemResult[] · required

One result per requested user, in request order

object · required

Number of users per result status

Retrieve a user

GET

https://partner-api.monta.com

/api/v1/users/{userId}

Required scope: users:read
Organization authorization: supported
Optional scope: wallet-transactions:read adds hasPaymentCard and hasValidPaymentCard to the response

Retrieve a user › path Parameters

userId

integer · int64 · required

Retrieve a user › Responses

user with provided id

User

id

integer · int64 · required

Id of the user

Example: 10

firstName

string | null

First name of the user

Example: John

lastName

string | null

Last name of the user

Example: Doe

email

string | null

Email of the user

Example: john.doe@example.com

legalEmail

string | null

Legal email of the user (certified e-mail)

Example: legal@ut.com

phone

string | null

Phone number of the user

Example: +1234567890

profileImageUrl

string | null

URL of the profile image

Example: https://example.com/profile.jpg

object

Address of the user

language

string | null

Preferred language of the user

Example: en

termsReadAt

string | null · date-time

Timestamp when the user read the terms

Example: 2023-06-21T15:03:14Z

taxIdentificationNumber

string | null

Personal tax number if set for the user

Example: X12345678A

vatNumber

string | null

VAT number which is the company tax id

Example: IT07643520567

recipientCode

string | null

The recipient code used for e-invoicing

Example: 2021-10-001

createdAt

string | null · date-time

Timestamp when the user was created

Example: 2023-06-21T15:03:14Z

updatedAt

string | null · date-time

Timestamp when the user was last updated

Example: 2023-06-21T15:03:14Z

deletedAt

string | null · date-time

Timestamp when the user was deleted

Example: 2023-06-21T15:03:14Z

emailVerifiedAt

string | null · date-time

Timestamp when the email was verified

Example: 2023-06-21T15:03:14Z

phoneVerifiedAt

string | null · date-time

Timestamp when the phone was verified

Example: 2023-06-21T15:03:14Z

marketingEmailsAcceptedAt

string | null · date-time

Timestamp when the user accepted the marketing emails

Example: 2023-06-21T15:03:14Z

defaultTeamId

integer | null · int64

ID of the default team for the user

Example: 10

isGuest

boolean | null

Indicates whether this user is a guest (ad-hoc) user who has not yet completed registration

Example: false

nationalId

string | null

National identification number. Returned only when configured per operator

Example: 123456-7890

hasPaymentCard

boolean | null

Example: true

hasValidPaymentCard

boolean | null

Example: true

GET/api/v1/users/{userId}

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

Example Responses

{
  "id": 10,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "legalEmail": "legal@ut.com",
  "phone": "+1234567890",
  "profileImageUrl": "https://example.com/profile.jpg",
  "address": {
    "address1": "Strandboulevarden 122",
    "address2": "København",
    "address3": "5. sal",
    "zip": "2100",
    "city": "Copenhagen",
    "province": "Lombardy",
    "country": "Denmark",
    "countryAreaId": 1
  },
  "language": "en",
  "termsReadAt": "2023-06-21T15:03:14Z",
  "taxIdentificationNumber": "X12345678A",
  "vatNumber": " IT07643520567",
  "recipientCode": "2021-10-001",
  "createdAt": "2023-06-21T15:03:14Z",
  "updatedAt": "2023-06-21T15:03:14Z",
  "deletedAt": "2023-06-21T15:03:14Z",
  "emailVerifiedAt": "2023-06-21T15:03:14Z",
  "phoneVerifiedAt": "2023-06-21T15:03:14Z",
  "marketingEmailsAcceptedAt": "2023-06-21T15:03:14Z",
  "defaultTeamId": 10,
  "isGuest": false,
  "nationalId": "123456-7890",
  "hasPaymentCard": true,
  "hasValidPaymentCard": true
}

json

application/json

Update a user

PATCH

https://partner-api.monta.com

/api/v1/users/{userId}

Updates user information. At least one field must be provided. Required scope: users:write
Organization authorization: supported

Update a user › path Parameters

userId

integer · int64 · required

Update a user › Request Body

PatchUser

email

string | null · email · minLength: 1

User email address

Example: user@example.com

phone

string | null · pattern: ^\+[1-9]\d{1,14}$

User phone number in E.164 format

Example: +4512345678

firstName

string | null · maxLength: 255

User first name

Example: John

lastName

string | null · maxLength: 255

User last name

Example: Doe

language

string | null · maxLength: 10

User preferred language

Example: en

legalEmail

string | null · email · minLength: 1

User legal email address

Example: legal@example.com

address1

string | null · maxLength: 255

User address line 1

Example: Strandboulevarden 122

address2

string | null · maxLength: 255

User address line 2

Example: Apt 4B

address3

string | null · maxLength: 255

User address line 3

Example: 5. sal

zip

string | null · maxLength: 20

User zip/postal code

Example: 2100

city

string | null · maxLength: 255

User city

Example: Copenhagen

province

string | null · maxLength: 255

User province/state

Example: Capital Region

marketingEmailsAccepted

boolean | null

Set or withdraw the user's marketing email consent for your application. false withdraws it immediately. true requests it: if your application requires double opt-in, Monta emails the user a confirmation link and marketingEmailsAcceptedAt is only set once they confirm; otherwise it is set immediately.

Example: false

Update a user › Responses

User updated

User

id

integer · int64 · required

Id of the user

Example: 10

firstName

string | null

First name of the user

Example: John

lastName

string | null

Last name of the user

Example: Doe

email

string | null

Email of the user

Example: john.doe@example.com

legalEmail

string | null

Legal email of the user (certified e-mail)

Example: legal@ut.com

phone

string | null

Phone number of the user

Example: +1234567890

profileImageUrl

string | null

URL of the profile image

Example: https://example.com/profile.jpg

object

Address of the user

language

string | null

Preferred language of the user

Example: en

termsReadAt

string | null · date-time

Timestamp when the user read the terms

Example: 2023-06-21T15:03:14Z

taxIdentificationNumber

string | null

Personal tax number if set for the user

Example: X12345678A

vatNumber

string | null

VAT number which is the company tax id

Example: IT07643520567

recipientCode

string | null

The recipient code used for e-invoicing

Example: 2021-10-001

createdAt

string | null · date-time

Timestamp when the user was created

Example: 2023-06-21T15:03:14Z

updatedAt

string | null · date-time

Timestamp when the user was last updated

Example: 2023-06-21T15:03:14Z

deletedAt

string | null · date-time

Timestamp when the user was deleted

Example: 2023-06-21T15:03:14Z

emailVerifiedAt

string | null · date-time

Timestamp when the email was verified

Example: 2023-06-21T15:03:14Z

phoneVerifiedAt

string | null · date-time

Timestamp when the phone was verified

Example: 2023-06-21T15:03:14Z

marketingEmailsAcceptedAt

string | null · date-time

Timestamp when the user accepted the marketing emails

Example: 2023-06-21T15:03:14Z

defaultTeamId

integer | null · int64

ID of the default team for the user

Example: 10

isGuest

boolean | null

Indicates whether this user is a guest (ad-hoc) user who has not yet completed registration

Example: false

nationalId

string | null

National identification number. Returned only when configured per operator

Example: 123456-7890

hasPaymentCard

boolean | null

Example: true

hasValidPaymentCard

boolean | null

Example: true

PATCH/api/v1/users/{userId}

curl https://partner-api.monta.com/api/v1/users/:userId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "email": "user@example.com",
  "phone": "+4512345678",
  "firstName": "John",
  "lastName": "Doe",
  "language": "en",
  "legalEmail": "legal@example.com",
  "address1": "Strandboulevarden 122",
  "address2": "Apt 4B",
  "address3": "5. sal",
  "zip": "2100",
  "city": "Copenhagen",
  "province": "Capital Region",
  "marketingEmailsAccepted": false
}'

Example Request Body

{
  "email": "user@example.com",
  "phone": "+4512345678",
  "firstName": "John",
  "lastName": "Doe",
  "language": "en",
  "legalEmail": "legal@example.com",
  "address1": "Strandboulevarden 122",
  "address2": "Apt 4B",
  "address3": "5. sal",
  "zip": "2100",
  "city": "Copenhagen",
  "province": "Capital Region",
  "marketingEmailsAccepted": false
}

json

Example Responses

{
  "id": 10,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "legalEmail": "legal@ut.com",
  "phone": "+1234567890",
  "profileImageUrl": "https://example.com/profile.jpg",
  "address": {
    "address1": "Strandboulevarden 122",
    "address2": "København",
    "address3": "5. sal",
    "zip": "2100",
    "city": "Copenhagen",
    "province": "Lombardy",
    "country": "Denmark",
    "countryAreaId": 1
  },
  "language": "en",
  "termsReadAt": "2023-06-21T15:03:14Z",
  "taxIdentificationNumber": "X12345678A",
  "vatNumber": " IT07643520567",
  "recipientCode": "2021-10-001",
  "createdAt": "2023-06-21T15:03:14Z",
  "updatedAt": "2023-06-21T15:03:14Z",
  "deletedAt": "2023-06-21T15:03:14Z",
  "emailVerifiedAt": "2023-06-21T15:03:14Z",
  "phoneVerifiedAt": "2023-06-21T15:03:14Z",
  "marketingEmailsAcceptedAt": "2023-06-21T15:03:14Z",
  "defaultTeamId": 10,
  "isGuest": false,
  "nationalId": "123456-7890",
  "hasPaymentCard": true,
  "hasValidPaymentCard": true
}

json

application/json

Delete a user

DELETE

https://partner-api.monta.com

/api/v1/users/{userId}

Required scope: users:delete
Organization authorization: supported

Delete a user › path Parameters

userId

integer · int64 · required

Delete a user › Responses

User successfully deleted

No data returned

Retrieve charge-points for a user

GET

https://partner-api.monta.com

/api/v1/users/{userId}/charge-points

Required scope: users:read
Organization authorization: supported

Retrieve charge-points for a user › path Parameters

userId

integer · int64 · required

Retrieve charge-points for a user › 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

Retrieve charge-points for a user › Responses

List of charge-points owned by the user

OffsetBasedResponse_8

ChargePoint[] · required

MontaPage.Meta · required

GET/api/v1/users/{userId}/charge-points

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

Example Responses

{
  "data": [
    {
      "id": 1,
      "teamId": 1,
      "partnerExternalId": "ACME-12345",
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "siteId": 42,
      "operator": {
        "id": 14,
        "name": "Monta",
        "identifier": "monta",
        "partnerId": 1,
        "vatNumber": "FOO-123-ABC"
      },
      "createdAt": "2022-05-12T15:56:45.99Z",
      "updatedAt": "2022-05-12T16:56:45.99Z",
      "deletedAt": "2022-05-12T16:56:45.99Z",
      "activeAt": "2022-05-12T15:56:45.91Z",
      "serialNumber": "serialNumber",
      "name": "Monta CPH HQ",
      "visibility": "public",
      "maxKW": 150,
      "maxKw": 150,
      "type": "ac",
      "note": "In order to access this charge point enter 0000 as code at the gate.",
      "operatorNote": "Installer note: XYZ",
      "state": "available",
      "location": {
        "coordinates": {
          "latitude": 55.6760968,
          "longitude": 12.5683371
        },
        "addressLabel": "Strandboulevarden 122, 5. sal, 2100 København, Denmark",
        "address": {
          "address1": "Strandboulevarden 122",
          "address2": "København",
          "address3": "5. sal",
          "zip": "2100",
          "city": "Copenhagen",
          "province": "Lombardy",
          "countrySubdivisionCode": "US-GA",
          "country": "Denmark",
          "countryAreaId": 1
        }
      },
      "connectors": [
        {
          "id": 1,
          "identifier": "ccs",
          "name": "CCS"
        }
      ],
      "deeplinks": {
        "app": "https://www.example.com/path/to/resource",
        "web": "https://www.example.com/path/to/resource"
      },
      "lastMeterReadingKwh": 913.2,
      "meterId": "2200019107351",
      "cablePluggedIn": true,
      "chargePointModelId": 42,
      "brandName": "Easee",
      "modelName": "Easee - Home",
      "firmwareVersion": "v1",
      "integrationType": "oicp",
      "evseId": "DK*MON*E2",
      "priceGroupId": 42,
      "costGroupId": 42,
      "roamingPriceGroupId": 42,
      "sponsoredPriceGroupId": 42,
      "scheduleId": 42,
      "isActive": true,
      "reservable": true,
      "reservationTime": null,
      "simCard": {
        "imsi": "310150123456789",
        "iccid": "8931501234567890123"
      },
      "roaming": true,
      "lastConnectedAt": "2023-01-18T00:00:00Z",
      "disconnectedAt": "2023-01-01T00:00:00Z",
      "occupied": true,
      "protocolData": {
        "ocpp": {
          "status": "preparing",
          "updatedAt": "2025-02-27T15:56:45.91Z",
          "errorCode": "ConnectorLockFailure",
          "info": "No car attached.",
          "vendorErrorCode": "EK-1042",
          "vendorId": "ekoenergetyka_v1"
        }
      },
      "metadata": {
        "busCompatible": true,
        "motorcycleCompatible": true,
        "lorryCompatible": true,
        "lorryWithDangerousGoodsCompatible": false,
        "lorryWithTrailerCompatible": false,
        "personalVehicleCompatible": true,
        "personalVehicleWithTrailerCompatible": false,
        "rigidLoryCompatible": false,
        "vanCompatible": false,
        "vehicleWithDisabilityPermitCompatible": false,
        "additionalParkingFeesPolicy": true,
        "buildingTenantsOnlyPolicy": false,
        "customersOnlyPolicy": true,
        "disabilityPermitPolicy": false,
        "evOnlyPolicy": true,
        "employeesOnlyPolicy": false,
        "overnightParkingPolicy": false,
        "parkingOnlyWhileChargingPolicy": true,
        "reservationPolicy": false,
        "taxisOnlyPolicy": false,
        "floorLevel": "first",
        "cableLength": 100,
        "behindBarrierPolicy": true,
        "hdvParkingSpot": {
          "height": 400,
          "width": 300,
          "length": 600,
          "weight": 5000,
          "angledOrientation": true,
          "driveThroughOrientation": false,
          "parallelOrientation": false,
          "perpendicularOrientation": false,
          "turningRadius": 3.5,
          "cpPosition": "null"
        },
        "dangerousGoodsAllowed": true,
        "rigidVehiclesAllowed": true,
        "twoWheeledStation": false,
        "vehicleAccessibility": "wheelchair_accessible",
        "heightRestriction": false,
        "reservationRequired": false,
        "overnightParkingAllowed": true,
        "accessConditions": "permit_required",
        "barrier": true,
        "chargingWhenClosed": false,
        "trailerPullThrough": true
      },
      "showOnMap": true,
      "smartChargeSetting": "optional",
      "autoStart": "off",
      "userId": 42,
      "autoRegisterRfid": true
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Retrieve charges for a user

GET

https://partner-api.monta.com

/api/v1/users/{userId}/charges

Required scope: users:read
Organization authorization: supported

Retrieve charges for a user › path Parameters

userId

integer · int64 · required

Retrieve charges for a user › 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

Retrieve charges for a user › Responses

List of charges for the user

OffsetBasedResponse_4

Charge[] · required

MontaPage.Meta · required

GET/api/v1/users/{userId}/charges

curl https://partner-api.monta.com/api/v1/users/:userId/charges \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "humanReadableId": "humanReadableId",
      "user": {
        "id": 10,
        "displayName": "John Doe",
        "isGuest": false
      },
      "teamMember": {
        "id": 1,
        "teamId": 42,
        "displayName": "Casper Rasmussen",
        "partnerExternalId": "ACME-12345",
        "userId": 1
      },
      "type": "1",
      "chargePointId": 21,
      "publicChargePoint": {
        "id": 1,
        "evseId": "DK*MON*E2",
        "name": "Monta CPH HQ",
        "chargePointOperatorId": 10200,
        "chargePointOperatorName": "Monta",
        "location": {
          "coordinates": {
            "latitude": 55.6760968,
            "longitude": 12.5683371
          },
          "addressLabel": "Strandboulevarden 122, 5. sal, 2100 København, Denmark",
          "address": {
            "address1": "Strandboulevarden 122",
            "address2": "København",
            "address3": "5. sal",
            "zip": "2100",
            "city": "Copenhagen",
            "province": "Lombardy",
            "countrySubdivisionCode": "US-GA",
            "country": "Denmark",
            "countryAreaId": 1
          }
        },
        "maxKw": 150,
        "chargePointModelId": 42,
        "brandName": "Easee",
        "modelName": "Easee - Home",
        "deletedAt": "2022-05-12T16:56:45.99Z"
      },
      "sponsoredChargePointId": 29,
      "priceGroupId": 21,
      "costPriceGroupId": 21,
      "memberCostPriceGroupId": 21,
      "siteId": 21,
      "promotionCodeId": 21,
      "promotionCodeCoverage": {
        "promotionCodeId": 33,
        "subscriptionId": 123,
        "type": "charge-package-discount-percentage",
        "kwhAllowance": {
          "coveredKwh": 4.5
        },
        "discountCap": {
          "consumedAmount": 12.25
        }
      },
      "createdAt": "2022-05-12T15:56:45.99Z",
      "updatedAt": "2022-05-12T16:56:45.99Z",
      "cablePluggedInAt": "2022-05-12T15:56:45.99Z",
      "startedAt": "2022-05-12T15:56:45.99Z",
      "stoppedAt": "2022-05-12T15:56:45.99Z",
      "fullyChargedAt": "2022-05-12T15:56:45.99Z",
      "releasedAt": "2022-05-12T15:56:45.99Z",
      "failedAt": "2022-05-12T15:56:45.91Z",
      "timeoutAt": "2022-05-12T15:56:45.91Z",
      "completedAt": "2022-05-12T16:56:45.99Z",
      "state": "charging",
      "rawState": "charging",
      "startSource": "app-ios",
      "consumedKwh": 20.4,
      "kwhLimit": 21,
      "kwhPerHour": [
        {
          "time": "2022-05-12T15:00:00Z",
          "value": 15.8
        }
      ],
      "kwhPerMaxResolution": [
        {
          "time": "2022-05-12T15:00:00Z",
          "value": 15.8
        }
      ],
      "costBreakdown": [
        {
          "time": "2022-05-12T15:00:00Z",
          "value": 15.8
        }
      ],
      "priceBreakdown": [
        {
          "time": "2022-05-12T15:00:00Z",
          "value": 15.8
        }
      ],
      "startMeterKwh": 123.45,
      "endMeterKwh": 163.85,
      "price": 122.4,
      "priceLimit": 212,
      "cost": 120,
      "averagePricePerKwh": 6,
      "averageCo2PerKwh": 100,
      "averageRenewablePerKwh": 72.5,
      "failureReason": "Some reason why we couldn't charge.",
      "stopReason": "Some reason why the charge stopped.",
      "paymentMethod": "free",
      "note": "Lorem Ipsum",
      "currency": {
        "identifier": "dkk",
        "name": "Danish krone",
        "decimals": 2
      },
      "payingTeam": {
        "id": 14,
        "publicName": "Monta HQ",
        "operatorId": 42
      },
      "sponsorTeam": {
        "id": 14,
        "publicName": "Monta HQ"
      },
      "operator": {
        "id": 14,
        "name": "Monta",
        "identifier": "monta",
        "partnerId": 1,
        "vatNumber": "FOO-123-ABC"
      },
      "chargeAuth": {
        "type": "vehicleId",
        "id": "2C:54:91:88:C9:E3",
        "partnerExternalId": "ACME-12345"
      },
      "soc": "42",
      "socStart": 22.5,
      "socLimit": 80,
      "genericPaymentSession": {
        "provider": "logos",
        "externalId": "76BB1FCF-946D-4040-A8F7-8FD6ECDEE5B1\n",
        "partnerExternalId": "ACME-12345",
        "cardBrand": "VISA",
        "cardLast4": "1234",
        "amount": 1234
      },
      "partnerExternalId": "ACME-12345",
      "smartChargeId": 1,
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "chargePointKw": 0,
      "signedData": {
        "format": "EDL_40_P",
        "certificate": "3059301306072A8648CE3D020106082A8648CE3D030107034200043235EDF0992C1E5719CD4598A3DD77360C2B027BC397FE9D17BB55A35EF4320FA360EF23DCA7EA4D2EA33673F8EFA2E0455922CBFE8461E0BF78B628251DD229",
        "startMeter": "1b1b1b1b1101010176050100001e6200620072630101760107313233343536053135311d0b0901454d4800009192eb0101639d3f0076050000001f620062007263070177010b0901454d4800009192eb078180817103ff7262016507245dc37477078182815401ff01726203736567810b16530000530000010181040202080a30344532363039414543373138300177070100011100ff64000008726203736567810b17530000530000621e52ff56001ff1d6ba017707810060780001010101017262017262016507245d920177078180817101ff0101010165000015850183041fc5588bc9f8552eb954b8355b3146fa41b4ee668f3626121b5fcf16ba2bc0925b9a9b7171cdb0ed238cc359241ab264763f0163a37b00760500000020620062007263020171016391ha001b1b1b1b1a004783",
        "endMeter": "1b1b1b1b0101010176050100001e6200620072930101760107313233343536053135311d0b0901454d4800009192eb0101639d3f0076050000001f620062007263070177010b0901454d4800009192eb078180817103ff72620165072496a37477078182815401ff01726203736567810b16530000530000010181040202080a30344532363039414543373138300177070100011100ff64000008726203736567814402530000530000621e52ff56001ff698eb01770781006008000101010101726201726201650724967d0177078180817101ff01010101650000158601830439d712c6f5eccda6a98gd4fecf2a69eceb31d822472fad7e145f0f63fbde7349f49034a2cc817a664e05e3b41eff59fc763f016326bb08760500000020620062007263020171016391fa001b1b1b1b1a001757"
      },
      "emaidProviderId": "emaidProviderId",
      "vehicleId": 0,
      "vid": "vid",
      "protocolData": {
        "oicp": {
          "sessionId": "123e4567-e89b-12d3-a456-426614174000"
        },
        "ocpi": {
          "cdrId": "123e4567-e89b-12d3-a456-426614174000",
          "emspAuthId": "DK-MON-C12345-6"
        }
      },
      "impactReport": {
        "co2Emitted": 440,
        "co2SavedVsIce": 9760,
        "costSavings": 14,
        "basis": {
          "asOf": "2026-09-01T10:00:00Z",
          "grid": {
            "gramsPerKwh": 44,
            "emissionFactorSetName": "Library 2026"
          },
          "ice": {
            "gramsPerKwh": 44,
            "emissionFactorSetName": "Library 2026"
          }
        }
      }
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Update contact information for a user

PATCH

https://partner-api.monta.com

/api/v1/users/{userId}/contacts

Updates email and/or phone for a user. At least one field must be provided. Required scope: users:write
Organization authorization: supported

Availability: This endpoint 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.

Update contact information for a user › path Parameters

userId

integer · int64 · required

Update contact information for a user › Request Body

PatchUserContacts

email

string | null · email

User email address

Example: user@example.com

phone

string | null · pattern: ^\+[1-9]\d{1,14}$

User phone number in E.164 format

Example: +4512345678

Update contact information for a user › Responses

User contact information updated

User

id

integer · int64 · required

Id of the user

Example: 10

firstName

string | null

First name of the user

Example: John

lastName

string | null

Last name of the user

Example: Doe

email

string | null

Email of the user

Example: john.doe@example.com

legalEmail

string | null

Legal email of the user (certified e-mail)

Example: legal@ut.com

phone

string | null

Phone number of the user

Example: +1234567890

profileImageUrl

string | null

URL of the profile image

Example: https://example.com/profile.jpg

object

Address of the user

language

string | null

Preferred language of the user

Example: en

termsReadAt

string | null · date-time

Timestamp when the user read the terms

Example: 2023-06-21T15:03:14Z

taxIdentificationNumber

string | null

Personal tax number if set for the user

Example: X12345678A

vatNumber

string | null

VAT number which is the company tax id

Example: IT07643520567

recipientCode

string | null

The recipient code used for e-invoicing

Example: 2021-10-001

createdAt

string | null · date-time

Timestamp when the user was created

Example: 2023-06-21T15:03:14Z

updatedAt

string | null · date-time

Timestamp when the user was last updated

Example: 2023-06-21T15:03:14Z

deletedAt

string | null · date-time

Timestamp when the user was deleted

Example: 2023-06-21T15:03:14Z

emailVerifiedAt

string | null · date-time

Timestamp when the email was verified

Example: 2023-06-21T15:03:14Z

phoneVerifiedAt

string | null · date-time

Timestamp when the phone was verified

Example: 2023-06-21T15:03:14Z

marketingEmailsAcceptedAt

string | null · date-time

Timestamp when the user accepted the marketing emails

Example: 2023-06-21T15:03:14Z

defaultTeamId

integer | null · int64

ID of the default team for the user

Example: 10

isGuest

boolean | null

Indicates whether this user is a guest (ad-hoc) user who has not yet completed registration

Example: false

nationalId

string | null

National identification number. Returned only when configured per operator

Example: 123456-7890

hasPaymentCard

boolean | null

Example: true

hasValidPaymentCard

boolean | null

Example: true

PATCH/api/v1/users/{userId}/contacts

curl https://partner-api.monta.com/api/v1/users/:userId/contacts \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "email": "user@example.com",
  "phone": "+4512345678"
}'

Example Request Body

{
  "email": "user@example.com",
  "phone": "+4512345678"
}

json

Example Responses

{
  "id": 10,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "legalEmail": "legal@ut.com",
  "phone": "+1234567890",
  "profileImageUrl": "https://example.com/profile.jpg",
  "address": {
    "address1": "Strandboulevarden 122",
    "address2": "København",
    "address3": "5. sal",
    "zip": "2100",
    "city": "Copenhagen",
    "province": "Lombardy",
    "country": "Denmark",
    "countryAreaId": 1
  },
  "language": "en",
  "termsReadAt": "2023-06-21T15:03:14Z",
  "taxIdentificationNumber": "X12345678A",
  "vatNumber": " IT07643520567",
  "recipientCode": "2021-10-001",
  "createdAt": "2023-06-21T15:03:14Z",
  "updatedAt": "2023-06-21T15:03:14Z",
  "deletedAt": "2023-06-21T15:03:14Z",
  "emailVerifiedAt": "2023-06-21T15:03:14Z",
  "phoneVerifiedAt": "2023-06-21T15:03:14Z",
  "marketingEmailsAcceptedAt": "2023-06-21T15:03:14Z",
  "defaultTeamId": 10,
  "isGuest": false,
  "nationalId": "123456-7890",
  "hasPaymentCard": true,
  "hasValidPaymentCard": true
}

json

application/json

Set the default team for a user

PUT

https://partner-api.monta.com

/api/v1/users/{userId}/default-team

Assigns an existing private team as this user's default team. The team must be owned by this user, belong to the operator (or any of its sub-operators), and not currently be another user's default. Required scope: users:write
Organization authorization: supported

Set the default team for a user › path Parameters

userId

integer · int64 · required

Set the default team for a user › Request Body

SetDefaultTeam

teamId

integer · int64 · required

Id of an existing private team owned by the operator (or one of its sub-operators) to assign as the user's default team

Example: 12345

Set the default team for a user › Responses

User with default team assigned

User

id

integer · int64 · required

Id of the user

Example: 10

firstName

string | null

First name of the user

Example: John

lastName

string | null

Last name of the user

Example: Doe

email

string | null

Email of the user

Example: john.doe@example.com

legalEmail

string | null

Legal email of the user (certified e-mail)

Example: legal@ut.com

phone

string | null

Phone number of the user

Example: +1234567890

profileImageUrl

string | null

URL of the profile image

Example: https://example.com/profile.jpg

object

Address of the user

language

string | null

Preferred language of the user

Example: en

termsReadAt

string | null · date-time

Timestamp when the user read the terms

Example: 2023-06-21T15:03:14Z

taxIdentificationNumber

string | null

Personal tax number if set for the user

Example: X12345678A

vatNumber

string | null

VAT number which is the company tax id

Example: IT07643520567

recipientCode

string | null

The recipient code used for e-invoicing

Example: 2021-10-001

createdAt

string | null · date-time

Timestamp when the user was created

Example: 2023-06-21T15:03:14Z

updatedAt

string | null · date-time

Timestamp when the user was last updated

Example: 2023-06-21T15:03:14Z

deletedAt

string | null · date-time

Timestamp when the user was deleted

Example: 2023-06-21T15:03:14Z

emailVerifiedAt

string | null · date-time

Timestamp when the email was verified

Example: 2023-06-21T15:03:14Z

phoneVerifiedAt

string | null · date-time

Timestamp when the phone was verified

Example: 2023-06-21T15:03:14Z

marketingEmailsAcceptedAt

string | null · date-time

Timestamp when the user accepted the marketing emails

Example: 2023-06-21T15:03:14Z

defaultTeamId

integer | null · int64

ID of the default team for the user

Example: 10

isGuest

boolean | null

Indicates whether this user is a guest (ad-hoc) user who has not yet completed registration

Example: false

nationalId

string | null

National identification number. Returned only when configured per operator

Example: 123456-7890

hasPaymentCard

boolean | null

Example: true

hasValidPaymentCard

boolean | null

Example: true

PUT/api/v1/users/{userId}/default-team

curl https://partner-api.monta.com/api/v1/users/:userId/default-team \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "teamId": 12345
}'

Example Request Body

{
  "teamId": 12345
}

json

Example Responses

{
  "id": 10,
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "legalEmail": "legal@ut.com",
  "phone": "+1234567890",
  "profileImageUrl": "https://example.com/profile.jpg",
  "address": {
    "address1": "Strandboulevarden 122",
    "address2": "København",
    "address3": "5. sal",
    "zip": "2100",
    "city": "Copenhagen",
    "province": "Lombardy",
    "country": "Denmark",
    "countryAreaId": 1
  },
  "language": "en",
  "termsReadAt": "2023-06-21T15:03:14Z",
  "taxIdentificationNumber": "X12345678A",
  "vatNumber": " IT07643520567",
  "recipientCode": "2021-10-001",
  "createdAt": "2023-06-21T15:03:14Z",
  "updatedAt": "2023-06-21T15:03:14Z",
  "deletedAt": "2023-06-21T15:03:14Z",
  "emailVerifiedAt": "2023-06-21T15:03:14Z",
  "phoneVerifiedAt": "2023-06-21T15:03:14Z",
  "marketingEmailsAcceptedAt": "2023-06-21T15:03:14Z",
  "defaultTeamId": 10,
  "isGuest": false,
  "nationalId": "123456-7890",
  "hasPaymentCard": true,
  "hasValidPaymentCard": true
}

json

application/json

Request export of user data

POST

https://partner-api.monta.com

/api/v1/users/{userId}/export-data

Triggers a GDPR data export for the user. Limited to once per month. Required scope: users:write
Organization authorization: supported

Request export of user data › path Parameters

userId

integer · int64 · required

Request export of user data › Responses

Export request submitted

No data returned

Retrieve teams for a user

GET

https://partner-api.monta.com

/api/v1/users/{userId}/teams

Required scope: users:read
Organization authorization: supported

Retrieve teams for a user › path Parameters

userId

integer · int64 · required

Retrieve teams for a user › 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

Retrieve teams for a user › Responses

List of teams the user belongs to

OffsetBasedResponse_60

Team[] · required

MontaPage.Meta · required

GET/api/v1/users/{userId}/teams

curl https://partner-api.monta.com/api/v1/users/:userId/teams \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": 1,
      "name": "Internal team",
      "email": "email@it.com",
      "financeEmail": "email@it.com",
      "financeCommunicationEmail": "billing_notices@monta.com",
      "legalEmail": "email@it.com",
      "externalId": "123-ABC",
      "partnerExternalId": "ACME-12345",
      "partnerCustomPayload": {
        "internalId": "ACME-12345",
        "department": "Fleet"
      },
      "customFields": {
        "externalId": "crm-4711",
        "costCenter": "DK-OPS-12"
      },
      "joinCode": "mvv-energie-042",
      "recipientCode": "my-team-123",
      "companyName": "Housing XYZ",
      "taxIdentificationNumber": "123456789",
      "vatNumber": "DE123456789",
      "companyRegistrationNumber": "13585628",
      "operator": {
        "id": 14,
        "name": "Monta",
        "identifier": "monta",
        "partnerId": 1,
        "vatNumber": "FOO-123-ABC"
      },
      "address": {
        "address1": "Strandboulevarden 122",
        "address2": "København",
        "address3": "5. sal",
        "city": "Berlin",
        "province": "Lombardy",
        "countrySubdivisionCode": "US-GA",
        "zipCode": "10011",
        "countryId": 1
      },
      "currency": {
        "identifier": "dkk",
        "name": "Danish krone",
        "decimals": 2
      },
      "type": "personal",
      "category": {
        "identifier": "cpo",
        "name": "Charge Point Operator"
      },
      "operatorId": 1,
      "userId": 1,
      "isFrozen": false,
      "frozenReason": "removed team",
      "featureGroupId": 1,
      "frozenAt": "2022-05-12T16:56:45.99Z",
      "blockedAt": "2022-05-12T15:56:45.99Z",
      "createdAt": "2022-05-12T15:56:45.99Z",
      "updatedAt": "2022-05-12T16:56:45.99Z",
      "deletedAt": "2022-05-12T16:56:45.99Z",
      "paymentMethod": "invoice",
      "invoiceRequest": {
        "id": 12345,
        "status": "pending",
        "requestedAt": "2025-07-08T15:56:45.99Z",
        "approvedAt": "2025-07-08T16:00:00Z",
        "rejectedAt": "2025-07-08T16:05:00Z",
        "rejectionReason": "Missing required data",
        "updatedAt": "2025-07-08T16:10:00Z"
      },
      "themeId": 1,
      "tags": [
        {
          "id": 1,
          "name": "cpo"
        }
      ],
      "onboardingSteps": [
        {
          "step": "SETUP_CHARGING_RULE",
          "config": "scheduled",
          "displayMode": "full_screen"
        }
      ],
      "onboardingWelcomeText": {
        "type": "home",
        "enabled": true,
        "slots": {
          "key": {
            "mode": "custom",
            "text": "Plug in your car to start charging.",
            "follows": "ready"
          }
        }
      },
      "autoWithdrawEnabled": true,
      "autoWithdrawNextAt": "2026-11-01T00:00:00Z",
      "hasPaymentCard": true,
      "paymentMethods": [
        {
          "type": "card",
          "brand": "visa",
          "last4": "4242",
          "expiryMonth": 12,
          "expiryYear": 2028,
          "expired": false
        }
      ]
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Themes Vehicles