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.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.
Endpoints
| Endpoint | Description |
|---|---|
| Validate PNR | Validate and normalize a personal number for a given country before including it in an application. |
| Get application attributes | Retrieve required fields, photo requirements, and peer-review settings for identity applications on this broker. |
| Apply for ID | Submit a new Legal Identity application, signed with a cryptographic key. |
| Add ID attachment | Attach supporting documents (e.g. photos) to a pending identity application. |
| Ready for approval | Signal that the application is complete and ready for review. |
| Get service providers for ID review | List available third-party review services that can approve the identity application. |
| Select review service | Choose a review service to handle the approval of the identity application. |
| Authorize access to ID | Grant another party permission to access your Legal Identity. |
| Petition peer review | Ask a peer (another identity holder) to review and co-sign your identity application. |
| Petition ID | Request access to another party’s Legal Identity. |
| Petition signature | Request that another party sign a document or contract using their Legal Identity. |
| Get identity | Retrieve a specific Legal Identity by ID. |
| Get identities | Retrieve all Legal Identities associated with the authenticated account. |
Typical identity application flow
Prerequisites
- A cryptographic key must be created via Cryptography → Create key before applying for an identity.
- All signing operations require a
keyId,nonce,keySignature, andrequestSignature. - Approved Legal Identities are required to sign smart contracts — see Contracts.
Related
- Legal identity flow guide — step-by-step walkthrough of the full application process.
- Cryptography — create and retrieve the keys needed to sign identity applications.
- Contracts — use approved identities to sign smart contracts.