Get all groups

GET

/scim/v2/Groups

GET

/scim/v2/Groups

$ curl https://api.postman.com/scim/v2/Groups \
>      -H "Authorization: <apiKey>"

1 {
2   "Resources": [
3     {
4       "schemas": [
5         "urn:ietf:params:scim:schemas:core:2.0:Group"
6       ],
7       "id": "561631fq14ed41872a8eea4c8aa2b38cda9749812cc55c00",
8       "displayName": "TestAPI",
9       "members": [
10         {
11           "value": "23a35c2723d34c03b4c56443c09e7173",
12           "display": "Taylor Lee"
13         }
14       ],
15       "externalId": "1234",
16       "meta": {
17         "resourceType": "Group",
18         "created": "2022-02-22T04:24:13.000Z",
19         "lastModified": "2022-02-22T04:24:13.000Z"
20       }
21     },
22     {
23       "schemas": [
24         "urn:ietf:params:scim:schemas:core:2.0:Group"
25       ],
26       "id": "123775fe15ed41872a8eea4c8aa2b38cda9749812cc55c99",
27       "displayName": "Test Group",
28       "members": [
29         {
30           "value": "23a35c2723d34c03b4c56443c09e7173",
31           "display": "Taylor Lee"
32         },
33         {
34           "value": "b1c794f24f4c49f4b5d503a4cb2686ea",
35           "display": "Alex Cruz"
36         }
37       ],
38       "externalId": "4321",
39       "meta": {
40         "resourceType": "Group",
41         "created": "2022-02-22T04:24:13.000Z",
42         "lastModified": "2022-02-22T04:24:13.000Z"
43       }
44     }
45   ],
46   "itemsPerPage": 2,
47   "schemas": [
48     "urn:ietf:params:scim:api:messages:2.0:ListResponse"
49   ],
50   "startIndex": 1,
51   "totalResults": 2
52 }

Gets information about all Postman team members.

Authentication

Authorizationstring

A valid SCIM API key for calls to SCIM endpoints.

A valid [SCIM API key](https://learning.postman.com/docs/administration/scim-provisioning/scim-provisioning-overview/#generating-scim-api-key) for calls to SCIM endpoints.

Query parameters

startIndexdoubleOptional>=1Defaults to 1

The index entry by which to begin the list of returned results. Must be a value of 1 or greater.

countdoubleOptionalDefaults to 100

Limit the number of results returned in a single response.

filterstringOptional

Filter results by a specific word or phrase. This query parameter only supports the displayName filter and has the following requirements:

Filter values are case-sensitive.
Special characters and spaces must be URL encoded.

Filter results by a specific word or phrase. This query parameter only supports the `displayName` filter and has the following requirements: - Filter values are case-sensitive. - Special characters and spaces must be URL encoded.

Response

Successful Response

Resourceslist of objectsOptional

A list of group resources.

itemsPerPagedoubleOptional

The number of items per response page.

schemaslist of stringsOptional

startIndexdoubleOptional

The index entry by which the returned results begin.

totalResultsdoubleOptional

The total number of results found.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error