---
id: provider-read
title: "Read a provider"
description: "Read a provider by ID. The attributes are resolved with [inheritance](/docs/providers/overview#provider-inheritance) by default"
sidebar_label: "Read a provider"
hide_title: true
hide_table_of_contents: true
api: eJztWG1v2zYQ/isEtw/JJsUvsdNEwDAUfdkyDF6QOlgxIytO4tliK5EqSTn1DP334SjJlh2na7sB2Yd+Skwd7567e+4RqTXXBRpwUqtLwSNeGL2UAk1kEAQPuIOF5dGMXzXr/DbgAm1iZEF7eMSvEQQD1m5k8YpdPj9h0xQZOGdkXDq0DAwyg1ZnSxTsTrqUzaRK0UgHKsHbo57Qie21TmxPL9EsJd590y6FHfNjCiJwDmXmeMALMJCjQ0NI19wmKebAozV3qwJ5xGOtMwTFCXm9J5pDZrEKuKQM3pdoVjzgCnIyV/pNjmaBPOAG35fSoGg27Kf+qsBEziVadpeiS9Ewp5nf2009lWjAJKlMIMtWvAp2IEqXUdBLX+war3VGqgUP+FybHByPeFlKwfej3yj5vkQmBSpHKAyba8NciowW3IoZLAxaVA4FA8uA3dxcPudt1gW4dJu0979N15kSq9uAW0xKI93KFzZGMGieli7l0eyWHhu0hVYWLaUyfP2a/uyC/C1+i4nbQpFq0SULUaI0CdU60cqhcuQCiiKTiSdl760lPwe6qr1nHnAQQpIpZFeGyOwk4WkaVnSW1pTlY9VcGdWNPbmeHAhegHNIhvxPbRag5F++CD/M+uHFd7ffH0WQJLpUrl04/vEoogbaAhLsLnYq2F22iS46dt/ey29SZlmRgaMqsOumOWwCObKjyfXkeL+RXW7vV0V1fbWNtlQLW89Nje/NIzZlO6WHiLUbpVXAsEXfnXGBc6lQMKl83J0EWUPdKuBC5qis1OoT4k2uJ9tQ240nbOYVN9dmI5vbp8cUpdbsjX8wBlb33E9hYRlYqxMJrtVkwt7OJg+4dJgfRLo7Ve9w1THaNO1ePEaGVcCXkJX4aTtqU5KsxyJJ1ZXFmc+1zcCjuv2oANH2hdFlcagh++VtMqn2of/kHXy8WVXAE4P08A24Q7XdVEeAw9DJHO+V6Bk5IMLSU+sgL8htWYh/5/ZXsI7VXrqeiahNO9vRuq7PHF/6BsEPkBcZtkLP4XQ+SIZiFOI4PgufnF/0Q4gHwzAROD8djc9ohTfKzHf0drAR2kFHXwd8f4JRLaXRKvfvLZoKUSYe9kGR4/3hXAyH80F4Fs8vwtEAILyIx+fh8EKM+/Mnw/H5eMz3VSnJSuvQbLLKV6EqwkVShBSPBzzTdQxqS3iH1g2a17pH3ezY/CRCgsM78DNblHEmkzfNISBfhfVC2JrQqMslOOya1Csbm2ojObMG4giHp/0zgeH5EE/DUfxkFMJocBFiH0+HoxjjcZ8K73Wjze/Ez2wjDftJ0lmjS28+7A9H4aAfDsbT/nl02o/6/T/4Llc3NsP+dDCKRmNvszfOPigR4EC/dhqxE38n0G1VUQVGh04/L/10eKXZ4S8ao41loqQpYk+vLplUDg148tjPOgw1I/SCPG5F8QGltg5caZ9p0ZVfVeaxl/td7D9Pp1es3sASLZBJJTwOtahl00ck3dl194CaN/rrd9X+6qrM0aBKkIESLAGHC22aKSTfdZB/dP4q1cYFLC1zUCHdXCDO2li0k1HM2rl/A+VoLSw+AfVzdCAzFI2vZl+jPl6JNtrPfM8+OD8P/xENulTt9K6tyzaRhoTjryT8SsLHJaFPzKWa3gMLrK/ndGHkm8t9by1FRYKLZtne2UuT8YinzhU26vWgkCfd28NJonPevY6+IurVbOpeSjeFJEcUwZvRFwBvxIPmn5ftoeWX36e+UlLNdZfI7YGE0ieMdQX7J/2TAXWu0Nbl4IegeS3ufQTZb+F6O0v/g+8lTZGIJ70iA+lJ7juwbpo1451MovqUm2rr6Ml6HYPFG5NVFS3XH0+oh0JaYvwDH0u6Jfii7yYP4K4PEZ1vNu0RwhNmCUYSqM8EeHTdcP6YPRS3PcurVTdmi0fSmaUKeIpARaTo9YOnSYKF62y5p6wEezNBP72Y0jlkl917bPbeD8JZr2uLqX6Hqqo26Bz9JoBV9Tftl/Fr
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={"Read a provider"}
>
</Heading>

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



Read a provider by ID. The attributes are resolved with [inheritance](/docs/providers/overview#provider-inheritance) by default

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

<ParamsDetails
  parameters={[{"schema":{"type":"boolean","default":false},"in":"query","name":"no_merge","required":false,"description":"Specifies whether to merge attributes hierarchically"},{"schema":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"in":"path","name":"id","required":true}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Object representing a provider resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"nrn":{"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"},"specification_id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"attributes":{"type":"object","description":"Provider-specific attributes defined in the specification schema"},"dimensions":{"type":"object","description":"NRN-specific dimensions. [Read more](/docs/dimensions)"},"tags":{"type":"array","description":"Tags associated with the provider","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}},"groups":{"type":"array","items":{"type":"string"},"description":"Groups associated with the provider"},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp"},"updated_at":{"type":"string","format":"date-time","description":"Last update timestamp"}},"title":"ProviderRead","description":"Object representing a provider resource","example":{"id":"a3f1c2d4-e5b6-7890-ab12-cdef34567890","nrn":"organization=1:account=1:namespace=1","dimensions":{"environment":"production"},"specification_id":"02fd22f1-6bf9-41aa-9b58-29d50f725855","attributes":{"cluster":{"id":"my-np-gcp-prod","location":"s-west1","namespace":"my-namespace"},"gateway":{"public_name":"my-public-gateway","private_name":"my-private-gateway"}},"tags":[{"id":"4e2306de-82e3-4b74-a419-e0e324beb500","key":"cluster.id","value":"my-np-gcp-prod"}],"created_at":"2024-10-15T08:30:00Z","updated_at":"2024-10-20T14:45:00Z"},"required":["id","nrn","specification_id","attributes","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>