---
id: scope-domain-list
title: "List custom domains"
description: "List custom domains assigned to a scope."
sidebar_label: "List custom domains"
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 custom domains"}
>
</Heading>

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



List custom domains assigned to a scope.

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

<ParamsDetails
  parameters={[{"in":"query","name":"organization_id","schema":{"type":"string"},"required":true,"description":"The ID of the organization.","example":"1"},{"in":"query","name":"scope_id","schema":{"type":"string"},"description":"The ID of the scope.","example":"1234"},{"in":"query","name":"status","schema":{"type":"string","enum":["active","pending"]},"description":"The status of the domain."},{"in":"query","name":"name","schema":{"type":"string"},"description":"The name of the domain."}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","required":["paging","results"],"properties":{"paging":{"required":["offset","limit"],"properties":{"offset":{"type":"integer","minimum":0,"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},"limit":{"type":"integer","maximum":200,"description":"The maximum number of results to return per page. The maximum allowed value is 200.","example":200}}},"results":{"type":"array","items":{"type":"object","required":["id","name","type"],"properties":{"id":{"type":"string","description":"The application-wide unique ID for the custom domain.","example":"e78a0d21-3c48-7421-81cd-203fe84b8e47"},"name":{"type":"string","description":"The name of the custom domain.","example":"api.crypto-inc.com"},"type":{"type":"string","description":"The type of the domain.","example":"scope"},"selector":{"type":"object","description":"The selector for the custom domain.","properties":{"organization_id":{"type":"string","description":"The organization ID.","example":"1"},"nrn":{"type":"string","description":"The NRN of entity.","example":"organization=1:account=2:namespace=3:application=4"},"scope_id":{"type":"string","description":"The scope ID that the custom domains is associated with..","example":"1234"}}},"status":{"type":"string","description":"The status of the domain.","enum":["active","pending"],"example":"active"},"created_at":{"type":"string","description":"The ISO-8601 UTC timestamp of when the custom domain was created.","format":"date-time","example":"2025-01-02T00:00:00Z"},"updated_at":{"type":"string","description":"The ISO-8601 UTC timestamp of when the custom domain was last updated.","format":"date-time","example":"2025-02-02T00:00:00Z"}},"title":"scopeDomainResponse"}}},"title":"scopeDomainListResponse"}}}},"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>