---
title: "Retrieve organization teams"
method: GET
path: "/v1/organizations/{organizationId}/teams"
tags: ["Organizations"]
---

# Retrieve organization teams

`GET /v1/organizations/{organizationId}/teams`

## Request

- Base URL: `https://platform.hootsuite.com`
- URL: `https://platform.hootsuite.com/v1/organizations/{organizationId}/teams`
- Auth: OAuth 2
  - Authorization code: `https://platform.hootsuite.com/oauth2/auth`
  - Token URL: `https://platform.hootsuite.com/oauth2/token`

Retrieves a list of teams for a given organization.

## Path parameters

- `organizationId` string, required

## Headers

- `Authorization` string, required

## Response `200`

Success

- OrganizationTeamsResponseEnvelope
  - `data` Team[]: The data response envelope.
    - `id` string: The team ID.
    - `name` string: The team name.
    - `logoUrl` string: The team's logo URL.
    - `createdDate` string: The date the team was created.
    - `createdByMember` object: The member who created the team.
      - `id` string: The member ID.
    - `modifiedDate` string: The date the team was last modified.
    - `modifiedByMember` object: The member who last modified the team.
      - `id` string: The member ID.

## Other responses

- `400`: Bad Request
- `403`: Forbidden (Insufficient permissions to view organization teams)

---

[API](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api.md) - [All operations](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api/revisions/adac53bd28bb?raw)