Penny BankingAccountsLinked

Get a linked account

Retrieve a linked (external) account by its ID. The account’s account/routing number or IBAN is masked by default; set reveal_sensitive to true to include the real value.

Required permissions: account:read.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

account_idstringRequired
The ID of the Linked Account.

Headers

X-Penny-As-Businessstring or nullOptional

Act on behalf of another business that has granted you access. Requires the business:act_as permission.

Query parameters

versionintegerOptional>=0Defaults to 0

Resource version to return; 0 returns the latest.

reveal_sensitivebooleanOptionalDefaults to false

Whether to include the unmasked account/routing number or IBAN in the response. Defaults to false.

Response

The linked account.
account_idstring
Unique identifier for the account.
versioninteger
The current version of the account record.
version_timedatetime

ISO-8601 timestamp of the most recent account update.

statusenum
The current status of the linked account.
currencyenum

ISO-4217 currency code for the account.

Allowed values:
countryenum

ISO-3166-1 alpha-2 country code for the account.

Allowed values:
account_detailsobject
The bank account details, including routing or IBAN information.
aliasstring or nullOptional
An optional label for the account.
descriptionstring or nullOptional
An optional description of the account's purpose.
typeenumOptionalDefaults to linked

Account types exposed to client-facing API responses.

Allowed values:

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error