---
id: service-specification-list
title: "List service specifications"
description: "List service specifications"
sidebar_label: "List service specifications"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/nullplatform-api
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 service specifications"}
>
</Heading>

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



List service specifications

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

<ParamsDetails
  parameters={[{"schema":{"anyOf":[{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},{"type":"string","pattern":"^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12},\\s*)*[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"}]},"in":"query","name":"id","required":false},{"schema":{"title":"NRN","type":"string","pattern":"^organization=[0-9*]+(:account=[0-9*]+)?(:namespace=[0-9*]+)?(:application=[0-9*]+)?(:scope=[0-9*]+)?$","description":"Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources"},"in":"query","name":"nrn","required":false},{"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":"Specifies the offset for paginating through results"},{"schema":{"type":"string","enum":["dependency","scope"]},"in":"query","name":"type","required":false,"description":"Type of the service specification. Should be one of the specified values in the enumeration"}]}
>
  
</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":"ServiceSpecificationList","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","properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"name":{"type":"string","minLength":1,"not":{"enum":[null]},"description":"Name of the entity. Must be a non-empty string and not equal to null"},"slug":{"type":"string","minLength":1,"not":{"enum":[null]},"description":"Slug of the specification. Automatically generated from \"name\""},"created_at":{"type":"string","format":"date"},"updated_at":{"type":"string","format":"date"},"visible_to":{"title":"Visibility","type":"array","description":"Array representing visibility settings for the entity. Specifies what/who can see this entity","items":{"title":"NRN","type":"string","pattern":"^organization=[0-9*]+(:account=[0-9*]+)?(:namespace=[0-9*]+)?(:application=[0-9*]+)?(:scope=[0-9*]+)?$","description":"Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources"}},"attributes":{"title":"Attribute","type":"object","properties":{"schema":{"type":"object","default":{},"description":"Specification of the attribute schema. Must be a valid JSON Schema"},"values":{"type":"object","default":{},"description":"Values associated with the attribute. Must validate against provided schema"}},"required":["schema","values"],"propertyNames":{"enum":["schema","values"],"description":"Allowed property names"},"additionalProperties":false,"description":"Object representing an attribute with a schema and associated values"},"selectors":{"title":"Selector","type":"object","properties":{"imported":{"type":"boolean","default":false},"provider":{"type":"string","minLength":1,"maxLength":100,"default":"any"},"category":{"type":"string","minLength":1,"maxLength":100,"default":"any"},"sub_category":{"type":"string","minLength":1,"maxLength":100,"default":"any"}},"additionalProperties":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"description":"Key-value object representing instance selectors"},"type":{"type":"string","enum":["dependency","scope"],"description":"Type of the service specification. Should be one of the specified values in the enumeration"},"dimensions":{"title":"Specification Dimension","type":"object","properties":{},"additionalProperties":{"type":"object","properties":{"required":{"type":"boolean"},"values":{"type":"array","items":{"type":"string"}}},"additionalProperties":false,"required":["required"]}},"scopes":{"title":"Specification Scope","type":"object","properties":{"provider":{"type":"object","properties":{"values":{"type":"array","items":{"oneOf":[{"type":"string","enum":["AWS:SERVERLESS:LAMBDA","AWS:WEB_POOL:EC2INSTANCES","AWS:WEB_POOL:EKS","AZURE:WEB_POOL:AKS","GOOGLE:WEB_POOL:GKE","OCI:WEB_POOL:OKE"]},{"type":"string","format":"uuid","description":"UUID of a scope specification"}]},"minItems":1}},"additionalProperties":false,"required":["values"]}},"additionalProperties":false},"assignable_to":{"type":"string","enum":["any","dimension","scope"],"description":"Specifies if the service can be assigned to any entity, only dimensions, or only scopes."},"use_default_actions":{"type":"boolean","description":"Specifies if the service specification should autogenerate its create, update, and delete actions from the attributes schema. When omitted on create, the default is true for every type except `scope`"},"use_default_naming":{"type":"boolean","description":"When true, the instance name is optional and generated by nullplatform or taken from the schema's `name` property. When false, a caller-provided name is required. Defaults to true for new specifications"},"package_id":{"type":"string","format":"uuid","nullable":true,"description":"The package that owns this service specification. Set automatically when a package revision that includes the specification is published; a specification belongs to at most one package. `PATCH` can point it at another package or clear it with `null` to release the claim, for example after deleting the package. The change is refused while any instance of the specification is bound to a package revision, current or desired"}},"description":"Object representing service specifications","additionalProperties":false,"title":"ServiceSpecification","example":{"name":"my-service-specification","visible_to":["organization=1:account=1","organization=1:account=2"],"dimensions":{"environment":{"required":true,"values":["production","staging"]}},"scopes":{"provider":{"values":["AWS:SERVERLESS:LAMBDA","AWS:WEB_POOL:EC2INSTANCES","uuid-of-a-specific-scope-specification"]}},"assignable_to":"any","attributes":{"schema":{"type":"object","properties":{"my_string_property":{"type":"string"},"my_number_property":{"type":"number","default":0}},"required":["my_string_property"]},"values":{}}}}}},"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>