---
id: catalog-specification-list
title: "List catalog specifications"
description: "Lists all catalog specifications."
sidebar_label: "List catalog specifications"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/catalog
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List catalog specifications"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/metadata/metadata_specification"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Lists all catalog specifications.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"schema":{"type":"string","minLength":1},"in":"query","name":"limit","required":false,"description":"Limits the number of results returned per page."},{"schema":{"type":"string","minLength":1},"in":"query","name":"offset","required":false,"description":"The starting point for pagination. Defaults to 0 if not provided."},{"schema":{"type":"string","enum":["organization","account","namespace","application","build","asset","scope","release","deployment","user"]},"in":"query","name":"entity","required":false,"description":"Parent entity that holds metadata information."},{"schema":{"type":"string","minLength":1},"in":"query","name":"metadata","required":false,"description":"Entity metadata key, for example: coverage, frameworks, vulnerabilities."},{"schema":{"title":"NRN","type":"string","pattern":"^organization=(\\d+|\\*)+(?::account=(\\d+|\\*))?(?::namespace=(\\d+|\\*))?(?::application=(\\d+|\\*))?(?::(build|scope|release|asset|deployment)=(\\d+|\\*))?$","description":"Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources."},"in":"query","name":"nrn","required":true,"description":"NRN where the catalog specification is defined."},{"schema":{"type":"string","minLength":1},"in":"query","name":"include","required":false,"description":"Add additional catalog specifications to the response. For example: global."},{"schema":{"type":"boolean"},"in":"query","name":"merge","required":false,"description":"Merge catalog specifications using NRN hierarchy."},{"schema":{"type":"string","minLength":1},"in":"query","name":"only","required":false,"description":"Return only catalog specifications that match the provided entity."}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Object representing pagination parameters for controlling the number and order of results","content":{"application/json":{"schema":{"title":"ServiceList","type":"object","properties":{"paging":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"description":"Limits the number of results returned"},"offset":{"type":"integer","minimum":0,"description":"Specifies the offset for paginated results"}},"required":["limit","offset"]},"results":{"type":"array","items":{"type":"object","description":"List of objects representing individual results","title":"MetadataSpecification","properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique ID for the entity, in UUID format."},"name":{"type":"string","minLength":1,"description":"Catalog specification name, for example: Build Coverage, Application Frameworks, Build Vulnerabilities."},"nrn":{"description":"NRN where the catalog specification is defined.","title":"NRN","type":"string","pattern":"^organization=(\\d+|\\*)+(?::account=(\\d+|\\*))?(?::namespace=(\\d+|\\*))?(?::application=(\\d+|\\*))?(?::(build|scope|release|asset|deployment)=(\\d+|\\*))?$"},"entity":{"type":"string","description":"Parent entity that holds metadata information.","enum":["organization","account","namespace","application","build","asset","scope","release","deployment","user"]},"metadata":{"type":"string","nullable":true,"minLength":1,"description":"Entity metadata key, for example: coverage, frameworks, vulnerabilities."},"description":{"type":"string","minLength":1,"description":"Catalog specification description."},"schema":{"type":"object","default":{},"description":"Catalog specification schema. Must be a valid JSON Schema."}},"example":{"id":"134544a6-a089-43ba-9d52-5b6e6e4fa8d1","name":"Namespace tags","description":"Add tags as key-value object to namespace entities","nrn":"organization=1","entity":"namespace","metadata":"tags","schema":{"type":"object","properties":{"my_string_property":{"type":"string","tag":true},"my_number_property":{"type":"number","default":0,"tag":"my_custom_tag_name"},"my_object_property":{"type":"object","properties":{"my_nested_property":{"type":"string"}}}},"required":["my_string_property"],"additionalProperties":false}}}}},"required":["paging","results"],"description":"Object representing pagination parameters for controlling the number and order of results"}}}},"4XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}},"5XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}}}}
>
  
</StatusCodes>