> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuro-tech.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get identity

> Allows the client to get an Identity.

## Overview

Allows the client to get an Identity. If the Identity belongs to someone else, and the client is not authorized access to the Identity, an error will be returned.

Note: Neurons are federated. You can get identities created on other neurons through this API on the neuron you have your account on. Federated means that the neurons interconnect to share authorized information, when requested, and permitted.

## HTTP request

`POST /Agent/Legal/GetIdentity`

## Authentication

Requires a valid JWT bearer token.

## Request (JSON)

```json theme={null}
{
	"legalId": Required(Str(PLegalId))
}
```

## Input parameters

| Parameter | Description                            |
| --------- | -------------------------------------- |
| PLegalId  | Identity of the Legal Identity to get. |

## Response (JSON)

```json theme={null}
{
	"Identity": Required(PIdentity)
}
```

## Response parameters

| Parameter | Description      |
| --------- | ---------------- |
| PIdentity | Identity object. |

## Notes

This endpoint uses the request schema notation described in [Pattern matching](/guides/pattern-matching).