Get all specs

GET

/specs

GET

/specs

$ curl -G https://api.getpostman.com/specs \
>      -H "x-api-key: <apiKey>" \
>      -d workspaceId=1f0df51a-8658-4ee8-a2a1-d2567dfa09a9

1 {
2   "meta": {
3     "nextCursor": null
4   },
5   "specs": [
6     {
7       "id": "4e032b57-1fd6-41d7-882a-de5ac2107671",
8       "name": "OpenAPI 3.0 (Files)",
9       "type": "OPENAPI:3.0",
10       "createdBy": 12345678,
11       "updatedBy": 12345678,
12       "createdAt": "2026-02-06T16:23:48.000Z",
13       "updatedAt": "2026-02-06T16:24:51.000Z"
14     },
15     {
16       "id": "c693c62f-f9dc-4f9d-ae9d-70ef7ee5dc13",
17       "name": "OpenAPI 3.0",
18       "type": "OPENAPI:3.0",
19       "createdBy": 87654321,
20       "updatedBy": 87654321,
21       "createdAt": "2026-02-06T16:23:21.000Z",
22       "updatedAt": "2026-02-06T16:23:25.000Z"
23     },
24     {
25       "id": "c35e472d-9d08-42c2-bf29-bb57d10ead31",
26       "name": "OpenAPI 2.0",
27       "type": "OPENAPI:2.0",
28       "createdBy": 56781234,
29       "updatedBy": 12345678,
30       "createdAt": "2026-02-06T16:23:08.000Z",
31       "updatedAt": "2026-02-06T16:23:14.000Z"
32     },
33     {
34       "id": "05bcee59-b7b6-4d2b-9910-3a3291948fce",
35       "name": "OpenAPI 3.1",
36       "type": "OPENAPI:3.1",
37       "createdBy": 87654321,
38       "updatedBy": 56781234,
39       "createdAt": "2026-02-06T16:21:33.000Z",
40       "updatedAt": "2026-02-06T16:22:13.000Z"
41     },
42     {
43       "id": "c74e92cd-924d-4cca-b2c2-dc6fdd6da700",
44       "name": "Async API YAML",
45       "type": "ASYNCAPI:2.0",
46       "createdBy": 12345678,
47       "updatedBy": 12345678,
48       "createdAt": "2026-02-06T16:20:40.000Z",
49       "updatedAt": "2026-02-06T16:20:46.000Z"
50     },
51     {
52       "id": "a3c06b93-e6f2-466c-8197-340a2f8e2063",
53       "name": "Protobuf 2 (Files)",
54       "type": "PROTOBUF:2",
55       "createdBy": 12345678,
56       "updatedBy": 12345678,
57       "createdAt": "2026-02-06T15:46:08.000Z",
58       "updatedAt": "2026-02-06T15:46:15.000Z"
59     },
60     {
61       "id": "8ea532f9-cb6e-4306-b50d-3771c0926e31",
62       "name": "Protobuf 3",
63       "type": "PROTOBUF:3",
64       "createdBy": 12345678,
65       "updatedBy": 12345678,
66       "createdAt": "2026-02-06T15:45:49.000Z",
67       "updatedAt": "2026-02-06T15:45:53.000Z"
68     },
69     {
70       "id": "2448ebdb-59c5-4287-80b3-78ef77234275",
71       "name": "Protobuf 2",
72       "type": "PROTOBUF:2",
73       "createdBy": 87654321,
74       "updatedBy": 87654321,
75       "createdAt": "2026-02-06T15:45:43.000Z",
76       "updatedAt": "2026-02-06T15:45:46.000Z"
77     },
78     {
79       "id": "6184347c-8382-41cb-a3d2-af44336a69bb",
80       "name": "GraphQL",
81       "type": "GRAPHQL",
82       "createdBy": 12345678,
83       "updatedBy": 12345678,
84       "createdAt": "2026-02-06T15:45:34.000Z",
85       "updatedAt": "2026-02-06T15:45:39.000Z"
86     },
87     {
88       "id": "482f7385-d937-4e0f-9e1f-bd812acc41fd",
89       "name": "Async API JSON",
90       "type": "ASYNCAPI:2.0",
91       "createdBy": 12345678,
92       "updatedBy": 12345678,
93       "createdAt": "2025-11-03T14:26:56.000Z",
94       "updatedAt": "2026-02-06T16:19:46.000Z"
95     },
96     {
97       "id": "482f7385-d937-4e0f-9e1f-bd812acc41fd",
98       "name": "Async API YAML",
99       "type": "ASYNCAPI:3.0",
100       "createdBy": 12345678,
101       "updatedBy": 12345678,
102       "createdAt": "2026-05-19T13:27:02.337Z",
103       "updatedAt": "2026-05-19T13:27:02.337Z"
104     },
105     {
106       "id": "4e4b7c59-7851-40cb-8503-bbcabe5c7d0f",
107       "name": "Smithy",
108       "type": "SMITHY:2.0",
109       "createdBy": 12345678,
110       "updatedBy": 12345678,
111       "createdAt": "2026-05-06T13:59:38.000Z",
112       "updatedAt": "2026-05-06T13:59:38.000Z"
113     }
114   ]
115 }

Gets all API specifications in a workspace.

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

workspaceIdstringRequired

The workspace's ID.

cursorstringOptional

The pointer to the first record of the set of paginated results. To view the next response, use the nextCursor value for this parameter.

limitintegerOptionalDefaults to 10

The maximum number of rows to return in the response.

Response

Successful Response

metaobject

The response's meta information for paginated results.

specslist of objects

A list of API specifications.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error