Get all collections

GET

/collections

GET

/collections

$ curl https://api.getpostman.com/collections \
>      -H "x-api-key: <apiKey>"

1 {
2   "collections": [
3     {
4       "id": "026fa484-c108-4223-af5e-e97137865143",
5       "name": "Test API 3.1.0",
6       "owner": "892436",
7       "createdAt": "2024-09-09T14:16:40.000Z",
8       "updatedAt": "2024-09-09T14:16:40.000Z",
9       "uid": "892436-026fa484-c108-4223-af5e-e97137865143",
10       "isPublic": false
11     },
12     {
13       "id": "02c5343c-0a8d-4bd9-941c-cd9dadd73770",
14       "name": "Sanity tests collection changed all values",
15       "owner": "892436",
16       "createdAt": "2024-03-01T23:01:22.000Z",
17       "updatedAt": "2024-03-01T23:01:32.000Z",
18       "uid": "892436-02c5343c-0a8d-4bd9-941c-cd9dadd73770",
19       "isPublic": false
20     },
21     {
22       "id": "044f35b0-dffe-4ce6-9114-165c720657de",
23       "name": "Sanity tests collection",
24       "owner": "892436",
25       "createdAt": "2023-08-21T15:06:57.000Z",
26       "updatedAt": "2023-08-21T15:06:57.000Z",
27       "uid": "892436-044f35b0-dffe-4ce6-9114-165c720657de",
28       "isPublic": false
29     }
30   ],
31   "meta": {
32     "total": 192,
33     "offset": 0,
34     "limit": 3
35   }
36 }

Gets all of your collections. The response includes all of your subscribed collections.

Note:

It’s recommended that you use pagination with this endpoint. Pagination improves endpoint performance. Unpaginated calls are considered deprecated and are subject to change.
Filtering with the name parameter when you also pass the limit and offset parameters is not supported.
If you pass an invalid workspace ID for the workspace query parameter, this endpoint returns an HTTP 200 OK response with an empty array.

Gets all of your [collections](https://www.getpostman.com/docs/collections). The response includes all of your subscribed collections. **Note:** - It's recommended that you use pagination with this endpoint. Pagination improves endpoint performance. Unpaginated calls are considered deprecated and are subject to change. - Filtering with the `name` parameter when you also pass the `limit` and `offset` parameters is not supported. - If you pass an invalid workspace ID for the `workspace` query parameter, this endpoint returns an HTTP `200 OK` response with an empty array.

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

workspacestringOptional

The workspace's ID.

namestringOptional

Filter results by collections whose name exactly matches the given value. Partial or substring matches are not supported.

limitintegerOptional

The maximum number of rows to return in the response.

offsetintegerOptional

The zero-based offset of the first item to return.

Response

Successful Response

collectionslist of objects

metaobject

The response's meta information for paginated results.

Errors

401

Unauthorized Error

500

Internal Server Error