curl --request GET \
--url https://api.bachs.io/v1/accounts/me \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.bachs.io/v1/accounts/me', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.bachs.io/v1/accounts/me"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bachs.io/v1/accounts/me"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "acct_7KpQ2mNv4XbR9dLc",
"name": "Ada Stores",
"owner_user_id": "usr_7b3e19d24c0a",
"parent_organization_id": null,
"country": "NG",
"fee_handling": "account_pays_fee",
"enabled_payment_methods": {
"USD_CARD": {
"enabled": true
},
"NGN_CARD": {
"enabled": true
},
"NGN_BANK_TRANSFER": {
"enabled": true
},
"MOMO_GHS": {
"enabled": true
},
"CRYPTO": {
"enabled": true,
"currencies": {
"USDT_TRC20": true,
"USDC_BEP20": true
}
}
},
"adaptive_pricing": true,
"balance_currencies": [
"NGN",
"USD"
],
"phone_number": null,
"company_name": null,
"enabled_capabilities": [
"payouts",
"conversions",
"connect"
],
"capabilities": null,
"requirements": null,
"is_active": true,
"created_at": "2026-08-01T09:12:44.000Z",
"updated_at": "2026-08-07T11:04:22.518Z",
"responsibilities": null,
"configuration": null
}{
"detail": "Invalid request parameters",
"error_code": "VALIDATION_ERROR",
"errors": [
{
"field": "amount",
"message": "Amount must be a positive decimal string",
"type": "value_error"
}
]
}{
"detail": "Invalid API key",
"error_code": "UNAUTHORIZED"
}{
"detail": "API key does not have permission for this operation",
"error_code": "FORBIDDEN"
}{
"detail": "Resource not found",
"error_code": "NOT_FOUND"
}{
"detail": "Rate limit exceeded. Please retry after a few seconds.",
"error_code": "TOO_MANY_REQUESTS"
}{
"detail": "An unexpected error occurred. Please try again later.",
"error_code": "INTERNAL_SERVER_ERROR"
}Get your own account
Get the account your API key belongs to, including its capability names, checkout payment methods, and balance currencies. The capabilities and requirements blocks are not populated here; read the account by ID for those. Use this to confirm your own platform holds an active connect capability before you create accounts. See Become a platform.
curl --request GET \
--url https://api.bachs.io/v1/accounts/me \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.bachs.io/v1/accounts/me', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.bachs.io/v1/accounts/me"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bachs.io/v1/accounts/me"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "acct_7KpQ2mNv4XbR9dLc",
"name": "Ada Stores",
"owner_user_id": "usr_7b3e19d24c0a",
"parent_organization_id": null,
"country": "NG",
"fee_handling": "account_pays_fee",
"enabled_payment_methods": {
"USD_CARD": {
"enabled": true
},
"NGN_CARD": {
"enabled": true
},
"NGN_BANK_TRANSFER": {
"enabled": true
},
"MOMO_GHS": {
"enabled": true
},
"CRYPTO": {
"enabled": true,
"currencies": {
"USDT_TRC20": true,
"USDC_BEP20": true
}
}
},
"adaptive_pricing": true,
"balance_currencies": [
"NGN",
"USD"
],
"phone_number": null,
"company_name": null,
"enabled_capabilities": [
"payouts",
"conversions",
"connect"
],
"capabilities": null,
"requirements": null,
"is_active": true,
"created_at": "2026-08-01T09:12:44.000Z",
"updated_at": "2026-08-07T11:04:22.518Z",
"responsibilities": null,
"configuration": null
}{
"detail": "Invalid request parameters",
"error_code": "VALIDATION_ERROR",
"errors": [
{
"field": "amount",
"message": "Amount must be a positive decimal string",
"type": "value_error"
}
]
}{
"detail": "Invalid API key",
"error_code": "UNAUTHORIZED"
}{
"detail": "API key does not have permission for this operation",
"error_code": "FORBIDDEN"
}{
"detail": "Resource not found",
"error_code": "NOT_FOUND"
}{
"detail": "Rate limit exceeded. Please retry after a few seconds.",
"error_code": "TOO_MANY_REQUESTS"
}{
"detail": "An unexpected error occurred. Please try again later.",
"error_code": "INTERNAL_SERVER_ERROR"
}Authorizations
Bearer token authentication. Pass your API key as Authorization: Bearer sk_.... See Authentication for keys, scopes, and sandbox vs production.
Response
Your account.
Unique identifier for the account.
"acct_7KpQ2mNv4XbR9dLc"
The account's display name.
"Ada Stores"
The user that owns the account. For an account you own this is a service user Bachs created; you never authenticate as it.
"usr_7b3e19d24c0a"
The platform this account is connected to, or null when it is a platform in its own right.
"acct_7KpQ2mNv4XbR9dLc"
Two-letter ISO 3166-1 country code. Decides which requirements the account is given.
"NG"
What kind of legal person the account is, which together with country decides the requirements it is given. company: a registered entity, asked for registration and ownership details. individual: a natural person, asked only for their own identity.
company, individual "company"
Who absorbs processing fees at checkout. account_pays_fee: deducted from the amount you receive. customer_pays_fee: added to what the customer pays.
account_pays_fee, customer_pays_fee "account_pays_fee"
One entry per exact corridor (USD_CARD, NGN_CARD, NGN_BANK_TRANSFER, MOMO_GHS to MOMO_ZMW, CRYPTO). See payment method support. Each value has an enabled boolean; CRYPTO additionally carries a currencies map since it covers several asset/network pairs.
When true, customers are shown prices in their local currency where one is available.
true
Currencies this account is configured to hold a balance in.
["NGN", "USD"]
Contact phone number, including country code.
"+2348012345678"
Registered company name, when the account is a company.
"Ada Stores Limited"
Names of the capabilities currently active on this account. A convenience view of capabilities.
["transfers", "payouts"]
Each capability's status, keyed by capability name. Populated on single-account reads only; null on list items.
Show child attributes
Show child attributes
Outstanding requirements for this account. Populated on single-account reads only; null on list items.
Show child attributes
Show child attributes
When false, the account is deactivated and cannot authenticate or move funds.
true
When the account was created, ISO 8601 in UTC.
"2026-08-01T09:12:44.000Z"
When the account was last updated, ISO 8601 in UTC.
"2026-08-07T11:04:22.518Z"
Fee arrangement for an account you own. null when this object is not an account you own.
Show child attributes
Show child attributes
Personas applied to this account, keyed by name (merchant, recipient), each with an empty object as its value. Populated on single-account reads, where it is {} when none apply; null on list items.
Show child attributes
Show child attributes
{ "merchant": {}, "recipient": {} }

