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.

Attribute	Description
id string	Unique identifier for the account.
account_type string	Can be `checking`, `savings` or `other`.
party_name string	The legal name of the entity which owns the account.
party_type string	Either `individual` or `business`.
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	Specifies which 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.

{
  "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": "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": {},
  "live_mode": true,
  "created_at": "2019-11-09T00:11:07Z",
  "updated_at": "2019-11-09T00:11:07Z"
}