Internal Accounts

An internal_account is a bank account that belongs to your organization. These accounts contain the relevant name, address, entity type information necessary for making payments.

Occasionally banks have different routing numbers for ACH and wire payments. Modern Treasury makes it simple to capture this information in the form of routing details.

MT offers the following account types:

  • checking
  • savings
  • cash
  • general_ledger
  • loan
  • non_resident
  • overdraft
  • other

For most accounts, this will be checking or savings. If the account type is unknown or missing, this will default to other. Not all account types are applicable for every payment_type


AttributeDescription
id
string
Unique identifier for the account.
account_type
string
Pick from the list
party_name
string
The legal name of the entity which owns the account.
party_type
string
Either individual, business or null.
party_address
object
The address associated with the owner or null.
account_details
array object
An array of account detail objects.
routing_details
array object
An array of routing detail objects.
name
string
A nickname for the account
metadata
object
Additional data represented as key-value pairs. Both the key and value must be strings. See Metadata.
live_mode
boolean
This field will be true if this object was created with a production API key or false if created with a test API key.
connection
object
The Connection to the financial institution the accounts belong to.
currency
string
The currency of the account.
parent_account_id
string
The UUID of the parent InternalAccount that this account belongs to. Optional.
counterparty_id
string
The UUID of the Counterparty that this account refers to. Optional.
ledger_account_id
string
The Ledger Account id linked to this internal_account. See Linking to Other Modern Treasury Objects.
{
  "id": "f7b2fc7a-3f22-4f82-b651-fa9e2f8d2653",
  "object": "internal_account",
  "account_type": null,
  "party_name": "Your Company",
  "party_type": null,
  "party_address": {
    "id": "ad326417-4270-4156-8652-dfe1b2ec3ae8",
    "object": "address",
    "line1": "100 Universal City Plaza",
    "line2": null,
    "locality": "Universal City",
    "region": "CA",
    "postal_code": "91608",
    "country": "US"
  },
  "account_details": [
    {
      "id": "f3552822-38f5-4dd5-aa10-a5a2fce00ed6",
      "object": "account_detail",
      "account_number_safe": "934",
      "account_number_type": "other",
      "live_mode": true
    }
  ],
  "routing_details": [
    {
      "id": "2e90da60-405c-44bc-8b33-2bdb9419afe3",
      "object": "routing_detail",
      "payment_type": null,
      "routing_number": "021000021",
      "routing_number_type": "aba",
      "bank_name": "Gringotts Wizarding Bank",
      "bank_address": {
        "id": "fcf5ebe1-b990-4684-880f-f69c277106bb",
        "object": "address",
        "line1": "6000 Universal Boulevard",
        "line2": null,
        "locality": "Orlando",
        "region": "FL",
        "postal_code": "32819",
        "country": "US",
        "live_mode": true
      }
    }
  ],
  "connection": {
    "id": "e680b151-c8a2-4b36-aa6b-059f9f2a969c",
    "object": "connection",
    "vendor_id": "example1",
    "vendor_name": "Gringotts Wizarding Bank"
  },
  "currency": "USD",
  "parent_account_id": "5fcd681b-826c-480c-a565-f2919bcbdb82",
  "counterparty_id": "8646ad4a-f582-454f-9928-148dcb445995",
  "metadata": {},
  "ledger_account_id": null,
  "live_mode": true,
  "created_at": "2019-11-09T00:11:07Z",
  "updated_at": "2019-11-09T00:11:07Z"
}