---
title: "Retrieve wallet by ID"
method: GET
path: "/v2/wallets/{id}"
tags: ["wallet"]
---

# Retrieve wallet by ID

`GET /v2/wallets/{id}`

Fetches the details of a specific wallet using its unique identifier, {id}. This endpoint returns information such as the wallet's name, balance, currency, and associated team, providing a comprehensive view of the wallet's current state.

## Path parameters

- `id` string, required

## Response `200`

The wallet object for requested id.

- V2GetWalletResponse
  - `wallet` V2ListWallet
    - `id` string — Represents the identifier of the wallet.
    - `namespaceId` string — Specifies the unique identifier of the team that the wallet will be associated with.
    - `teamId` string — The unique identifier of the team to which the wallet is assigned.
    - `name` string — The name of the wallet.
    - `externalId` string — Specifies the optional external ID field to store custom identifiers, such as Placement IO numbers, purchase order numbers, or Salesforce numbers, for tracking purposes. This field is available for partners to associate external identifiers with the wallet. Ensure the external ID is shorter than 255 characters, as no other validation is applied.
    - `currencyCode` string — Indicates the currency code of the wallet, using the 3-letter ISO 4217 standard.
    - `creditLimit` string — Specifies the maximum credit limit assigned to the wallet.
    - `dailyBudget` string — The limit amount that determines the daily spend of the wallet.
    - `archived` boolean — Indicates whether the wallet is archived.
    - `currentBalance` string — Displays the total amount currently in the wallet.
    - `availableBalance` string — Shows the amount available in the wallet for spending.
    - `cappedAvailableBalance` string — Reflects the remaining amount available for spending under daily or monthly caps. If no caps are set, this equals the available balance, and unspent funds roll over to the next day.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Access denied due to insufficient permissions.
- `404` — The wallet for specified id does not exist.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/versions/a040003c7378/schema)