> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fossapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Wallet

> Retrieve details of a specific fiat wallet

## Path Parameters

<ParamField path="walletId" type="string" required>
  The unique identifier of the wallet
</ParamField>

## Request

<ParamField header="x-api-key" type="string" required>
  API Key for authentication
</ParamField>

## Request Example

```bash theme={null}
curl https://api-production.fossapay.com/api/v1/wallets/fiat/wal_abc123xyz \
  -H "x-api-key: fp_live_sk_xxxxxxxx"
```

```javascript theme={null}
const response = await fetch('https://api-production.fossapay.com/api/v1/wallets/fiat/wal_abc123xyz', {
  headers: {
    'x-api-key': 'fp_live_sk_xxxxxxxx'
  }
});

const data = await response.json();
const wallet = data.data;
```

```python theme={null}
import requests

url = "https://api-production.fossapay.com/api/v1/wallets/fiat/wal_abc123xyz"
headers = {"x-api-key": "fp_live_sk_xxxxxxxx"}

response = requests.get(url, headers=headers)
data = response.json()
wallet = data["data"]
```

## Response

<ResponseField name="status" type="boolean">
  Response status
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable response message
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Unique identifier for the wallet
    </ResponseField>

    <ResponseField name="customerId" type="string">
      Customer ID associated with the wallet
    </ResponseField>

    <ResponseField name="availableBalance" type="string">
      Available balance in the wallet
    </ResponseField>

    <ResponseField name="ledgerBalance" type="string">
      Ledger balance in the wallet
    </ResponseField>

    <ResponseField name="walletName" type="string">
      Name of the wallet
    </ResponseField>

    <ResponseField name="customerType" type="string">
      Type of customer
    </ResponseField>

    <ResponseField name="virtualAccount" type="object">
      <Expandable title="properties">
        <ResponseField name="accountNumber" type="string">
          Virtual account number
        </ResponseField>

        <ResponseField name="bankCode" type="string">
          Bank code
        </ResponseField>

        <ResponseField name="bankName" type="string">
          Bank name
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

### Response Example

<ResponseExample>
  ```json Success Response theme={null}
  {
    "status": true,
    "message": "wallet retrieved successfully",
    "data": {
      "id": "wal_abc123xyz",
      "customerId": "cus_123456789",
      "availableBalance": "10000.00",
      "ledgerBalance": "10000.00",
      "walletName": "Main Wallet",
      "customerType": "individual",
      "virtualAccount": {
        "accountNumber": "1234567890",
        "bankCode": "035",
        "bankName": "Wema Bank"
      }
    }
  }
  ```

  ```json Error Response theme={null}
  {
    "status": false,
    "message": "Wallet not found",
    "code": "WALLET_NOT_FOUND"
  }
  ```
</ResponseExample>

## Error Codes

| Code               | Description                                 |
| ------------------ | ------------------------------------------- |
| `WALLET_NOT_FOUND` | Wallet with this ID does not exist          |
| `UNAUTHORIZED`     | Invalid API key or insufficient permissions |