---
id: provider-specification-list
title: "List provider specifications"
description: "Get a paginated list of providers specifications filtered by [NRN](/docs/NRN) and other queries"
sidebar_label: "List provider specifications"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/providers
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 provider specifications"}
>
</Heading>

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



Get a paginated list of providers specifications filtered by [NRN](/docs/NRN) and other queries

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

<ParamsDetails
  parameters={[{"schema":{"type":"integer","minimum":1},"in":"query","name":"limit","required":false,"description":"Limits the number of results returned per page"},{"schema":{"type":"integer","minimum":0},"in":"query","name":"offset","required":false,"description":"Specifies the offset for paginating through results"},{"schema":{"type":"string"},"in":"query","name":"slug","required":false,"description":"Unique slug for the provider specification"},{"schema":{"type":"string"},"in":"query","name":"name","required":false,"description":"Name of the provider specification"},{"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":true},{"schema":{"anyOf":[{"title":"IdList","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}$","description":"List of unique identifiers for the entity represented as a comma-separated list of UUID"},{"type":"array","items":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"}}]},"in":"query","name":"category","required":false,"description":"List of category IDs to filter by"}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Default Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"name":{"type":"string","description":"Name of the provider specification"},"slug":{"type":"string","description":"Unique slug for the provider specification"},"icon":{"type":"string","description":"Icon for the provider specification"},"description":{"type":"string","description":"Description of the provider specification"},"visible_to":{"type":"array","items":{"type":"string"},"description":"List of NRNs this specification is visible to"},"schema":{"type":"object","description":"[JSON Schema](https://json-schema.org/overview/what-is-jsonschema) for the provider specification.\nThis schema defines settings for any [nullplatform integrations](/docs/providers/supported-integrations).\nIt can also include custom JSON Schema keywords such as:\n\n• **tag** (boolean): Marks a property as auto-taggable, automatically creating a tag with the property's value.\n\n• **secret** (boolean): Marks a property as secret, ensuring the property's value is never revealed.\n\n• **groups** (array): Specifies configuration groups within the schema, automatically creating sections in the UI.\n"},"allow_dimensions":{"type":"boolean","description":"Flag to allow dimensions for this specification"},"default_dimensions":{"type":"object","description":"Default dimensions for the provider specification"},"tags":{"type":"array","description":"Tags associated with the providers","items":{"type":"object","properties":{"key":{"type":"string","description":"Tag key"},"value":{"type":"string","description":"Tag value"},"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"}},"required":["key","value","id"],"additionalProperties":false}},"categories":{"type":"array","items":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"description":"IDs of associated categories"},"dependencies":{"type":"array","items":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"description":"IDs of associated dependencies"},"organization_id":{"type":"integer","nullable":true,"description":"Organization ID that owns this specification. NULL means global (nullplatform-managed)"},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp"},"updated_at":{"type":"string","format":"date-time","description":"Last update timestamp"}},"title":"ProviderSpecificationRead","description":"Object representing a provider specification resource","required":["id","name","slug","schema","allow_dimensions","created_at","updated_at"]}}}}},"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>