---
title: "Retrieve groups"
url: "https://earlyaccess.developers.bynder.com/apis/groups-1/versions/8b5e3751-b1f6-4df8-9f5d-f494f76062f0/operations/retrieveGroupsLegacy"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/groups-1/versions/8b5e3751-b1f6-4df8-9f5d-f494f76062f0.md

# Retrieve groups

`GET` `/api/groups/list/`

Operation ID: `retrieveGroupsLegacy`

Requires the **GROUPMANAGEMENT** security role.

## Query parameters

- `search_term` (string, optional) - Search on matching group names.
- `page` (integer, optional) - What page of results to return.
- `limit` (integer, optional) - Maximum results to return. If limit is not provided the first 20 results will be returned.
- `sort_order` (string, optional) - Order of the returned list of groups.

## Responses

- `200` - Successful response

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Groups
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/groups/list/:
    get:
      description: Requires the **GROUPMANAGEMENT** security role.
      operationId: retrieveGroupsLegacy
      parameters:
        - description: Search on matching group names.
          in: query
          name: search_term
          required: false
          schema:
            type: string
        - description: What page of results to return.
          in: query
          name: page
          required: false
          schema:
            default: 1
            type: integer
        - description: Maximum results to return. If limit is not provided the first 20
            results will be returned.
          in: query
          name: limit
          required: false
          schema:
            default: 20
            type: integer
        - description: Order of the returned list of groups.
          in: query
          name: sort_order
          required: false
          schema:
            enum:
              - asc
              - desc
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  properties:
                    id:
                      type: string
                    name:
                      type: string
                  type: object
                type: array
          description: Successful response
      security:
        - permanentToken:
            - GROUPMANAGEMENT
        - OAuth2:
            - GROUPMANAGEMENT
      summary: Retrieve groups
      tags:
        - Groups (Legacy)
security:
  - permanentToken:
      - GROUPMANAGEMENT
  - OAuth2:
      - GROUPMANAGEMENT
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            GROUPMANAGEMENT: Grants permission to manage groups`
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            GROUPMANAGEMENT: Grants permission to manage groups
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
```