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.

Attribute	Description
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.
vendor_id string	The vendor ID associated with this account.
account_capabilities array object	An array of account capability 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",
	"vendor_id": null,
  "account_capabilities": [
    {
		 	"id": "2e90da60-405c-44bc-8b33-2bdb9419afe3",
      "object": "account_capability",
      "payment_type": "wire",
      "live_mode": true,		
      "identifier": "9140032",
			"created_at": "2019-11-09T00:11:07Z",
      "updated_at": "2019-11-09T00:11:07Z",
			"discard_at": null
    },
    {
			"id": "2e90da60-405c-44bc-8b33-2bdb9419afe3",
      "object": "routing_detail",
      "payment_type": "ach",
			"live_mode": true,		
      "identifier": "9140001",
			"created_at": "2019-11-09T00:11:07Z",
      "updated_at": "2019-11-09T00:11:07Z",
			"discard_at": null
		}
	]
}