---
title: "GET /api/v1/me#Authentication"
method: GET
path: "/api/v1/me#Authentication"
---

# GET /api/v1/me#Authentication

`GET /api/v1/me#Authentication`

Retrieves details of the current user for whom the authentication token was generated. This is not a valid action for SigV4 (administrative API) clients.

This action requires an authentication token. To get an authentication token, register an application with Amazon WorkDocs. For more information, see [Authentication and Access Control for User Applications](https://docs.aws.amazon.com/workdocs/latest/developerguide/wd-auth-user.html) in the _Amazon WorkDocs Developer Guide_.

## Headers

- `Authentication` string, password, required

## Response `200`

Success

- GetCurrentUserResponse
  - `User` object — Metadata of the user.
    - `Id` string — The ID of the user.
    - `Username` string, password — The login name of the user.
    - `EmailAddress` string, password — The email address of the user.
    - `GivenName` string, password — The given name of the user.
    - `Surname` string, password — The surname of the user.
    - `OrganizationId` string — The ID of the organization.
    - `RootFolderId` string — The ID of the root folder.
    - `RecycleBinFolderId` string — The ID of the recycle bin folder.
    - `Status` 'ACTIVE' | 'INACTIVE' | 'PENDING' — The status of the user.
    - `Type` 'USER' | 'ADMIN' | 'POWERUSER' | 'MINIMALUSER' | 'WORKSPACESUSER' — The type of user.
    - `CreatedTimestamp` string, date-time — The time when the user was created.
    - `ModifiedTimestamp` string, date-time — The time when the user was modified.
    - `TimeZoneId` string — The time zone ID of the user.
    - `Locale` 'en' | 'fr' | 'ko' | 'de' | 'es' | 'ja' | 'ru' | 'zh_CN' | 'zh_TW' | 'pt_BR' | 'default' — The locale of the user.
    - `Storage` object — The storage for the user.
      - `StorageUtilizedInBytes` integer — The amount of storage used, in bytes.
      - `StorageRule` object — The storage for a user.
        - `StorageAllocatedInBytes` integer — The amount of storage allocated, in bytes.
        - `StorageType` 'UNLIMITED' | 'QUOTA' — The type of storage.

## Other responses

- `480` — EntityNotExistsException
- `481` — UnauthorizedOperationException
- `482` — UnauthorizedResourceAccessException
- `483` — FailedDependencyException
- `484` — ServiceUnavailableException

---

[API](https://skmtc.net/aws/apis/workdocs.md) · [All operations](https://skmtc.net/aws/apis/workdocs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/workdocs/versions/8a533af4e1ef/schema)