Get Account

Get details about your account. Introspects the Authentication value passed and returns an Account object containing the accountId. If no Circle account was found, this call will return a 404 - Not Found, and you must call Create Circle Account before doing anything else.

Permissions

Requires a Permissions scope of circle:accessories_ro

Response

A JSON object representing a Circle account with the following keys:

Name

Type

Description

accountId

string

The Circle Account IdAccount Id - A unique non changing value to identify a particular Circle user account. Circle Account Id's are globally unique and are UUID v4 strings. The Account Id is not the same value as the Logitech Account Id found when introspecting an OAuth2 Authentication token. Example: 9385e6f9-70c3-45b2-62e4-ace3d027988a.

created

string

A TimestampTimestamp - An ISO8601 based format with everything represented server side as UTC+0 or "zulu" format. Takes the form of YYYY-MM-DDTHH:MM:SSZ - For example: 2015-04-04T00:43:29Z or 2016-05-28T23:12:59Z or 2016-11-04T12:00:00Z formatted string for when the Circle Account IdAccount Id - A unique non changing value to identify a particular Circle user account. Circle Account Id's are globally unique and are UUID v4 strings. The Account Id is not the same value as the Logitech Account Id found when introspecting an OAuth2 Authentication token. Example: 9385e6f9-70c3-45b2-62e4-ace3d027988a was created.

modified

string

A TimestampTimestamp - An ISO8601 based format with everything represented server side as UTC+0 or "zulu" format. Takes the form of YYYY-MM-DDTHH:MM:SSZ - For example: 2015-04-04T00:43:29Z or 2016-05-28T23:12:59Z or 2016-11-04T12:00:00Z formatted string for when the Circle Account IdAccount Id - A unique non changing value to identify a particular Circle user account. Circle Account Id's are globally unique and are UUID v4 strings. The Account Id is not the same value as the Logitech Account Id found when introspecting an OAuth2 Authentication token. Example: 9385e6f9-70c3-45b2-62e4-ace3d027988a was last modified.

language

string

The LocaleLocale - Locale is how the API represents the language and country for an Account. It is comprised of the ISO_639-1 alpha 2 language code with a dash (-) then the ISO 3166-1 alpha-2 country code. If the country is unknown, the dash (-) and country code may be omitted. The Account Locale is also used to determine the default country and currency for Circle Safe. Examples: en-US (English in the United States) en-CA (English in Canada), de-DE (German in Germany), de-CH (Swiss German), it-IT (Italian in Italy), es-ES (Spanish in Spain), es-MX (Spanish in Mexico), en (English, country unknown), fr (French, country unknown), es (Spanish, country unknown) of the user. Comprised of two letter ISO 639-2 language code, followed by the ISO 3166-1 alpha 2 letter country code.

globalId

string

The Logitech assigned cross-product user Id.

Language
Authentication
OAuth2