Get all groups

GET

/scim/v2/Groups

GET

/scim/v2/Groups

$ curl https://api.getpostman.com/scim/v2/Groups \
>      -H "x-api-key: <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

x-api-keystring

API Key authentication via header

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.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

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 objects

A list of group resources.

itemsPerPagedouble

The number of items per response page.

schemaslist of strings

startIndexdouble

The index entry by which the returned results begin.

totalResultsdouble

The total number of results found.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error