Get a service's specification lints

GET

/api-catalog/services/:serviceId/spec-lints

GET

/api-catalog/services/:serviceId/spec-lints

$ curl https://api.getpostman.com/api-catalog/services/c6ec74e7-14f8-498c-9470-7a654173bed6/spec-lints \
>      -H "x-api-key: <apiKey>"

1 {
2   "meta": {
3     "nextCursor": null,
4     "limit": 20,
5     "filters": {},
6     "timeRange": {
7       "start": "2026-04-14T13:43:59.525Z",
8       "end": "2026-04-21T13:43:59.525Z",
9       "label": "last_7_days"
10     },
11     "totalRuns": 2,
12     "passedRuns": 2,
13     "failedRuns": 0,
14     "conformanceRatePct": 100
15   },
16   "data": [
17     {
18       "specId": "4c2e5d66-dd5a-43ea-a669-112f16ad48b4",
19       "specName": "ACS E2E Spec",
20       "specType": "OPENAPI:3.0",
21       "timestamp": "2026-04-19T12:08:43.110Z",
22       "status": "passed",
23       "issues": {
24         "errors": 0,
25         "warnings": 15,
26         "info": 0
27       }
28     },
29     {
30       "specId": "4c2e5d66-dd5a-43ea-a669-112f16ad48b4",
31       "specName": "ACS E2E Spec",
32       "specType": "OPENAPI:3.0",
33       "timestamp": "2026-04-16T03:49:56.069Z",
34       "status": "passed",
35       "issues": {
36         "errors": 0,
37         "warnings": 15,
38         "info": 0
39       }
40     }
41   ]
42 }

Gets a list of API specification lint runs for a service that includes summary statistics and per-severity issue counts.

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)>.

Path parameters

serviceIdstringRequired

The service's ID.

Query parameters

specIdstringOptional

Filter results to the given API specification ID.

severityenumOptional

Filter results to runs with issues at or above the given severity threshold. Higher severities are always included.

Allowed values:

statusenumOptional

Filter results to the given spec lint outcome.

Allowed values:

sortstringOptionalformat: "^(timestamp|errorCount):(asc|desc)$"

Sort the results in field:direction order format. Accepts the timestamp and errorCount fields. Supports the asc and desc directions.

limitintegerOptional1-100Defaults to 20

The maximum number of rows to return in the response, up to a maximum value of 100. Any value greater than 100 returns a 400 Bad Request response.

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.

Response

Successful Response

metaobject

The response's meta information for paginated results.

datalist of objects

A list of API specification lint runs.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error