> For the complete documentation index, see [llms.txt](https://teos-docs.coreledger.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://teos-docs.coreledger.net/guides/wallets/retrieve-a-wallet-by-id.md).

# Retrieve a wallet by id

This endpoint retrieves the details of a specific wallet by its unique identifier (Id).

Each wallet record contains:

* Identifying information about the wallet
* The associated blockchain address
* Metadata describing its usage and permissions

📘 [Learn more](/resources/using-the-teos-api/concepts/wallet.md) about wallets.

#### Request Endpoint

```http
GET /odata/v1.0/Wallets({key})
```

#### Supported OData Query Options

Expand, Select — allow clients to retrieve related entities or select specific fields in the response.

#### Parameters

| **Name** | **Type**      | **Description**                                                                                                                  |
| -------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| key      | string($uuid) | <p>Required. Unique identifier of the requested wallet.</p><p><strong>Example:</strong> B5BB3E99-A8F8-4896-8D41-07920DFCDAEC</p> |

#### Response Body

**Content type:** `application/json`— Returns a single wallet object.

| **Parameter**              | **Description**                                                        |
| -------------------------- | ---------------------------------------------------------------------- |
| Id                         | Unique identifier of the wallet within TEOS Platform.                  |
| Name                       | Human-readable name assigned to the wallet.                            |
| Description                | Optional description providing context or intended use of the wallet.  |
| EthereumAddress/ICPAddress | The blockchain address linked to this wallet.                          |
| UserId                     | Identifier of the user who owns this wallet.                           |
| Signable                   | Indicates whether the wallet supports signing blockchain transactions. |

#### Example Response Body

In EVM-compatible networks (e.g., Sparknet, Ethereum, and Polygon), the "Address" and is 42 characters long. In non-EVM networks, the address length may differ. For example, on Internet Computer, it is 63 characters.

```json
{
  "Id": "346BD08F-8F95-4487-9FB4-17FA19B8A91D",
  "Name": "USD Token Wallet",
  "Description": "Used for payments",
  "EthereumAddress": "0xe0450ce1e2ef73b15514ae6a003b90d0ebac8836",
  "UserId": "346BD08F-8F95-4487-9FB4-17FA19B8A91D",
  "Signable": true
}
```

#### Response Codes

| **Code** | **Description**                                                   |
| -------- | ----------------------------------------------------------------- |
| 200      | The wallet was successfully retrieved.                            |
| 401      | Unauthorized — authentication credentials are missing or invalid. |
| 403      | Forbidden — the requested wallet belongs to another user.         |
| 404      | Not Found — no wallet with the specified ID exists in the system. |

<br>


---

# 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, and the optional `goal` query parameter:

```
GET https://teos-docs.coreledger.net/guides/wallets/retrieve-a-wallet-by-id.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.