v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Accounts

Get transaction banking account information

Get the information for a transaction banking account.

NOTE: This endpoint requires an account token - an access token encoded with an external account ID. Tokens can expire quickly, which can result in a 401 Unauthorized message.

get/corporate/v1/corporate-accounts/{externalAccountId}

Path parameters

externalAccountIdstring required

External account ID

Response

account_idinteger required

Account ID minimum: 1 maximum: 4294967295

account_creation_datetimestring date-time required

Datetime the account was created in the Pismo system (in UTC). The datetime format follows the ISO 8601 standard: yyyy-mm-ddThh:mm:ss.sssZ. Note that milliseconds are represented as 000, for example: 2024-02-22T16:51:49.000Z. This field accepts datetime values from the present or past. Future dates are not allowed. minLength: 24 maxLength: 24

division_codestring required

Code used to identify your division within the organization. Division code should only contain letters, numbers, and hyphens.

program_idinteger required

Program ID minimum: 1 maximum: 4294967295

future_dated_credits_balancenumber required

Represents the account balance scheduled to be settled on a future date, after the original posting date. The account's book_balance is credited when the settlement occurs. The future_dated_credits_balance increases when future-dated credits are posted using the Post payment endpoint, and decreases when those payments are settled or canceled. This balance is always a positive value. minimum: -9223372036854775807 maximum: 9223372036854775807

future_dated_debits_balancenumber required

Represents the account balance scheduled to be settled on a future date, after the initial posting date. The account’s book_balance is debited when the settlement occurs. The future_dated_debits_balance increases when future-dated debits are posted using the Post payment endpoint, and decreases when these payments are settled or canceled. This balance is always a positive value. minimum: -9223372036854775807 maximum: 9223372036854775807

parent_account_idinteger

Parent account ID. The account retrieved is the child of the account referenced by parent_account_id. The account referenced by parent_account_id can be in another program or division. minimum: 1 maximum: 4294967295

available_balancenumber float

Available balance. Available balance is calculated as credit_balance - debit_balance + overdraft_limit. minimum: -9223372036854775807 maximum: 9223372036854775807

earmarked_balancenumber

Earmark balance. Initially equal to the earmarked amount and decreases as the reserved funds are used up or decreased in a decrease operation. It can also increase if an increase operation is performed. minimum: 0 maximum: 18446744073709551617

overdraft_limitnumber float

Account overdraft limit minimum: 0 maximum: 18446744073709551617

ledger_balancenumber float

Ledger balance. Ledger balance is calculated as book_balance + uncleared_funds. minimum: -9223372036854775807 maximum: 9223372036854775807

book_balancenumber float

Book balance. Book balance is calculated as credit_balance - debit_balance + earmarked_balance. minimum: -9223372036854775807 maximum: 9223372036854775807

value_dated_balancenumber float

The value dated balance results from recalculating credit or debit balance based on the back value date. Defaults to the book balance. The value dated balance is included in the following events:

uncleared_fundsnumber float

Uncleared funds amount minimum: -9223372036854775807 maximum: 9223372036854775807

uncleared_checks_balancenumber float

The total value of checks that have been posted to the account but have not yet cleared. minimum: -9223372036854775807 maximum: 9223372036854775807

restricted_fundsnumber float

The portion of an account balance held under regulatory or operational restrictions and not available for transactions. minimum: 0 maximum: 9223372036854775807

legal_holdsnumber float

The portion of an account balance held under legal holds (such as court-ordered restrictions) and unavailable for transactions. minimum: 0 maximum: 9223372036854775807

held_fundsnumber float

Funds that are temporarily restricted due to regulatory or operational requirements, unavailable for transactions, and representing the total amount of earmarked or otherwise restricted balances. minimum: 0 maximum: 9223372036854775807

held_checks_balancenumber float

The balance from checks that the bank considers available but holds to earn interest. It increases when check holds are applied and decreases when those holds are released or canceled. minimum: 0 maximum: 9223372036854775807

remunerative_interest_accruednumber float

This balance reflects the total interest pending capitalization. It increases as interest accrues and decreases when the accrued interest is added to the principal balance. minimum: 0 maximum: 9223372036854775807

childreninteger[]

List of child account IDs

status'NORMAL' | 'BLOCKED' | 'CANCELLED'

Account status

external_account_idstring

Custom account ID. Used as the key for all operations (manage accounts, transactions, etc.) on the corporate layer.

This field is:

Unique within the Organization
Immutable: The field cannot be updated.
Not recyclable: You can't reuse an external account ID, even if the account that was using it has been canceled.

currency_numeric_codestring

Numeric code (ISO 4217) for the currency used by the program. minLength: 3 maxLength: 3

currency_alphabetic_codestring

Alphabetic code (ISO 4217) for the currency used by the program. minLength: 3 maxLength: 3

document_numberstring

Entity's government document number. minLength: 1 maxLength: 15

status_reason_idinteger

Account status reason ID minimum: 1 maximum: 4294967295

status_reason_descriptionstring

Account status reason description minLength: 1 maxLength: 500

reason_external_idstring

External reason ID specifying account restrictions minimum: 1 maximum: 120

Example response

{
  "account_id": 102778,
  "account_creation_datetime": "2024-01-04T10:25:30.123Z",
  "division_code": "US",
  "program_id": 492,
  "future_dated_credits_balance": 70,
  "future_dated_debits_balance": 70,
  "parent_account_id": 123,
  "available_balance": 123.45,
  "earmarked_balance": 123.45,
  "overdraft_limit": 123.45,
  "ledger_balance": 270.35,
  "book_balance": 146.9,
  "value_dated_balance": 123.45,
  "uncleared_funds": 123.45,
  "children": [
    102778
  ],
  "status": "NORMAL",
  "external_account_id": "b993ba96-b3e8-4ef7-9cf7-7eee5ddafdab",
  "currency_numeric_code": "840",
  "currency_alphabetic_code": "USD",
  "document_number": "1122334455",
  "status_reason_id": 1438,
  "status_reason_description": "CREDIT_ONLY",
  "reason_external_id": "CREDIT_ONLY"
}