> ## 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 USD Wallet Balance

> Retrieve the current balance of your company's USD wallet — the wallet that funds card issuance, funding, and termination refunds.

## Overview

`GET /wallets/usd-balance` is a convenience endpoint that resolves your company's **USD** wallet and returns its current balance. The USD wallet is the one used to issue and fund cards and to receive card-termination refunds.

## When to use it

* Check available USD funds before issuing or funding a card.
* Display the USD balance in your dashboard without listing every wallet.

For the full per-wallet detail (sub-balances, lifetime volumes), use [`GET /wallets/{id}`](/api-reference/endpoint/get-wallet-by-id) or [`GET /wallets`](/api-reference/endpoint/get-wallets).

## Prerequisites

* Your company must have a `USD` wallet.

## Request

### Headers

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

This endpoint takes no path or query parameters — the USD wallet is resolved from your authenticated company.

## Response

### 200 — Success

```json theme={null}
{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": {
    "walletId": "w1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "balance": 175.5,
    "currency": "USD",
    "country": "United States"
  }
}
```

**`data` fields:**

| Field      | Type   | Description                            |
| ---------- | ------ | -------------------------------------- |
| `walletId` | string | ID of your company's USD wallet (UUID) |
| `balance`  | number | Current USD wallet balance             |
| `currency` | string | Always `"USD"`                         |
| `country`  | string | Wallet country                         |

### Error responses

| Status | Trigger                                |
| ------ | -------------------------------------- |
| `404`  | No USD wallet exists for your company. |

## Code examples

```bash cURL theme={null}
curl https://api.cartevo.co/api/v1/wallets/usd-balance \
  -H "Authorization: Bearer $TOKEN"
```

## Related

* [`GET /wallets`](/api-reference/endpoint/get-wallets) — list all wallets.
* [`GET /wallets/{id}`](/api-reference/endpoint/get-wallet-by-id) — full details for a single wallet.
* [`GET /payment/balance`](/api-reference/endpoint/get-payment-balance) — pay-in / pay-out balances per currency.


## OpenAPI

````yaml GET /wallets/usd-balance
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/usd-balance:
    get:
      summary: USD wallet balance
      description: >-
        Returns the company's USD wallet balance. A convenience endpoint that
        resolves the company's `USD` wallet and returns its current balance.
      responses:
        '200':
          description: The company's USD wallet balance.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/StandardResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          walletId:
                            type: string
                            format: uuid
                            description: ID of the company's USD wallet
                          balance:
                            type: number
                            description: Current USD wallet balance
                            example: 175.5
                          currency:
                            type: string
                            example: USD
                          country:
                            type: string
                            example: United States
        '404':
          description: No USD wallet found for the company.
components:
  schemas:
    StandardResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        statusCode:
          type: integer
          example: 200
        message:
          type: string
          example: Data retrieved successfully
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````