Skip to main content
GET
/
wallets
/
{walletId}
cURL
curl --request GET \
  --url https://api.grainfinance.co/v1/wallets/{walletId} \
  --header 'Authorization: Basic <encoded-value>'
{
  "id": "1b0ada1e-fa1b-4cfe-a553-01b340c5650e",
  "totalBalance": 10525,
  "availableBalance": 8500,
  "currency": "EUR",
  "depositDetails": {
    "accountHolderName": "<string>",
    "externalId": "<string>",
    "accountNumber": "<string>",
    "bankName": "<string>",
    "bankAddress": "<string>",
    "bankCountry": "<string>",
    "paymentType": "swift",
    "id": "<string>",
    "bicSwift": "<string>",
    "bankCode": "<string>",
    "branchCode": "<string>",
    "iban": "<string>",
    "sortCode": "<string>",
    "bankState": "<string>",
    "specialInstructions": "<string>",
    "bsbCode": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.grainfinance.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Basic authentication using the partner API keys from https://console.grainfinance.co/api-keys

Path Parameters

​
walletId
string<uuid>
required

The id of the wallet within the Grain platform. Stringified UUIDv4. See RFC 4112

Pattern: [0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}

Response

Wallet Retrieved

​
id
string
required

The UUID of the Wallet in Grain's system.

Example:

"1b0ada1e-fa1b-4cfe-a553-01b340c5650e"

​
totalBalance
number<double>
required

The current balance, in the wallet currency.

Example:

10525

​
availableBalance
number<double>
required

The available balance (total minus reserved/pending amounts), in the wallet currency.

Example:

8500

​
currency
string
required

The wallet currency (ISO 4217)

Example:

"EUR"

​
depositDetails
object
required

Account details for depositing funds to this wallet