---
title: "Retrieve a list of nested team relations"
method: GET
path: "/api/v1/nested-teams"
tags: ["Nested teams"]
---

# Retrieve a list of nested team relations

`GET /api/v1/nested-teams`

Required scope: `team-members:read` </br>Organization authorization: `supported`

## Query parameters

- `page` integer
- `perPage` integer
- `state` 'requested' | 'invited' | 'accepted' | 'rejected_at' | 'blocked' | 'expired'
- `includeDeleted` boolean, nullable — Includes deleted resources in the response
- `nestedTeamIds` string, nullable — Filter by a comma-separated list of nested team `id`s
- `parentTeamIds` string, nullable — Filter by a comma-separated list of parent team `id`s
- `priceGroupIds` string, nullable — Filter by a comma-separated list of price group `id`s
- `invitedByUserIds` string, nullable — Filter by a comma-separated list of inviting user `id`s
- `access` 'all' | 'selected'

## Response `200`

List of nested team relations that match the criteria

- OffsetBasedResponse49
  - `data` NestedTeam[], required
    - `id` integer — Id of the nested team relation
    - `parentTeam` PublicTeam, required
      - `id` integer — Id of the public team
      - `publicName` string, nullable — Public name of the team
      - `memberCount` integer, nullable — Number of members in the team
    - `nestedTeam` PublicTeam
      - `id` integer — Id of the public team
      - `publicName` string, nullable — Public name of the team
      - `memberCount` integer, nullable — Number of members in the team
    - `priceGroup` PriceGroup1
      - `id` integer — Id of the price group
      - `name` string, required — Name of the price group
    - `invitedByUser` PublicUser1
      - `id` integer — Id of the user
      - `firstName` string, nullable — First name of the user
      - `lastName` string, nullable — Last name of the user
      - `displayName` string, nullable — Display name of the user
    - `userRole` 'user', required — The role assigned to the nested team
    - `access` 'all' | 'selected', required
    - `state` 'requested' | 'invited' | 'accepted' | 'rejected_at' | 'blocked' | 'expired', required
    - `selectedChargePointIds` integer[], nullable — Selected charge points nested team has access to
    - `note` string, nullable — Internal note for this nested team
    - `createdAt` string, date-time, required — Datetime of the creation of nested team invite
    - `updatedAt` string, date-time, nullable — Datetime of the update of nested team invite
    - `invitedAt` string, date-time, nullable — Datetime nested team was invited
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/versions/517e18f11015/schema)