{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/api-evangelist/postman/main/json-schema/postman-get-api-catalog-service-specification-lints-schema.json", "title": "getApiCatalogServiceSpecificationLints", "x-generated": "2026-10-04", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/postman-apicatalog-api-openapi.yml#/components/schemas/getApiCatalogServiceSpecificationLints", "type": "object", "properties": { "meta": { "$ref": "#/$defs/GetApiCatalogServiceSpecificationLintsMeta", "description": "The response's meta information for paginated results." }, "data": { "type": "array", "items": { "$ref": "#/$defs/GetApiCatalogServiceSpecificationLintsDataItems" }, "description": "A list of API specification lint runs." } }, "required": [ "meta", "data" ], "$defs": { "ApiCatalogServiceMetadataTimeRangeDataLabel": { "type": "string", "enum": [ "last_7_days" ], "description": "The time range's label.", "title": "ApiCatalogServiceMetadataTimeRangeDataLabel" }, "GetApiCatalogServiceSpecificationLintsDataItems": { "type": "object", "properties": { "specId": { "type": "string", "description": "The API specification's ID." }, "specName": { "type": [ "string", "null" ], "description": "The API specification's name. If the specification was deleted or its metadata is unavailable, this returns a null value." }, "specType": { "type": [ "string", "null" ], "description": "The API specification's type and version ID. If the metadata is unavailable, this returns a null value." }, "timestamp": { "type": "string", "format": "date-time", "description": "The date and time at which the run completed." }, "status": { "$ref": "#/$defs/GetApiCatalogServiceSpecificationLintsDataItemsStatus", "description": "Whether the lint run passed or failed." }, "issues": { "$ref": "#/$defs/GetApiCatalogServiceSpecificationLintsDataItemsIssues", "description": "Issue counts by severity level." } }, "required": [ "specId", "specName", "specType", "timestamp", "status", "issues" ], "title": "GetApiCatalogServiceSpecificationLintsDataItems" }, "GetApiCatalogServiceSpecificationLintsDataItemsIssues": { "type": "object", "properties": { "errors": { "type": "integer", "description": "The number of error level issues found." }, "warnings": { "type": "integer", "description": "The number of warning level issues found." }, "info": { "type": "integer", "description": "The number of info level issues found." } }, "required": [ "errors", "warnings", "info" ], "description": "Issue counts by severity level.", "title": "GetApiCatalogServiceSpecificationLintsDataItemsIssues" }, "GetApiCatalogServiceSpecificationLintsDataItemsStatus": { "type": "string", "enum": [ "passed", "failed" ], "description": "Whether the lint run passed or failed.", "title": "GetApiCatalogServiceSpecificationLintsDataItemsStatus" }, "GetApiCatalogServiceSpecificationLintsMeta": { "type": "object", "properties": { "nextCursor": { "$ref": "#/$defs/apiCatalogServiceMetadataNextCursorData" }, "limit": { "$ref": "#/$defs/apiCatalogServiceMetadataLimitData" }, "filters": { "$ref": "#/$defs/apiCatalogServiceMetadataFiltersData" }, "timeRange": { "$ref": "#/$defs/apiCatalogServiceMetadataTimeRangeData" }, "totalRuns": { "$ref": "#/$defs/apiCatalogServiceMetadataTotalRunsData" }, "passedRuns": { "$ref": "#/$defs/apiCatalogServiceMetadataPassedRunsData" }, "failedRuns": { "$ref": "#/$defs/apiCatalogServiceMetadataFailedRunsData" }, "conformanceRatePct": { "$ref": "#/$defs/apiCatalogServiceMetadataConformanceRatePctData" } }, "required": [ "nextCursor", "limit", "filters", "timeRange", "totalRuns", "passedRuns", "failedRuns", "conformanceRatePct" ], "description": "The response's meta information for paginated results.", "title": "GetApiCatalogServiceSpecificationLintsMeta" }, "apiCatalogServiceMetadataConformanceRatePctData": { "type": "number", "format": "double", "description": "The percentage of runs that passed, rounded to two decimal places.", "title": "apiCatalogServiceMetadataConformanceRatePctData" }, "apiCatalogServiceMetadataFailedRunsData": { "type": "integer", "description": "The number of runs with at least one failure.", "title": "apiCatalogServiceMetadataFailedRunsData" }, "apiCatalogServiceMetadataFiltersData": { "type": "object", "properties": {}, "description": "The filters applied to the request.", "title": "apiCatalogServiceMetadataFiltersData" }, "apiCatalogServiceMetadataLimitData": { "type": "integer", "description": "The maximum number of records in the paginated response.", "title": "apiCatalogServiceMetadataLimitData" }, "apiCatalogServiceMetadataNextCursorData": { "type": "string", "description": "The pagination cursor that points to the next record in the results set.", "title": "apiCatalogServiceMetadataNextCursorData" }, "apiCatalogServiceMetadataPassedRunsData": { "type": "integer", "description": "The number of successful runs.", "title": "apiCatalogServiceMetadataPassedRunsData" }, "apiCatalogServiceMetadataTimeRangeData": { "type": "object", "properties": { "start": { "type": "string", "format": "date-time", "description": "The start of the time window." }, "end": { "type": "string", "format": "date-time", "description": "The end of the time window." }, "label": { "$ref": "#/$defs/ApiCatalogServiceMetadataTimeRangeDataLabel", "description": "The time range's label." } }, "required": [ "start", "end", "label" ], "description": "The time window for the returned data.", "title": "apiCatalogServiceMetadataTimeRangeData" }, "apiCatalogServiceMetadataTotalRunsData": { "type": "integer", "description": "The total number of runs that match the given filters.", "title": "apiCatalogServiceMetadataTotalRunsData" } } }