Get a wallet - Infinity API

GET

/

wallets

/

{id}

Get a wallet

curl --request GET \
  --url https://sandbox-api.infinityapp.in/v1/wallets/{id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "wallet_7t4m9k2qx8d3hn5r",
  "currency": "usd",
  "total": "5752.00",
  "reserved": "14.00",
  "available": "5738.00"
}

{
  "error": {
    "type": "authentication_error",
    "code": "wrong_environment",
    "message": "This is a live key. Use it on api.infinityapp.in.",
    "param": null,
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

Authorizations

Authorization

string

header

required

Your secret key: sk_test_… on the sandbox host, sk_live_… on live. A key on the wrong host gets a 401 wrong_environment. Keys are secret. Keep them on your server, never in a browser or app.

Path Parameters

id

string

required

Example:

"wallet_7t4m9k2qx8d3hn5r"

Response

The wallet.

id

string

required

Pass it as wallet_id to quote or create payouts.

Example:

"wallet_7t4m9k2qx8d3hn5r"

currency

string

required

The wallet's currency, lowercase ISO 4217.

Example:

"usd"

total

string

required

All funds in the wallet, including reserved funds.

Example:

"5752.00"

reserved

string

required

Set aside for payouts on hold or in flight.

Example:

"14.00"

available

string

required

total minus reserved. What new payouts can use.

Example:

"5738.00"

Get a wallet

curl --request GET \
  --url https://sandbox-api.infinityapp.in/v1/wallets/{id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "wallet_7t4m9k2qx8d3hn5r",
  "currency": "usd",
  "total": "5752.00",
  "reserved": "14.00",
  "available": "5738.00"
}

{
  "error": {
    "type": "authentication_error",
    "code": "wrong_environment",
    "message": "This is a live key. Use it on api.infinityapp.in.",
    "param": null,
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_payout_request",
    "message": "amount has more than 2 decimals for eur.",
    "param": "amount",
    "request_id": "req_4f4b2bjc4mamxuxm",
    "timestamp": "2026-10-29T10:00:00Z"
  }
}