> ## 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.

# Overview

A Legal Identity is a cryptographically signed, broker-verified identity record tied to a Neuron account. Legal Identities are required to sign smart contracts and are used throughout the platform to establish trust between parties.

These endpoints cover the full identity lifecycle: validating personal numbers, submitting applications, attaching evidence, requesting review, and retrieving approved identities.

## Endpoints

| Endpoint                                                                                                              | Description                                                                                                      |
| --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| [Validate PNR](/neuron-api/api-reference/legal-identities/validate-pnr)                                               | Validate and normalize a personal number for a given country before including it in an application.              |
| [Get application attributes](/neuron-api/api-reference/legal-identities/get-application-attributes)                   | Retrieve required fields, photo requirements, and peer-review settings for identity applications on this broker. |
| [Apply for ID](/neuron-api/api-reference/legal-identities/apply-for-id)                                               | Submit a new Legal Identity application, signed with a cryptographic key.                                        |
| [Add ID attachment](/neuron-api/api-reference/legal-identities/add-id-attachment)                                     | Attach supporting documents (e.g. photos) to a pending identity application.                                     |
| [Ready for approval](/neuron-api/api-reference/legal-identities/ready-for-approval)                                   | Signal that the application is complete and ready for review.                                                    |
| [Get service providers for ID review](/neuron-api/api-reference/legal-identities/get-service-providers-for-id-review) | List available third-party review services that can approve the identity application.                            |
| [Select review service](/neuron-api/api-reference/legal-identities/select-review-service)                             | Choose a review service to handle the approval of the identity application.                                      |
| [Authorize access to ID](/neuron-api/api-reference/legal-identities/authorize-access-to-id)                           | Grant another party permission to access your Legal Identity.                                                    |
| [Petition peer review](/neuron-api/api-reference/legal-identities/petition-peer-review)                               | Ask a peer (another identity holder) to review and co-sign your identity application.                            |
| [Petition ID](/neuron-api/api-reference/legal-identities/petition-id)                                                 | Request access to another party's Legal Identity.                                                                |
| [Petition signature](/neuron-api/api-reference/legal-identities/petition-signature)                                   | Request that another party sign a document or contract using their Legal Identity.                               |
| [Get identity](/neuron-api/api-reference/legal-identities/get-identity)                                               | Retrieve a specific Legal Identity by ID.                                                                        |
| [Get identities](/neuron-api/api-reference/legal-identities/get-identities)                                           | Retrieve all Legal Identities associated with the authenticated account.                                         |

## Typical identity application flow

```mermaid theme={null}
sequenceDiagram
  participant Client
  participant Neuron
  Client->>Neuron: POST Legal/GetApplicationAttributes
  Neuron-->>Client: Required fields, photo count, peer review settings
  Client->>Neuron: POST Legal/ValidatePNr (optional)
  Client->>Neuron: POST Legal/ApplyId (signed with key)
  Neuron-->>Client: Identity object (pending)
  Client->>Neuron: POST Legal/AddIdAttachment (photos/documents)
  Client->>Neuron: POST Legal/ReadyForApproval
  Neuron-->>Client: Review initiated
```

## Prerequisites

* A cryptographic key must be created via [Cryptography → Create key](/neuron-api/api-reference/cryptography/create-key) before applying for an identity.
* All signing operations require a `keyId`, `nonce`, `keySignature`, and `requestSignature`.
* Approved Legal Identities are required to sign smart contracts — see [Contracts](/neuron-api/api-reference/contracts/overview).

## Related

* [Legal identity flow guide](/neuron-api/guides/legal-identity-flow) — step-by-step walkthrough of the full application process.
* [Cryptography](/neuron-api/api-reference/cryptography/overview) — create and retrieve the keys needed to sign identity applications.
* [Contracts](/neuron-api/api-reference/contracts/overview) — use approved identities to sign smart contracts.