---
title: "GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}"
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}"
tags: ["CognitiveServicesAccounts"]
---

# GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Returns a Cognitive Services account specified by the parameters.

## Path parameters

- `subscriptionId` string, required
- `resourceGroupName` string, required
- `accountName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

Azure operation completed successfully.

- Account: Cognitive Services account is an Azure resource representing the provisioned account, it's type, location and SKU.
  - `id` string: Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
  - `name` string: The name of the resource
  - `type` string: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
  - `systemData` SystemData: Metadata pertaining to creation and last modification of the resource.
    - `createdBy` string: The identity that created the resource.
    - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that created the resource.
    - `createdAt` string, date-time: The timestamp of resource creation (UTC).
    - `lastModifiedBy` string: The identity that last modified the resource.
    - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that last modified the resource.
    - `lastModifiedAt` string, date-time: The timestamp of resource last modification (UTC)
  - `properties` AccountProperties: Properties of Cognitive Services account.
    - `provisioningState` 'Accepted' | 'Creating' | 'Deleting' | 'Moving' | 'Failed' | 'Succeeded' | 'Canceled' | 'ResolvingDNS': Gets the status of the cognitive services account at the time the operation was called.
    - `endpoint` string: Endpoint of the created account.
    - `internalId` string: The internal identifier (deprecated, do not use this property).
    - `capabilities` SkuCapability[]: Gets the capabilities of the cognitive services account. Each item indicates the capability of a specific feature. The values are read-only and for reference only.
      - `name` string: The name of the SkuCapability.
      - `value` string: The value of the SkuCapability.
    - `isMigrated` boolean: If the resource is migrated from an existing key.
    - `migrationToken` string: Resource migration token.
    - `skuChangeInfo` SkuChangeInfo: Sku change info of account.
      - `countOfDowngrades` number, float: Gets the count of downgrades.
      - `countOfUpgradesAfterDowngrades` number, float: Gets the count of upgrades after downgrades.
      - `lastChangeDate` string: Gets the last change date.
    - `customSubDomainName` string: Optional subdomain name used for token-based authentication.
    - `networkAcls` NetworkRuleSet: A set of rules governing the network accessibility.
      - `defaultAction` 'Allow' | 'Deny': The default action when no rule from ipRules and from virtualNetworkRules match. This is only used after the bypass property has been evaluated.
      - `bypass` 'None' | 'AzureServices': Setting for trusted services.
      - `ipRules` IpRule[]: The list of IP address rules.
        - `value` string, required: An IPv4 address range in CIDR notation, such as '124.56.78.91' (simple IP address) or '124.56.78.0/24' (all addresses that start with 124.56.78).
      - `virtualNetworkRules` VirtualNetworkRule[]: The list of virtual network rules.
        - `id` string, required: Full resource id of a vnet subnet, such as '/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'.
        - `state` string: Gets the state of virtual network rule.
        - `ignoreMissingVnetServiceEndpoint` boolean: Ignore missing vnet service endpoint or not.
    - `encryption` Encryption: Properties to configure Encryption
      - `keyVaultProperties` KeyVaultProperties: Properties to configure keyVault Properties
        - `keyName` string: Name of the Key from KeyVault
        - `keyVersion` string: Version of the Key from KeyVault
        - `keyVaultUri` string: Uri of KeyVault
        - `identityClientId` string
      - `keySource` 'Microsoft.CognitiveServices' | 'Microsoft.KeyVault': Enumerates the possible value of keySource for Encryption
    - `userOwnedStorage` UserOwnedStorage[]: The storage accounts for this resource.
      - `resourceId` string: Full resource id of a Microsoft.Storage resource.
      - `identityClientId` string
    - `amlWorkspace` UserOwnedAmlWorkspace: The user owned AML account for Cognitive Services account.
      - `resourceId` string: Full resource id of a AML account resource.
      - `identityClientId` string: Identity Client id of a AML account resource.
    - `privateEndpointConnections` PrivateEndpointConnection[]: The private endpoint connection associated with the Cognitive Services account.
      - `id` string: Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
      - `name` string: The name of the resource
      - `type` string: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
      - `systemData` SystemData: Metadata pertaining to creation and last modification of the resource.
        - `createdBy` string: The identity that created the resource.
        - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that created the resource.
        - `createdAt` string, date-time: The timestamp of resource creation (UTC).
        - `lastModifiedBy` string: The identity that last modified the resource.
        - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that last modified the resource.
        - `lastModifiedAt` string, date-time: The timestamp of resource last modification (UTC)
      - `properties` PrivateEndpointConnectionProperties: Properties of the PrivateEndpointConnectProperties.
        - `privateEndpoint` PrivateEndpoint: The Private Endpoint resource.
          - `id` string: The ARM identifier for Private Endpoint
        - `privateLinkServiceConnectionState` PrivateLinkServiceConnectionState, required: A collection of information about the state of the connection between service consumer and provider.
          - `status` 'Pending' | 'Approved' | 'Rejected': The private endpoint connection status.
          - `description` string: The reason for approval/rejection of the connection.
          - `actionsRequired` string: A message indicating if changes on the service provider require any updates on the consumer.
        - `provisioningState` 'Succeeded' | 'Creating' | 'Deleting' | 'Failed': The current provisioning state.
        - `groupIds` string[]: The private link resource group ids.
      - `etag` string: Resource Etag.
      - `location` string: The location of the private endpoint connection
    - `publicNetworkAccess` 'Enabled' | 'Disabled': Whether or not public endpoint access is allowed for this account.
    - `apiProperties` ApiProperties: The api properties for special APIs.
      - `qnaRuntimeEndpoint` string: (QnAMaker Only) The runtime endpoint of QnAMaker.
      - `qnaAzureSearchEndpointKey` string: (QnAMaker Only) The Azure Search endpoint key of QnAMaker.
      - `qnaAzureSearchEndpointId` string: (QnAMaker Only) The Azure Search endpoint id of QnAMaker.
      - `statisticsEnabled` boolean: (Bing Search Only) The flag to enable statistics of Bing Search.
      - `eventHubConnectionString` string: (Personalization Only) The flag to enable statistics of Bing Search.
      - `storageAccountConnectionString` string: (Personalization Only) The storage account connection string.
      - `aadClientId` string: (Metrics Advisor Only) The Azure AD Client Id (Application Id).
      - `aadTenantId` string: (Metrics Advisor Only) The Azure AD Tenant Id.
      - `superUser` string: (Metrics Advisor Only) The super user of Metrics Advisor.
      - `websiteName` string: (Metrics Advisor Only) The website name of Metrics Advisor.
    - `dateCreated` string: Gets the date of cognitive services account creation.
    - `callRateLimit` CallRateLimit: The call rate limit Cognitive Services account.
      - `count` number, float: The count value of Call Rate Limit.
      - `renewalPeriod` number, float: The renewal period in seconds of Call Rate Limit.
      - `rules` ThrottlingRule[]
        - `key` string
        - `renewalPeriod` number, float
        - `count` number, float
        - `minCount` number, float
        - `dynamicThrottlingEnabled` boolean
        - `matchPatterns` RequestMatchPattern[]
          - `path` string
          - `method` string
    - `dynamicThrottlingEnabled` boolean: The flag to enable dynamic throttling.
    - `storedCompletionsDisabled` boolean: The flag to disable stored completions.
    - `quotaLimit` QuotaLimit
      - `count` number, float
      - `renewalPeriod` number, float
      - `rules` ThrottlingRule[]
        - `key` string
        - `renewalPeriod` number, float
        - `count` number, float
        - `minCount` number, float
        - `dynamicThrottlingEnabled` boolean
        - `matchPatterns` RequestMatchPattern[]
          - `path` string
          - `method` string
    - `restrictOutboundNetworkAccess` boolean
    - `allowedFqdnList` string[]
    - `disableLocalAuth` boolean
    - `endpoints` object: Dictionary of <string>
    - `restore` boolean
    - `deletionDate` string: The deletion date, only available for deleted account.
    - `scheduledPurgeDate` string: The scheduled purge date, only available for deleted account.
    - `locations` MultiRegionSettings: The multiregion settings Cognitive Services account.
      - `routingMethod` 'Priority' | 'Weighted' | 'Performance': Multiregion routing methods.
      - `regions` RegionSetting[]
        - `name` string: Name of the region.
        - `value` number, float: A value for priority or weighted routing methods.
        - `customsubdomain` string: Maps the region to the regional custom subdomain.
    - `commitmentPlanAssociations` CommitmentPlanAssociation[]: The commitment plan associations of Cognitive Services account.
      - `commitmentPlanId` string: The Azure resource id of the commitment plan.
      - `commitmentPlanLocation` string: The location of of the commitment plan.
    - `abusePenalty` AbusePenalty: The abuse penalty.
      - `action` 'Throttle' | 'Block': The action of AbusePenalty.
      - `rateLimitPercentage` number, float: The percentage of rate limit.
      - `expiration` string, date-time: The datetime of expiration of the AbusePenalty.
    - `raiMonitorConfig` RaiMonitorConfig: Cognitive Services Rai Monitor Config.
      - `adxStorageResourceId` string: The storage resource Id.
      - `identityClientId` string: The identity client Id to access the storage.
    - `networkInjections` NetworkInjection[]
      - `scenario` 'none' | 'agent': Specifies what features in AI Foundry network injection applies to. Currently only supports 'agent' for agent scenarios. 'none' means no network injection.
      - `subnetArmId` string, arm-id: Specify the subnet for which your Agent Client is injected into.
      - `useMicrosoftManagedNetwork` boolean: Boolean to enable Microsoft Managed Network for subnet delegation
    - `foundryAutoUpgrade` FoundryAutoUpgrade: Represents the foundry auto-upgrade configuration for a Cognitive Services account. Customers can opt out of auto-upgrade by setting mode to Disabled.
      - `mode` 'Enabled' | 'Disabled': Represents the mode for foundry auto-upgrade configuration.
      - `plannedByMicrosoft` boolean: Gets or sets a value indicating whether the auto-upgrade is planned by Microsoft.
      - `statusReason` string: Gets or sets the status reason for the auto-upgrade configuration.
      - `scheduledAt` string, date-time: Gets or sets the scheduled time for the auto-upgrade.
    - `allowProjectManagement` boolean: Specifies whether this resource support project management as child resources, used as containers for access management, data isolation and cost in AI Foundry.
    - `defaultProject` string: Specifies the project, by project name, that is targeted when data plane endpoints are called without a project parameter.
    - `associatedProjects` string[]: Specifies the projects, by project name, that are associated with this resource.
  - `tags` object: Resource tags.
  - `location` string: The geo-location where the resource lives
  - `etag` string: Resource Etag.
  - `kind` string: The kind (type) of cognitive service account.
  - `sku` Sku: The resource model definition representing SKU
    - `name` string, required: The name of the SKU. Ex - P3. It is typically a letter+number code
    - `tier` 'Free' | 'Basic' | 'Standard' | 'Premium' | 'Enterprise': This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.
    - `size` string: The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code.
    - `family` string: If the service has different generations of hardware, for the same SKU, then that can be captured here.
    - `capacity` integer: If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted.
  - `identity` Identity: Identity for the resource.
    - `type` 'None' | 'SystemAssigned' | 'UserAssigned' | 'SystemAssigned, UserAssigned': The identity type.
    - `tenantId` string: The tenant ID of resource.
    - `principalId` string: The principal ID of resource identity.
    - `userAssignedIdentities` object: The list of user assigned identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-07-13** (2016-02-01-preview) `d0eb21b3d2a7`: 3 breaking
  - added the new path request parameter `resourceGroupName`
  - added the new path request parameter `subscriptionId`
  - added the new required `query` request parameter `api-version`
- **2026-07-13** (2016-02-01-preview) `10ba71accb6e`: 3 breaking, 1 info
  - added the new path request parameter `resourceGroupName`
  - added the new path request parameter `subscriptionId`
  - added the new required `query` request parameter `api-version`
  - api operation id `Accounts_Get` removed and replaced with `CognitiveServicesAccounts_GetProperties`
- **2026-07-13** (2016-02-01-preview) `76a438c3d97a`: 1 info
  - api operation id `Accounts_GetProperties` removed and replaced with `Accounts_Get`
- **2026-07-13** (2016-02-01-preview) `a945a4b99f00`: 3 warning, 1 info
  - deleted the `path` request parameter `resourceGroupName`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
  - api operation id `CognitiveServicesAccounts_GetProperties` removed and replaced with `Accounts_GetProperties`
- **2017-12-28** (2016-02-01-preview) `9fddc284caf8`: 3 breaking, 1 info
  - added the new path request parameter `resourceGroupName`
  - added the new path request parameter `subscriptionId`
  - added the new required `query` request parameter `api-version`
  - api operation id `Accounts_Get` removed and replaced with `CognitiveServicesAccounts_GetProperties`

[Operation history](https://skmtc.dev/azure/apis/cognitiveservices-microsoft-cognitiveservices/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.CognitiveServices/accounts/:accountName/get.md)

---

[API](https://skmtc.dev/azure/apis/cognitiveservices-microsoft-cognitiveservices.md) - [All operations](https://skmtc.dev/azure/apis/cognitiveservices-microsoft-cognitiveservices/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/cognitiveservices-microsoft-cognitiveservices/revisions/d0eb21b3d2a7?raw)
