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

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

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

## Request

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

Returns all the projects in a Cognitive Services account.

## Path parameters

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

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- ProjectListResult: The list of cognitive services projects operation response.
  - `nextLink` string: The link used to get the next page of projects.
  - `value` Project[]: Gets the list of Cognitive Services projects and their properties.
    - `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` ProjectProperties: Properties of Cognitive Services Project'.
      - `provisioningState` 'Accepted' | 'Creating' | 'Deleting' | 'Moving' | 'Failed' | 'Succeeded' | 'Canceled' | 'ResolvingDNS': Gets the status of the cognitive services account at the time the operation was called.
      - `displayName` string: The display name of the Cognitive Services Project.
      - `description` string: The description of the Cognitive Services Project.
      - `endpoints` object: The list of endpoint for this Cognitive Services Project.
      - `isDefault` boolean: Indicates whether the project is the default project for the account.
    - `tags` object: Resource tags.
    - `location` string: The geo-location where the resource lives
    - `etag` string: Resource Etag.
    - `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) `f4885ecdbcc2`: 1 info
  - endpoint added
- **2017-12-28** (2016-02-01-preview) `9fddc284caf8`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/azure/apis/cognitiveservices-microsoft-cognitiveservices/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.CognitiveServices/accounts/:accountName/projects/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)
