---
title: "Return the current identity"
method: GET
path: "/current-identity"
tags: ["Current Identity"]
---

# Return the current identity

`GET /current-identity`

Returns the identity associated with the API sessions used to issue the current request

## Response `200`

The identity associated with the API Session used to issue the request

- CurrentIdentityDetailEnvelope
  - `data` IdentityDetail, required — Detail of a specific identity
    - `_links` object, required — A map of named links
    - `createdAt` string, date-time, required
    - `id` string, required
    - `tags` Tags
    - `updatedAt` string, date-time, required
    - `appData` Tags
    - `authPolicy` EntityRef, required — A reference to another resource and links to interact with it
      - `_links` object — A map of named links
      - `entity` string
      - `id` string
      - `name` string
    - `authPolicyId` string, required
    - `authenticators` IdentityAuthenticators, required
      - `cert` IdentityAuthenticatorsCert
        - `fingerprint` string
        - `id` string
      - `updb` IdentityAuthenticatorsUpdb
        - `id` string
        - `username` string
    - `defaultHostingCost` integer, required
    - `defaultHostingPrecedence` 'default' | 'required' | 'failed'
    - `disabled` boolean, required
    - `disabledAt` string, date-time, nullable
    - `disabledUntil` string, date-time, nullable
    - `edgeRouterConnectionStatus` 'online' | 'offline' | 'unknown', required
    - `enrollment` IdentityEnrollments, required
      - `ott` IdentityEnrollmentsOtt
        - `expiresAt` string, date-time
        - `id` string
        - `jwt` string
        - `token` string
      - `ottca` IdentityEnrollmentsOttca
        - `ca` EntityRef — A reference to another resource and links to interact with it
          - `_links` object — A map of named links
          - `entity` string
          - `id` string
          - `name` string
        - `caId` string
        - `expiresAt` string, date-time
        - `id` string
        - `jwt` string
        - `token` string
      - `updb` IdentityEnrollmentsOtt
        - `expiresAt` string, date-time
        - `id` string
        - `jwt` string
        - `token` string
    - `envInfo` EnvInfo, required — Environment information an authenticating client may provide
      - `arch` string
      - `domain` string
      - `hostname` string
      - `os` string
      - `osRelease` string
      - `osVersion` string
    - `externalId` string, nullable, required
    - `hasApiSession` boolean, required
    - `hasEdgeRouterConnection` boolean, required
    - `interfaces` Interface[]
      - `addresses` string[]
      - `hardwareAddress` string, required
      - `index` integer, required
      - `isBroadcast` boolean, required
      - `isLoopback` boolean, required
      - `isMulticast` boolean, required
      - `isRunning` boolean, required
      - `isUp` boolean, required
      - `mtu` integer, required
      - `name` string, required
    - `isAdmin` boolean, required
    - `isDefaultAdmin` boolean, required
    - `isMfaEnabled` boolean, required
    - `name` string, required
    - `permissions` string[], nullable, required — A set of strings used to define which types of resources this resource can acccess
    - `roleAttributes` string[], nullable, required — A set of strings used to loosely couple this resource to policies
    - `sdkInfo` SdkInfo, required — SDK information an authenticating client may provide
      - `appId` string
      - `appVersion` string
      - `branch` string
      - `revision` string
      - `type` string
      - `version` string
    - `serviceHostingCosts` TerminatorCostMap, required
    - `serviceHostingPrecedences` TerminatorPrecedenceMap, required
    - `type` EntityRef, required — A reference to another resource and links to interact with it
      - `_links` object — A map of named links
      - `entity` string
      - `id` string
      - `name` string
    - `typeId` string, required
  - `meta` Meta, required
    - `apiEnrollmentVersion` string
    - `apiVersion` string
    - `filterableFields` string[]
    - `pagination` Pagination
      - `limit` number, required
      - `offset` number, required
      - `totalCount` number, required

## Other responses

- `401` — The supplied session does not have the correct access rights to request this resource

---

[API](https://skmtc.net/openziti/apis/ziti-edge-client.md) · [All operations](https://skmtc.net/openziti/apis/ziti-edge-client/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openziti/ziti-edge-client/versions/25da9a73a095/schema)