---
title: "Search groups"
description: "Searches for groups on Mindtickle by group name or by group ID."
contentType: "api-reference"
url: "https://developer.mindtickle.com/docs/users-and-groups/groups/search-groups/"
---

## Prerequisites

1. [Authentication and setup](/docs/getting-started/authentication-and-setup/): A valid access token.

## Endpoint

```http
POST /services/data/v2.0/mtobjects/Groups
```

Base URL: the standard REST host for your region. See [Base URLs](/docs/getting-started/authentication-and-setup/#base-urls).

Headers: `Authorization: Bearer ACCESS_TOKEN`, `Content-Type: application/json`.

## Request

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `names` | Array[string] | Optional | Names of the groups you want to search. Send each name as a separate string in the JSON array. |
| `ids` | Array[string] | Optional | Mindtickle IDs of the groups you want to search. Send each ID as a separate string in the JSON array. |

### Request example

```json
{
  "names": ["APAC Sales", "EMEA SALES"],
  "ids": ["1234567890123456101", "1234567890123456102"]
}
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `requestId` | string or null | Request identifier. The response examples return `null`. |
| `responseCode` | integer | Special response codes from the server. |
| `responseType` | string | Type of response from the server. |
| `taskCompleted` | boolean | Completion flag for this request. This endpoint returns its result directly. |
| `totalSize` | integer | Total number of groups returned in the response. |
| `groups` | Array[Group] | Information on the groups you have searched. |
| `groups[].name` | string | Name of the group. |
| `groups[].id` | string | Mindtickle ID of the group. |

### Response example

```json
{
  "requestId": null,
  "responseCode": 0,
  "responseType": "GROUP_SEARCH_RESPONSE",
  "taskCompleted": true,
  "totalSize": 2,
  "groups": [
    {
      "name": "APAC Sales",
      "id": "1234567890123456102"
    },
    {
      "name": "EMEA SALES",
      "id": "1234567890123456101"
    }
  ]
}
```

## Notes

- **Validation:** The group names you enter must exactly match their name on the Mindtickle platform.

## Related

- [Get a group](/docs/users-and-groups/groups/get-a-group/): Read one group by group ID.
- [Update a group](/docs/users-and-groups/groups/update-a-group/): Update a group found by this search.
- [Add a user to groups](/docs/users-and-groups/users/add-a-user-to-groups/): Use the returned group IDs to add users.