Retrieve teams for a user
Changed onRequired scope: users:read </br>Organization authorization: supported
Request
- Base URLhttps://partner-api.monta.com
- URLhttps://partner-api.monta.com/api/v1/users/{userId}/teams
- AuthHTTP bearer
Path parameters
Query parameters
page number to retrieve (starts with 0)
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 fromarraytoobjectfor status - warning
added the new
adminenum value to the////response property for the response status - warning
added the new
memberenum 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 propertyallOflist for the response status - info
removed from the
//response propertyallOflist for the response status - info
response property
data/items/partnerCustomPayloaddeprecated - info
response property
data/items/partnerExternalIddeprecated
- breaking