> For the complete documentation index, see [llms.txt](https://docs.linora.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.linora.finance/cards-and-usage/api/users.md).

# Users

> **Users API** The Users API is used to manage users, access their wallet data, and handle deposits.

Each user represents an individual account entity within the Linora system.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><p><mark style="color:blue;"><strong>User entity</strong></mark></p><p>A user is a core object that:</p><ul><li>owns a <strong>wallet balance</strong>,</li><li>can receive <strong>deposits</strong>,</li><li>can have <strong>multiple cards</strong> attached.</li></ul></td><td><a href="/files/xPOVDytZVSeNaxjVcCBc">/files/xPOVDytZVSeNaxjVcCBc</a></td></tr><tr><td><p><mark style="color:blue;"><strong>Create user</strong></mark></p><p>The API allows you to create a new user programmatically.</p><p><strong>Purpose</strong></p><ul><li>initialize a new account,</li><li>prepare a wallet for deposits,</li><li>enable future card creation.</li></ul></td><td><a href="/files/R7mLVH88B8jBmQfbdmi9">/files/R7mLVH88B8jBmQfbdmi9</a></td></tr><tr><td><p><mark style="color:blue;"><strong>Get user information</strong></mark></p><p>You can retrieve basic user data using the user identifier.</p><p>Returned data may include:</p><ul><li>user identifier,</li><li>creation timestamp,</li><li>basic account metadata.</li></ul><p>This endpoint is intended for <strong>verification and internal mapping</strong>.</p></td><td><a href="/files/x84EHFN9wVMVIlyUCtbw">/files/x84EHFN9wVMVIlyUCtbw</a></td></tr><tr><td><p><mark style="color:blue;"><strong>Wallet balance</strong></mark></p><p>Each user has a wallet that holds funds before they are allocated to cards.</p><p>The wallet response includes:</p><ul><li><strong>available balance</strong></li><li><strong>pending balance</strong></li><li><strong>balance allocated to cards</strong></li><li><strong>currency</strong></li></ul></td><td><a href="/files/FvcJvYOCRIloTDts98DU">/files/FvcJvYOCRIloTDts98DU</a></td></tr><tr><td><p><mark style="color:blue;"><strong>Deposits</strong></mark></p><p>The Users API supports creating and listing deposits for a user.</p><p><strong>Supported behavior</strong></p><ul><li>deposits are created via crypto</li><li>each deposit has a unique identifier</li><li>deposits may have a <strong>pending</strong> status until confirmed</li></ul></td><td><a href="/files/KU54wOCA6yJSyOnRXlEd">/files/KU54wOCA6yJSyOnRXlEd</a></td></tr><tr><td><p><mark style="color:blue;"><strong>Deposit data includes</strong></mark></p><ul><li>gross amount</li><li>platform fee</li><li>net amount</li><li>crypto amount and currency</li><li>deposit address</li><li>expiration time</li></ul></td><td><a href="/files/zJNf62kEL7u0KB58eHZb">/files/zJNf62kEL7u0KB58eHZb</a></td></tr><tr><td><p><mark style="color:blue;"><strong>List deposits</strong></mark></p><p>You can retrieve a paginated list of deposits for a specific user.</p><p>This is useful for:</p><ul><li>transaction history</li><li>balance reconciliation</li><li>monitoring deposit status</li></ul></td><td><a href="/files/HXcWKJNcYNAfdmL74wKa">/files/HXcWKJNcYNAfdmL74wKa</a></td></tr><tr><td><p><mark style="color:blue;"><strong>Data consistency</strong></mark></p><ul><li>User data is updated in real time where possible</li><li>Some operations may return intermediate states</li><li>Failed operations do not modify user balances</li></ul></td><td><a href="/files/6lZtwojSMyhrjds1jJk5">/files/6lZtwojSMyhrjds1jJk5</a></td></tr><tr><td><p><mark style="color:blue;"><strong>Common errors</strong></mark></p><ul><li><strong>404</strong> — user not found</li><li><strong>400</strong> — invalid or missing request fields</li><li><strong>401</strong> — authentication error</li></ul></td><td><a href="/files/x4o4eYIBIKirKggewwuS">/files/x4o4eYIBIKirKggewwuS</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.linora.finance/cards-and-usage/api/users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.