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

# Get Wallet by ID

> Retrieve full details of a single wallet, including current sub-balances, lifetime volumes, and configured payment instruments.

## Overview

`GET /wallets/{id}` returns full details of one wallet, including its current pay-in / pay-out sub-balances and a summary of activity.

## When to use it

* Display a single wallet's details in your dashboard.
* Verify a wallet's balance before initiating a payout (also covered by [`GET /payment/balance`](/api-reference/endpoint/get-payment-balance)).
* Reconcile lifetime volumes (`payin_amount`, `payout_amount`) against your accounting.

## Prerequisites

* The wallet must belong to your company.

## Request

### Headers

| Name            | Required | Description             |
| --------------- | -------- | ----------------------- |
| `Authorization` | Yes      | `Bearer <access_token>` |

### Path parameters

| Name | Type   | Description       |
| ---- | ------ | ----------------- |
| `id` | string | Wallet ID (UUID). |

## Response

### 200 — Success

```json theme={null}
{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": {
    "id": "w1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "company_id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "currency": "XAF",
    "country": "Cameroon",
    "country_iso_code": "CM",
    "country_phone_code": "+237",
    "balance": 175000,
    "payin_balance": 125000,
    "payout_balance": 50000,
    "payInAmount": 200000,
    "payOutAmount": 75000,
    "amount_to_recover": 0,
    "is_active": true,
    "created_at": "2026-04-01T08:00:00.000Z",
    "updated_at": "2026-05-09T10:15:00.000Z",
    "company": {
      "id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "name": "Acme Inc.",
      "country": "Cameroon"
    }
  }
}
```

The shape mirrors the per-wallet entry in [`GET /wallets`](/api-reference/endpoint/get-wallets), with the addition of an embedded `company` summary. Note that lifetime volumes are exposed here as `payInAmount` / `payOutAmount` (camelCase, legacy) — they are the same numbers as `payin_amount` / `payout_amount` in the list view. See [API Conventions → Field naming](/getting-started/conventions#field-naming-convention).

### Error responses

| Status | Trigger                                              |
| ------ | ---------------------------------------------------- |
| `404`  | Wallet does not exist or belongs to another company. |

## Code examples

```bash cURL theme={null}
curl https://api.cartevo.co/api/v1/wallets/w1a2b3c4-d5e6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer $TOKEN"
```

## Related

* [`GET /wallets`](/api-reference/endpoint/get-wallets) — list all wallets.
* [`GET /wallet/transactions/wallet/{walletId}`](/api-reference/endpoint/get-wallet-transactions) — transactions for this wallet.


## OpenAPI

````yaml GET /wallets/{id}
openapi: 3.1.0
info:
  title: Cartevo API
  description: Essential endpoints for wallets, transactions, customers and conversion.
  version: 1.0.0
servers:
  - url: https://api.cartevo.co/api/v1
security:
  - bearerAuth: []
paths:
  /wallets/{id}:
    get:
      summary: Wallet details
      description: Retrieves the details of a single wallet by its ID.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Detailed information for a single wallet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWalletResponse'
        '404':
          description: Wallet not found.
components:
  schemas:
    GetWalletResponse:
      allOf:
        - $ref: '#/components/schemas/StandardResponse'
        - type: object
          properties:
            data:
              $ref: '#/components/schemas/WalletDetails'
    StandardResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        statusCode:
          type: integer
          example: 200
        message:
          type: string
          example: Data retrieved successfully
    WalletDetails:
      allOf:
        - $ref: '#/components/schemas/Wallet'
        - type: object
          properties:
            company:
              $ref: '#/components/schemas/CompanySummary'
            payInAmount:
              type: number
              example: 0
            payOutAmount:
              type: number
              example: 0
    Wallet:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: 422541f3-80e2-41e0-b7a2-24017586b374
        balance:
          type: string
          example: '0.24'
        payin_balance:
          type: string
          example: '306'
        payout_balance:
          type: string
          example: '1646'
        payin_amount:
          type: string
          example: '982.6'
        payout_amount:
          type: string
          example: '1994'
        amount_to_recover:
          type: string
          example: '0'
        is_active:
          type: boolean
          example: true
        currency:
          type: string
          example: XAF
        country:
          type: string
          example: Cameroon
        country_iso_code:
          type: string
          example: CM
        company_id:
          type: string
          format: uuid
          example: eca5e982-00b5-4aa2-b709-7d5cd673e95c
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        country_phone_code:
          type: string
          example: '237'
        phoneNumbers:
          type: array
          items:
            $ref: '#/components/schemas/PhoneNumber'
        operators:
          type: array
          items:
            $ref: '#/components/schemas/Operator'
    CompanySummary:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: eca5e982-00b5-4aa2-b709-7d5cd673e95c
        name:
          type: string
          example: Stark Industry
        email:
          type: string
          format: email
          example: example@gmail.com
        country:
          type: string
          example: TD
        business_name:
          type: string
          nullable: true
        is_active:
          type: boolean
          example: true
    PhoneNumber:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: 32e525ac-a4a3-47fa-896e-4ef89f64d2d0
        wallet_id:
          type: string
          format: uuid
          example: 422541f3-80e2-41e0-b7a2-24017586b374
        country_iso_code:
          type: string
          example: CM
        country_phone_code:
          type: string
          example: '+237'
        currency:
          type: string
          example: XAF
        phone_number:
          type: string
          example: '650695112'
        operator:
          type: string
          example: MTN
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    Operator:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: f079c4db-4897-4ae7-9371-87950ad2429c
        country_iso_code:
          type: string
          example: CM
        country_phone_code:
          type: string
          example: '237'
        currency:
          type: string
          example: XAF
        operator_code:
          type: string
          example: mtn
        operator_name:
          type: string
          example: MTN Money
        otp_required:
          type: boolean
          example: false
        ussd_code:
          type: string
          nullable: true
          example: '*126#'
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````