Users

Retrieve teams for a user

Changed on

Required scope: users:read </br>Organization authorization: supported

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

Request

  • Base URL
    https://partner-api.monta.com
  • URL
    https://partner-api.monta.com/api/v1/users/{userId}/teams
  • Auth
    HTTP bearer

Path parameters

userIdinteger required

Query parameters

pageinteger

page number to retrieve (starts with 0)

perPageinteger

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

Response

List of teams the user belongs to

Example response

{
  "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,
      "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",
      "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
      },
      "autoWithdrawEnabled": true,
      "autoWithdrawNextAt": "2026-11-01T00:00:00Z",
      "hasPaymentCard": true,
      "paymentMethods": [
        {
          "type": "card",
          "brand": "visa",
          "last4": "4242",
          "expiryMonth": 12,
          "expiryYear": 2028
        }
      ]
    }
  ]
}

Changes

    • breaking

      the // response's property type changed from array to object for status

    • warning

      added the new admin enum value to the //// response property for the response status

    • warning

      added the new member enum value to the //// response property for the response status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added to the // response property allOf list for the response status

    • info

      removed from the // response property allOf list for the response status

    • info

      response property data/items/partnerCustomPayload deprecated

    • info

      response property data/items/partnerExternalId deprecated