1---
2id: get-iceberg-namespaces
3title: "List Iceberg namespaces"
4description: "This endpoint retrieves namespaces available in the Iceberg catalog."
5sidebar_label: "List Iceberg namespaces"
6hide_title: true
7hide_table_of_contents: true
8api: eJztV99v2zYQ/leIe1ZsJ0uBVW9Zm24GOhdo0ifPcGjqbF1HkSxJKQkM/e/F6Yclz0Y6YAOGFX2ycUfe3ffdR+q4hyh3AdIlzBVu0O9glUCGQXlykayBFO5zCgJN5iyZKDxGT1hhEEYWGJxUGISsJGm50SjIiJij6IIJJaPUdjf5w8y3QooHJz2a+DDsFRSE87aiDLNEUBSPpLXQFGITR+Wks3Gm0mToG1dwqGhLmIk26AQSsA695LLnGaSww7imtpD1EAIScNLLAiN6Br4H9kEKbRhIgBj1lxL9M5xygV26EYStt4V4zEnlItoDQSe1c4Eev5TkMYN0K3XABILKsZCQ7iE+O67Cbj6jikdLl1xaDNwZ5xliJAy8pTUPe6X3kmumiMXYHqIns4O6rhOIFDXbFn1dUNcrzhacNaGNezWb8c8x9MXQhB5iJkKpFIawLbXmxMqayByme5DOaVJNM6afA0fY/02wo1adIB75vg37v6DynDl87MiFOgF8koVj/zGY5aGEJXSHZi1hVSdn7BvodbO+hFW9qpu01+ea9ovMBKPHEP+t9qD31p8S2Jq/sbfAEOQOIWlXcUUZnsZqrEMoMhF36CGBrfWFjK3ppytIoCBDRVlAOquTQ/TTbnX5ThwJoOHdS1jYu1Llh5bdPilsOUyYw48thWPr3ET0Ruo79BX6256UvvndBdjY7znnWBlj5zlHr5duwZFoDjwf0MLcVFLT6KoZtbzDex5Dy/P1bFb3Erp+4dwLY6PY2tJkP6T0vUppaHb/URaZ5W+9jQKfaCypF2D2urrudPXq3NXUoxahgS3aan4o6ztV1qHdbS2i2ZaKt+/Wd29+u/39Zr34cL9+9+HT4u0gsXPl9+p61d1aDaUxt93A10x3MYcUptXltJv+pkfTX6u39ptbeg0p5DG6dDrVVkmd2xDTn2evZyez33t2iwwr1NYVPAK2kSbijTVb2pUexSPFXDxcXHDEhwnwZBVQlZ7ic5NPOlr/ifx/xT4yW9s0vKPWlyZSgWfHzuBIYSaGJZoU8lCRHibYGydVjhdXEy6eMjSRB2R/7KkTYPht4MvJ68kVm5wNsZBmFOw9z+D9HH9E4FFt++HA/p9eCp3CIj7FqdOSDJPQqGHfCWgJ1SXT2D2Lkr/MpawTXrTfb2TAT17XNZvbZwO3OqPAOIdR/wXa/tmj4iyWRmXDm6aSuuRFjSQr6Ylra2SYQI4yY5Us992uG8VXyGjXyUXMUQ7H7tfbe6jrrxya+Uc=
9sidebar_class_name: "get api-method"
10info_path: docs/api/HTTP/runtime
11custom_edit_url: null
12proxy: http://localhost:8090
13---
14
15import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
16import ParamsDetails from "@theme/ParamsDetails";
17import RequestSchema from "@theme/RequestSchema";
18import StatusCodes from "@theme/StatusCodes";
19import OperationTabs from "@theme/OperationTabs";
20import TabItem from "@theme/TabItem";
21import Heading from "@theme/Heading";
22
23<Heading
24 as={"h1"}
25 className={"openapi__heading"}
26 children={"List Iceberg namespaces"}
27>
28</Heading>
29
30<MethodEndpoint
31 method={"get"}
32 path={"/v1/iceberg/namespaces"}
33 context={"endpoint"}
34>
35
36</MethodEndpoint>
37
38
39
40This endpoint retrieves namespaces available in the Iceberg catalog.
41If a `parent` namespace is provided, it will list the child namespaces under the specified parent.
42
43<Heading
44 id={"request"}
45 as={"h2"}
46 className={"openapi-tabs__heading"}
47 children={"Request"}
48>
49</Heading>
50
51<ParamsDetails
52 parameters={[{"name":"parent","in":"query","description":"The parent namespace from which to retrieve child namespaces.","required":false,"schema":{"type":"object","required":["parts"],"properties":{"parts":{"type":"array","items":{"type":"string"}}},"title":"Namespace"}}]}
53>
54
55</ParamsDetails>
56
57<RequestSchema
58 title={"Body"}
59 body={undefined}
60>
61
62</RequestSchema>
63
64<StatusCodes
65 id={undefined}
66 label={undefined}
67 responses={{"200":{"description":"Namespaces retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["namespaces"],"properties":{"namespaces":{"type":"array","items":{"type":"object","required":["parts"],"properties":{"parts":{"type":"array","items":{"type":"string"}}},"title":"Namespace"}}},"title":"NamespacesResponse"},"example":{"namespaces":[{"parts":["catalog_a"]},{"parts":["catalog_b","schema_1"]}]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message","type","code"],"properties":{"code":{"type":"integer","format":"int32","minimum":0},"message":{"type":"string"},"type":{"type":"string","enum":["NoSuchNamespaceException","BadRequestException","InternalServerError"],"title":"IcebergErrorType"}},"title":"IcebergError"}},"title":"IcebergResponseError"},"example":{"error":{"message":"Invalid namespace request","type":"BadRequestException","code":400}}}}},"404":{"description":"Namespace not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message","type","code"],"properties":{"code":{"type":"integer","format":"int32","minimum":0},"message":{"type":"string"},"type":{"type":"string","enum":["NoSuchNamespaceException","BadRequestException","InternalServerError"],"title":"IcebergErrorType"}},"title":"IcebergError"}},"title":"IcebergResponseError"},"example":{"error":{"message":"Namespace provided does not exist","type":"NoSuchNamespaceException","code":404}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message","type","code"],"properties":{"code":{"type":"integer","format":"int32","minimum":0},"message":{"type":"string"},"type":{"type":"string","enum":["NoSuchNamespaceException","BadRequestException","InternalServerError"],"title":"IcebergErrorType"}},"title":"IcebergError"}},"title":"IcebergResponseError"},"example":{"error":{"message":"Internal Server Error: DF_SCHEMA_NOT_FOUND","type":"InternalServerError","code":500}}}}}}}
68>
69
70</StatusCodes>
71
72
73
1---
2id: get-iceberg-namespaces
3title: "List Iceberg namespaces"
4description: "This endpoint retrieves namespaces available in the Iceberg catalog."
5sidebar_label: "List Iceberg namespaces"
6hide_title: true
7hide_table_of_contents: true
8api: eJztV99v2zYQ/leIe1ZsJ0uBVW9Zm24GOhdo0ifPcGjqbF1HkSxJKQkM/e/F6Yclz0Y6YAOGFX2ycUfe3ffdR+q4hyh3AdIlzBVu0O9glUCGQXlykayBFO5zCgJN5iyZKDxGT1hhEEYWGJxUGISsJGm50SjIiJij6IIJJaPUdjf5w8y3QooHJz2a+DDsFRSE87aiDLNEUBSPpLXQFGITR+Wks3Gm0mToG1dwqGhLmIk26AQSsA695LLnGaSww7imtpD1EAIScNLLAiN6Br4H9kEKbRhIgBj1lxL9M5xygV26EYStt4V4zEnlItoDQSe1c4Eev5TkMYN0K3XABILKsZCQ7iE+O67Cbj6jikdLl1xaDNwZ5xliJAy8pTUPe6X3kmumiMXYHqIns4O6rhOIFDXbFn1dUNcrzhacNaGNezWb8c8x9MXQhB5iJkKpFIawLbXmxMqayByme5DOaVJNM6afA0fY/02wo1adIB75vg37v6DynDl87MiFOgF8koVj/zGY5aGEJXSHZi1hVSdn7BvodbO+hFW9qpu01+ea9ovMBKPHEP+t9qD31p8S2Jq/sbfAEOQOIWlXcUUZnsZqrEMoMhF36CGBrfWFjK3ppytIoCBDRVlAOquTQ/TTbnX5ThwJoOHdS1jYu1Llh5bdPilsOUyYw48thWPr3ET0Ruo79BX6256UvvndBdjY7znnWBlj5zlHr5duwZFoDjwf0MLcVFLT6KoZtbzDex5Dy/P1bFb3Erp+4dwLY6PY2tJkP6T0vUppaHb/URaZ5W+9jQKfaCypF2D2urrudPXq3NXUoxahgS3aan4o6ztV1qHdbS2i2ZaKt+/Wd29+u/39Zr34cL9+9+HT4u0gsXPl9+p61d1aDaUxt93A10x3MYcUptXltJv+pkfTX6u39ptbeg0p5DG6dDrVVkmd2xDTn2evZyez33t2iwwr1NYVPAK2kSbijTVb2pUexSPFXDxcXHDEhwnwZBVQlZ7ic5NPOlr/ifx/xT4yW9s0vKPWlyZSgWfHzuBIYSaGJZoU8lCRHibYGydVjhdXEy6eMjSRB2R/7KkTYPht4MvJ68kVm5wNsZBmFOw9z+D9HH9E4FFt++HA/p9eCp3CIj7FqdOSDJPQqGHfCWgJ1SXT2D2Lkr/MpawTXrTfb2TAT17XNZvbZwO3OqPAOIdR/wXa/tmj4iyWRmXDm6aSuuRFjSQr6Ylra2SYQI4yY5Us992uG8VXyGjXyUXMUQ7H7tfbe6jrrxya+Uc=
9sidebar_class_name: "get api-method"
10info_path: docs/api/HTTP/runtime
11custom_edit_url: null
12proxy: http://localhost:8090
13---
14
15import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
16import ParamsDetails from "@theme/ParamsDetails";
17import RequestSchema from "@theme/RequestSchema";
18import StatusCodes from "@theme/StatusCodes";
19import OperationTabs from "@theme/OperationTabs";
20import TabItem from "@theme/TabItem";
21import Heading from "@theme/Heading";
22
23<Heading
24 as={"h1"}
25 className={"openapi__heading"}
26 children={"List Iceberg namespaces"}
27>
28</Heading>
29
30<MethodEndpoint
31 method={"get"}
32 path={"/v1/iceberg/namespaces"}
33 context={"endpoint"}
34>
35
36</MethodEndpoint>
37
38
39
40This endpoint retrieves namespaces available in the Iceberg catalog.
41If a `parent` namespace is provided, it will list the child namespaces under the specified parent.
42
43<Heading
44 id={"request"}
45 as={"h2"}
46 className={"openapi-tabs__heading"}
47 children={"Request"}
48>
49</Heading>
50
51<ParamsDetails
52 parameters={[{"name":"parent","in":"query","description":"The parent namespace from which to retrieve child namespaces.","required":false,"schema":{"type":"object","required":["parts"],"properties":{"parts":{"type":"array","items":{"type":"string"}}},"title":"Namespace"}}]}
53>
54
55</ParamsDetails>
56
57<RequestSchema
58 title={"Body"}
59 body={undefined}
60>
61
62</RequestSchema>
63
64<StatusCodes
65 id={undefined}
66 label={undefined}
67 responses={{"200":{"description":"Namespaces retrieved successfully","content":{"application/json":{"schema":{"type":"object","required":["namespaces"],"properties":{"namespaces":{"type":"array","items":{"type":"object","required":["parts"],"properties":{"parts":{"type":"array","items":{"type":"string"}}},"title":"Namespace"}}},"title":"NamespacesResponse"},"example":{"namespaces":[{"parts":["catalog_a"]},{"parts":["catalog_b","schema_1"]}]}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message","type","code"],"properties":{"code":{"type":"integer","format":"int32","minimum":0},"message":{"type":"string"},"type":{"type":"string","enum":["NoSuchNamespaceException","BadRequestException","InternalServerError"],"title":"IcebergErrorType"}},"title":"IcebergError"}},"title":"IcebergResponseError"},"example":{"error":{"message":"Invalid namespace request","type":"BadRequestException","code":400}}}}},"404":{"description":"Namespace not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message","type","code"],"properties":{"code":{"type":"integer","format":"int32","minimum":0},"message":{"type":"string"},"type":{"type":"string","enum":["NoSuchNamespaceException","BadRequestException","InternalServerError"],"title":"IcebergErrorType"}},"title":"IcebergError"}},"title":"IcebergResponseError"},"example":{"error":{"message":"Namespace provided does not exist","type":"NoSuchNamespaceException","code":404}}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message","type","code"],"properties":{"code":{"type":"integer","format":"int32","minimum":0},"message":{"type":"string"},"type":{"type":"string","enum":["NoSuchNamespaceException","BadRequestException","InternalServerError"],"title":"IcebergErrorType"}},"title":"IcebergError"}},"title":"IcebergResponseError"},"example":{"error":{"message":"Internal Server Error: DF_SCHEMA_NOT_FOUND","type":"InternalServerError","code":500}}}}}}}
68>
69
70</StatusCodes>
71
72
73