Get Account
curl --request GET \
--url https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "<string>",
"object": "<string>",
"customer_id": "<string>",
"name": "<string>",
"status": "<string>",
"legal_name": "<string>",
"business_registration_number": "<string>",
"address": {},
"type": "<string>",
"profile": {},
"balances": [
{
"currency": "<string>",
"currency_type": "<string>",
"available_balance": "<string>",
"available_in_usd": "<string>",
"pending_payout": "<string>",
"pending_payin": "<string>",
"total_balance": "<string>",
"updated_at": "<string>"
}
],
"created": "<string>",
"updated": "<string>",
"created_by": "<string>",
"updated_by": "<string>"
}Accounts
Get Account
Retrieve detailed information about a specific account
GET
/
v1
/
customers
/
{customer_id}
/
accounts
/
{account_id}
Get Account
curl --request GET \
--url https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hopnow.io/v1/customers/{customer_id}/accounts/{account_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": "<string>",
"object": "<string>",
"customer_id": "<string>",
"name": "<string>",
"status": "<string>",
"legal_name": "<string>",
"business_registration_number": "<string>",
"address": {},
"type": "<string>",
"profile": {},
"balances": [
{
"currency": "<string>",
"currency_type": "<string>",
"available_balance": "<string>",
"available_in_usd": "<string>",
"pending_payout": "<string>",
"pending_payin": "<string>",
"total_balance": "<string>",
"updated_at": "<string>"
}
],
"created": "<string>",
"updated": "<string>",
"created_by": "<string>",
"updated_by": "<string>"
}Returns one account with its identity details and a balance snapshot.
Requires an API key with
read access on the accounts scope.
Path Parameters
string
required
The customer’s external ID (starts with
cus_). The account is looked up by account_id alone, so this segment does not narrow the lookup: an account you own is returned whichever of your customer IDs is in the path.string
required
The account’s external ID (starts with
acct_)Response
string
Account identifier (starts with
acct_)string
Always returns
"account"string
External ID of the customer that owns the account
string
The account name
string
Account status:
active, suspended, or deactivatedstring
Legal name used as the originator on payments out of this account, or
null when the account has no overridestring
Registration number used on the originator record, or
nullobject
Originator address, or
null. Fields: address_line, city, region, postal_code, country.string
Identity type of the end customer behind the account:
business, individual, or null when no identity has been recordedobject
Full identity profile recorded for the account, or
null. Its shape follows type: a business profile carries the registered entity details, an individual profile the person’s details.array
Balances for the currencies the account is configured for: a currency enabled for payin, enabled for payout, or on one side of an active FX instrument. A currency the account holds no configuration for is not returned even when its balance is zero. Sorted by
updated_at, most recently updated first.Show Balance Fields
Show Balance Fields
string
Currency code from the accepted list, or a crypto currency code such as
USDCstring
Type of currency:
fiat or cryptostring
Available balance for transactions (decimal string)
string
Available balance valued in USD at the latest stored rate;
null when no rate is available for a non-zero balance.string
Amount tied up in outgoing payments (decimal string)
string
Amount expected from incoming payments (decimal string)
string
Total balance including pending amounts (decimal string)
string
ISO 8601 timestamp of the last balance movement
string
ISO 8601 timestamp when created
string
ISO 8601 timestamp when last updated, or
nullstring
Actor that created the account, for example the API key that called the create endpoint (
ak_…), or nullstring
Actor that last updated the account, or
nullErrors
| Status | code | When |
|---|---|---|
403 | ACCESS_DENIED | The account exists but belongs to another organization |
404 | RESOURCE_NOT_FOUND | No account carries this ID, the account has been deleted, or it is a platform account and not addressable through this API |
Response Example
{
"id": "acct_9f2a7c1e6a2b4f3c9b8d2e5a",
"object": "account",
"customer_id": "cus_4b1d8e3f7a6c2d9e5f0a1b3c",
"name": "Primary Account",
"status": "active",
"legal_name": "Northwind Trading Ltd",
"business_registration_number": "12345678",
"address": {
"address_line": "12 Finsbury Square",
"city": "London",
"region": null,
"postal_code": "EC2A 1AS",
"country": "GB"
},
"type": "business",
"profile": {
"type": "business",
"business_legal_name": "Northwind Trading Ltd",
"business_type": "corporation",
"business_registration_number": "12345678",
"incorporation_date": "2019-04-02",
"registered_address": {
"address_line": "12 Finsbury Square",
"city": "London",
"region": null,
"postal_code": "EC2A 1AS",
"country": "GB"
},
"operating_address_same_as_registered": true
},
"balances": [
{
"currency": "USD",
"currency_type": "fiat",
"available_balance": "10000.50",
"available_in_usd": "10000.50",
"pending_payout": "250.00",
"pending_payin": "500.00",
"total_balance": "10750.50",
"updated_at": "2026-01-15T12:30:00Z"
},
{
"currency": "EUR",
"currency_type": "fiat",
"available_balance": "5000.25",
"available_in_usd": "5450.27",
"pending_payout": "0.00",
"pending_payin": "100.00",
"total_balance": "5100.25",
"updated_at": "2026-01-14T08:00:00Z"
}
],
"created": "2026-01-01T00:00:00Z",
"updated": "2026-01-15T12:30:00Z",
"created_by": "ak_0d5c8b2e7f1a3946c8e2b5d7",
"updated_by": null
}