---
id: checklist-specification-list
title: "List checklist specifications"
description: "Lists the checklist specifications visible at an NRN."
sidebar_label: "List checklist specifications"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/approval
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 checklist specifications"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/approval/checklist/specification"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Lists the checklist specifications visible at an NRN.

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

<ParamsDetails
  parameters={[{"in":"query","name":"nrn","schema":{"type":"string"},"required":true,"description":"The NRN to list specifications for.","example":"organization=1:account=2:namespace=3"},{"in":"query","name":"status","schema":{"type":"string","enum":["active","deleted"]},"description":"Filter by status.","example":"active"},{"in":"query","name":"latest_only","schema":{"type":"boolean"},"description":"Return only the newest version of each specification instead of the whole family."},{"in":"query","name":"show_descendants","schema":{"type":"boolean"},"description":"Include specifications defined below the given NRN."},{"in":"query","name":"name:contains","schema":{"type":"string"},"description":"Filter by a substring of the name.","example":"deploy-gate"},{"in":"query","name":"offset","schema":{"type":"integer"},"description":"Number of results to skip.","example":0},{"in":"query","name":"limit","schema":{"type":"integer"},"description":"Maximum number of results to return.","example":20},{"in":"query","name":"sort","schema":{"type":"string"},"description":"Field to sort by.","example":"created_at"}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"properties":{"results":{"type":"array","description":"The specifications on this page of results.","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifier of this specification version.","example":"spec_abc123def456ghij"},"nrn":{"type":"string","description":"Where the specification applies. Child resources inherit it.","example":"organization=1:account=2:namespace=3"},"name":{"type":"string","description":"Shared by every version of this specification.","example":"staging-deploy-gate"},"description":{"type":"string","description":"What this checklist enforces.","example":"Coverage, Snyk, and security sign-off, with a CAB override."},"status":{"type":"string","enum":["active","deleted"],"description":"Whether the specification is live or was soft-deleted.","example":"active"},"version":{"type":"integer","description":"Version number within the name and NRN.","example":1},"definition":{"type":"object","description":"The items, and optionally an aggregation block."},"derived_expression":{"type":"string","description":"The boolean expression nullplatform computes the outcome with.","example":"( coverage_gate.passed AND security_signoff.passed ) OR cab_override.passed"},"created_by":{"type":"string","description":"ID of the user who published this version.","example":"4321"},"created_at":{"type":"string","format":"date-time","description":"When this version was published.","example":"2026-08-28T14:12:03.000Z"},"updated_at":{"type":"string","format":"date-time","description":"When this version was last modified.","example":"2026-08-28T14:12:03.000Z"},"warnings":{"type":"array","description":"Non-blocking notes the validator raised when the version was saved.","items":{"type":"string"},"example":[]},"versions":{"type":"array","description":"Every version published under the same name and NRN. Only on a read with `include_versions=true`.","items":"circular(ChecklistSpecification)"},"associated_actions":{"type":"array","description":"Approval actions currently pointing at this version. Only on a read of a single specification, and absent rather than empty when it was not resolved.","items":{"type":"object"},"example":[{"id":1842,"nrn":"organization=1:account=2:namespace=3","entity":"deployment","action":"deployment:create"}]}},"title":"ChecklistSpecification"}},"total":{"type":"integer","description":"Total number of specifications matching the query.","example":3},"offset":{"type":"integer","description":"Number of results skipped.","example":0},"limit":{"type":"integer","description":"Maximum number of results returned.","example":20}}}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>