Google Cloud IoT Core is being retired on August 16, 2023. Contact your Google Cloud account team for more information.

Method: projects.locations.registries.devices.getConfig

Stay organized with collections Save and categorize content based on your preferences.

Gets the configuration of a device.

HTTP request


The URL uses gRPC Transcoding syntax.

Each request must include a JWT in the header.

Path parameters



The name of the device. For example, projects/p0/locations/us-central1/registries/registry0/devices/device0.

Query parameters


string (int64 format)

If zero, returns the current device configuration from Cloud IoT Core. If nonzero, specifies the local version of the configuration on the device. The server returns config data only if a higher (newer) version is available from Cloud IoT Core. If this value is higher than the latest version available in Cloud IoT Core, returns an OUT_OF_RANGE error.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

The device configuration obtained from Cloud IoT Core.

JSON representation
  "version": string,
  "binaryData": string

string (int64 format)

The version of the configuration in Cloud IoT Core.


string (bytes format)

Data in binary format.

A base64-encoded string.