---
title: "GET /v1/customers/{customersId}/profiles"
method: GET
path: "/v1/customers/{customersId}/profiles"
tags: ["customers"]
---

# GET /v1/customers/{customersId}/profiles

`GET /v1/customers/{customersId}/profiles`

## Request

- Base URL: `https://chromemanagement.googleapis.com`
- URL: `https://chromemanagement.googleapis.com/v1/customers/{customersId}/profiles`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/chrome.management.profiles`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/chrome.management.profiles`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/chrome.management.profiles.readonly`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/chrome.management.profiles.readonly`

Lists Chrome browser profiles of a customer based on the given search and sorting criteria.

## Path parameters

- `customersId` string, required

## Query parameters

- `filter` string
- `orderBy` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- GoogleChromeManagementVersionsV1ListChromeBrowserProfilesResponse: Response to ListChromeBrowserProfiles method.
  - `chromeBrowserProfiles` GoogleChromeManagementVersionsV1ChromeBrowserProfile[]: The list of profiles returned.
    - `affiliationState` 'AFFILIATION_STATE_UNSPECIFIED' | 'UNAFFILIATED_GENERIC' | 'PROFILE_ONLY' | 'UNAFFILIATED_LOCAL_MACHINE' | 'UNAFFILIATED_CLOUD_MACHINE' | 'AFFILIATED_CLOUD_MANAGED': Output only. The specific affiliation state of the profile.
    - `annotatedLocation` string: Optional. Location of the profile annotated by the admin.
    - `annotatedUser` string: Optional. User of the profile annotated by the admin.
    - `attestationCredential` GoogleChromeManagementVersionsV1AttestationCredential: Information of public key associated with a Chrome browser profile.
      - `keyRotationTime` string, google-datetime: Output only. Latest rotation timestamp of the public key rotation.
      - `keyTrustLevel` 'KEY_TRUST_LEVEL_UNSPECIFIED' | 'CHROME_BROWSER_HW_KEY' | 'CHROME_BROWSER_OS_KEY': Output only. Trust level of the public key.
      - `keyType` 'KEY_TYPE_UNSPECIFIED' | 'RSA_KEY' | 'EC_KEY': Output only. Type of the public key.
      - `publicKey` string, byte: Output only. Value of the public key.
    - `browserChannel` string: Output only. Channel of the browser on which the profile exists.
    - `browserVersion` string: Output only. Version of the browser on which the profile exists.
    - `deviceInfo` GoogleChromeManagementVersionsV1DeviceInfo: Information of a device that runs a Chrome browser profile.
      - `affiliatedDeviceId` string: Output only. Device ID that identifies the affiliated device on which the profile exists. If the device type is CHROME_BROWSER, then this represents a unique Directory API ID of the device that can be used in Admin SDK Browsers API.
      - `deviceType` 'DEVICE_TYPE_UNSPECIFIED' | 'CHROME_BROWSER': Output only. Type of the device on which the profile exists.
      - `hostname` string: Output only. Hostname of the device on which the profile exists.
      - `machine` string: Output only. Machine name of the device on which the profile exists. On platforms which do not report the machine name (currently iOS and Android) this is instead set to the browser's device_id - but note that this is a different device_id than the |affiliated_device_id|.
    - `displayName` string: Output only. Profile display name set by client.
    - `etag` string: Output only. Etag of this ChromeBrowserProfile resource. This etag can be used with UPDATE operation to ensure consistency.
    - `extensionCount` string, int64: Output only. Number of extensions installed on the profile.
    - `firstEnrollmentTime` string, google-datetime: Output only. Timestamp of the first enrollment of the profile.
    - `identityProvider` 'IDENTITY_PROVIDER_UNSPECIFIED' | 'GOOGLE_IDENTITY_PROVIDER' | 'EXTERNAL_IDENTITY_PROVIDER': Output only. Identify provider of the profile.
    - `lastActivityTime` string, google-datetime: Output only. Timestamp of the latest activity by the profile.
    - `lastPolicyFetchTime` string, google-datetime: Output only. Timestamp of the latest policy fetch by the profile.
    - `lastPolicySyncTime` string, google-datetime: Output only. Timestamp of the latest policy sync by the profile.
    - `lastStatusReportTime` string, google-datetime: Output only. Timestamp of the latest status report by the profile.
    - `name` string: Identifier. Format: customers/{customer_id}/profiles/{profile_permanent_id}
    - `osPlatformType` string: Output only. OS platform of the device on which the profile exists.
    - `osPlatformVersion` string: Output only. Major OS platform version of the device on which the profile exists, from profile reporting.
    - `osVersion` string: Output only. OS version of the device on which the profile exists.
    - `policyCount` string, int64: Output only. Number of policies applied on the profile.
    - `profileId` string: Output only. Chrome client side profile ID.
    - `profilePermanentId` string: Output only. Profile permanent ID is the unique identifier of a profile within one customer.
    - `reportingData` GoogleChromeManagementVersionsV1ReportingData: Reporting data of a Chrome browser profile.
      - `browserExecutablePath` string: Output only. Executable path of the installed Chrome browser. A valid path is included only in affiliated profiles.
      - `extensionData` GoogleChromeManagementVersionsV1ReportingDataExtensionData[]: Output only. Information of the extensions installed on the profile.
        - `description` string: Output only. Description of the extension.
        - `extensionId` string: Output only. ID of the extension.
        - `extensionType` 'EXTENSION_TYPE_UNSPECIFIED' | 'EXTENSION' | 'APP' | 'THEME' | 'HOSTED_APP': Output only. Type of the extension.
        - `homepageUri` string: Output only. The URL of the homepage of the extension.
        - `installationType` 'INSTALLATION_TYPE_UNSPECIFIED' | 'MULTIPLE' | 'NORMAL' | 'ADMIN' | 'DEVELOPMENT' | 'SIDELOAD' | 'OTHER': Output only. Installation type of the extension.
        - `isDisabled` boolean: Output only. Represents whether the user disabled the extension.
        - `isWebstoreExtension` boolean: Output only. Represents whether the extension is from the webstore.
        - `manifestVersion` integer: Output only. Manifest version of the extension.
        - `name` string: Output only. Name of the extension.
        - `permissions` string[]: Output only. Permissions requested by the extension.
        - `version` string: Output only. Version of the extension.
      - `extensionPolicyData` GoogleChromeManagementVersionsV1ReportingDataExtensionPolicyData[]: Output only. Information of the policies applied on the extensions.
        - `extensionId` string: Output only. ID of the extension.
        - `extensionName` string: Output only. Name of the extension.
        - `policyData` GoogleChromeManagementVersionsV1ReportingDataPolicyData[]: Output only. Information of the policies applied on the extension.
          - `conflicts` GoogleChromeManagementVersionsV1ReportingDataConflictingPolicyData[]: Output only. Conflicting policy information.
            - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. Source of the policy.
          - `error` string: Output only. Error message of the policy, if any.
          - `name` string: Output only. Name of the policy.
          - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. Source of the policy.
          - `value` string: Output only. Value of the policy.
      - `installedBrowserVersion` string: Output only. Updated version of a browser, if it is different from the active browser version.
      - `policyData` GoogleChromeManagementVersionsV1ReportingDataPolicyData[]: Output only. Information of the policies applied on the profile.
        - `conflicts` GoogleChromeManagementVersionsV1ReportingDataConflictingPolicyData[]: Output only. Conflicting policy information.
          - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. Source of the policy.
        - `error` string: Output only. Error message of the policy, if any.
        - `name` string: Output only. Name of the policy.
        - `source` 'POLICY_SOURCE_UNSPECIFIED' | 'MACHINE_PLATFORM' | 'USER_PLATFORM' | 'MACHINE_LEVEL_USER_CLOUD' | 'USER_CLOUD' | 'MACHINE_MERGED': Output only. Source of the policy.
        - `value` string: Output only. Value of the policy.
      - `profilePath` string: Output only. Path of the profile. A valid path is included only in affiliated profiles.
    - `supportsFcmNotifications` boolean: Output only. Whether the profile supports FCM notifications.
    - `userEmail` string: Output only. Email address of the user to which the profile belongs.
    - `userId` string: Output only. Unique Directory API ID of the user that can be used in Admin SDK Users API.
  - `nextPageToken` string: The pagination token that can be used to list the next page.
  - `totalSize` string, int64: Total size represents an estimated number of resources returned. Not guaranteed to be accurate above 10k profiles.

## Changes

- **2026-11-02** `872a15abbbd0`: 4 info
  - the security scope `https://www.googleapis.com/auth/chrome.management.profiles` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/chrome.management.profiles` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/chrome.management.profiles.readonly` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/chrome.management.profiles.readonly` was removed from the endpoint's security scheme `Oauth2c`

[Operation history](https://skmtc.dev/google/apis/chromemanagement/changes/v1/customers/:customersId/profiles/get.md)

---

[API](https://skmtc.dev/google/apis/chromemanagement.md) - [All operations](https://skmtc.dev/google/apis/chromemanagement/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/chromemanagement/revisions/872a15abbbd0?raw)
