List a Source Account's Transactions

GET

source-accounts

{source_account_id}

transactions

Authorizations

Authorization

string

headerrequired

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

teal-instance-id

string

required

The Teal instance ID

Path Parameters

source_account_id

string

required

The Source Account ID.

Query Parameters

review_status

enum<string> | null

Only return Transactions with a specific review status.

Available options:

unreviewed,

reviewed

posted_status

enum<string> | null

Only return Transactions with a specific posted status.

Available options:

not_posted,

posted,

deleted

start_date

string | null

Only return Transactions created after the start date (inclusive).

end_date

string | null

Only return Transactions before the end start date (inclusive).

time_zone

enum<string>

default: UTC

Time Zone Identifier

Available options:

Africa/Abidjan,

Africa/Accra,

Africa/Addis_Ababa,

Africa/Algiers,

Africa/Asmara,

Africa/Asmera,

Africa/Bamako,

Africa/Bangui,

Africa/Banjul,

Africa/Bissau,

Africa/Blantyre,

Africa/Brazzaville,

Africa/Bujumbura,

Africa/Cairo,

Africa/Casablanca,

Africa/Ceuta,

Africa/Conakry,

Africa/Dakar,

Africa/Dar_es_Salaam,

Africa/Djibouti,

Africa/Douala,

Africa/El_Aaiun,

Africa/Freetown,

Africa/Gaborone,

Africa/Harare,

Africa/Johannesburg,

Africa/Juba,

Africa/Kampala,

Africa/Khartoum,

Africa/Kigali,

Africa/Kinshasa,

Africa/Lagos,

Africa/Libreville,

Africa/Lome,

Africa/Luanda,

Africa/Lubumbashi,

Africa/Lusaka,

Africa/Malabo,

Africa/Maputo,

Africa/Maseru,

Africa/Mbabane,

Africa/Mogadishu,

Africa/Monrovia,

Africa/Nairobi,

Africa/Ndjamena,

Africa/Niamey,

Africa/Nouakchott,

Africa/Ouagadougou,

Africa/Porto-Novo,

Africa/Sao_Tome,

Africa/Timbuktu,

Africa/Tripoli,

Africa/Tunis,

Africa/Windhoek,

America/Adak,

America/Anchorage,

America/Anguilla,

America/Antigua,

America/Araguaina,

America/Argentina/Buenos_Aires,

America/Argentina/Catamarca,

America/Argentina/ComodRivadavia,

America/Argentina/Cordoba,

America/Argentina/Jujuy,

America/Argentina/La_Rioja,

America/Argentina/Mendoza,

America/Argentina/Rio_Gallegos,

America/Argentina/Salta,

America/Argentina/San_Juan,

America/Argentina/San_Luis,

America/Argentina/Tucuman,

America/Argentina/Ushuaia,

America/Aruba,

America/Asuncion,

America/Atikokan,

America/Atka,

America/Bahia,

America/Bahia_Banderas,

America/Barbados,

America/Belem,

America/Belize,

America/Blanc-Sablon,

America/Boa_Vista,

America/Bogota,

America/Boise,

America/Buenos_Aires,

America/Cambridge_Bay,

America/Campo_Grande,

America/Cancun,

America/Caracas,

America/Catamarca,

America/Cayenne,

America/Cayman,

America/Chicago,

America/Chihuahua,

America/Ciudad_Juarez,

America/Coral_Harbour,

America/Cordoba,

America/Costa_Rica,

America/Creston,

America/Cuiaba,

America/Curacao,

America/Danmarkshavn,

America/Dawson,

America/Dawson_Creek,

America/Denver,

America/Detroit,

America/Dominica,

America/Edmonton,

America/Eirunepe,

America/El_Salvador,

America/Ensenada,

America/Fort_Nelson,

America/Fort_Wayne,

America/Fortaleza,

America/Glace_Bay,

America/Godthab,

America/Goose_Bay,

America/Grand_Turk,

America/Grenada,

America/Guadeloupe,

America/Guatemala,

America/Guayaquil,

America/Guyana,

America/Halifax,

America/Havana,

America/Hermosillo,

America/Indiana/Indianapolis,

America/Indiana/Knox,

America/Indiana/Marengo,

America/Indiana/Petersburg,

America/Indiana/Tell_City,

America/Indiana/Vevay,

America/Indiana/Vincennes,

America/Indiana/Winamac,

America/Indianapolis,

America/Inuvik,

America/Iqaluit,

America/Jamaica,

America/Jujuy,

America/Juneau,

America/Kentucky/Louisville,

America/Kentucky/Monticello,

America/Knox_IN,

America/Kralendijk,

America/La_Paz,

America/Lima,

America/Los_Angeles,

America/Louisville,

America/Lower_Princes,

America/Maceio,

America/Managua,

America/Manaus,

America/Marigot,

America/Martinique,

America/Matamoros,

America/Mazatlan,

America/Mendoza,

America/Menominee,

America/Merida,

America/Metlakatla,

America/Mexico_City,

America/Miquelon,

America/Moncton,

America/Monterrey,

America/Montevideo,

America/Montreal,

America/Montserrat,

America/Nassau,

America/New_York,

America/Nipigon,

America/Nome,

America/Noronha,

America/North_Dakota/Beulah,

America/North_Dakota/Center,

America/North_Dakota/New_Salem,

America/Nuuk,

America/Ojinaga,

America/Panama,

America/Pangnirtung,

America/Paramaribo,

America/Phoenix,

America/Port-au-Prince,

America/Port_of_Spain,

America/Porto_Acre,

America/Porto_Velho,

America/Puerto_Rico,

America/Punta_Arenas,

America/Rainy_River,

America/Rankin_Inlet,

America/Recife,

America/Regina,

America/Resolute,

America/Rio_Branco,

America/Rosario,

America/Santa_Isabel,

America/Santarem,

America/Santiago,

America/Santo_Domingo,

America/Sao_Paulo,

America/Scoresbysund,

America/Shiprock,

America/Sitka,

America/St_Barthelemy,

America/St_Johns,

America/St_Kitts,

America/St_Lucia,

America/St_Thomas,

America/St_Vincent,

America/Swift_Current,

America/Tegucigalpa,

America/Thule,

America/Thunder_Bay,

America/Tijuana,

America/Toronto,

America/Tortola,

America/Vancouver,

America/Virgin,

America/Whitehorse,

America/Winnipeg,

America/Yakutat,

America/Yellowknife,

Antarctica/Casey,

Antarctica/Davis,

Antarctica/DumontDUrville,

Antarctica/Macquarie,

Antarctica/Mawson,

Antarctica/McMurdo,

Antarctica/Palmer,

Antarctica/Rothera,

Antarctica/South_Pole,

Antarctica/Syowa,

Antarctica/Troll,

Antarctica/Vostok,

Arctic/Longyearbyen,

Asia/Aden,

Asia/Almaty,

Asia/Amman,

Asia/Anadyr,

Asia/Aqtau,

Asia/Aqtobe,

Asia/Ashgabat,

Asia/Ashkhabad,

Asia/Atyrau,

Asia/Baghdad,

Asia/Bahrain,

Asia/Baku,

Asia/Bangkok,

Asia/Barnaul,

Asia/Beirut,

Asia/Bishkek,

Asia/Brunei,

Asia/Calcutta,

Asia/Chita,

Asia/Choibalsan,

Asia/Chongqing,

Asia/Chungking,

Asia/Colombo,

Asia/Dacca,

Asia/Damascus,

Asia/Dhaka,

Asia/Dili,

Asia/Dubai,

Asia/Dushanbe,

Asia/Famagusta,

Asia/Gaza,

Asia/Harbin,

Asia/Hebron,

Asia/Ho_Chi_Minh,

Asia/Hong_Kong,

Asia/Hovd,

Asia/Irkutsk,

Asia/Istanbul,

Asia/Jakarta,

Asia/Jayapura,

Asia/Jerusalem,

Asia/Kabul,

Asia/Kamchatka,

Asia/Karachi,

Asia/Kashgar,

Asia/Kathmandu,

Asia/Katmandu,

Asia/Khandyga,

Asia/Kolkata,

Asia/Krasnoyarsk,

Asia/Kuala_Lumpur,

Asia/Kuching,

Asia/Kuwait,

Asia/Macao,

Asia/Macau,

Asia/Magadan,

Asia/Makassar,

Asia/Manila,

Asia/Muscat,

Asia/Nicosia,

Asia/Novokuznetsk,

Asia/Novosibirsk,

Asia/Omsk,

Asia/Oral,

Asia/Phnom_Penh,

Asia/Pontianak,

Asia/Pyongyang,

Asia/Qatar,

Asia/Qostanay,

Asia/Qyzylorda,

Asia/Rangoon,

Asia/Riyadh,

Asia/Saigon,

Asia/Sakhalin,

Asia/Samarkand,

Asia/Seoul,

Asia/Shanghai,

Asia/Singapore,

Asia/Srednekolymsk,

Asia/Taipei,

Asia/Tashkent,

Asia/Tbilisi,

Asia/Tehran,

Asia/Tel_Aviv,

Asia/Thimbu,

Asia/Thimphu,

Asia/Tokyo,

Asia/Tomsk,

Asia/Ujung_Pandang,

Asia/Ulaanbaatar,

Asia/Ulan_Bator,

Asia/Urumqi,

Asia/Ust-Nera,

Asia/Vientiane,

Asia/Vladivostok,

Asia/Yakutsk,

Asia/Yangon,

Asia/Yekaterinburg,

Asia/Yerevan,

Atlantic/Azores,

Atlantic/Bermuda,

Atlantic/Canary,

Atlantic/Cape_Verde,

Atlantic/Faeroe,

Atlantic/Faroe,

Atlantic/Jan_Mayen,

Atlantic/Madeira,

Atlantic/Reykjavik,

Atlantic/South_Georgia,

Atlantic/St_Helena,

Atlantic/Stanley,

Australia/ACT,

Australia/Adelaide,

Australia/Brisbane,

Australia/Broken_Hill,

Australia/Canberra,

Australia/Currie,

Australia/Darwin,

Australia/Eucla,

Australia/Hobart,

Australia/LHI,

Australia/Lindeman,

Australia/Lord_Howe,

Australia/Melbourne,

Australia/NSW,

Australia/North,

Australia/Perth,

Australia/Queensland,

Australia/South,

Australia/Sydney,

Australia/Tasmania,

Australia/Victoria,

Australia/West,

Australia/Yancowinna,

Brazil/Acre,

Brazil/DeNoronha,

Brazil/East,

Brazil/West,

CET,

CST6CDT,

Canada/Atlantic,

Canada/Central,

Canada/Eastern,

Canada/Mountain,

Canada/Newfoundland,

Canada/Pacific,

Canada/Saskatchewan,

Canada/Yukon,

Chile/Continental,

Chile/EasterIsland,

Cuba,

EET,

EST,

EST5EDT,

Egypt,

Eire,

Etc/GMT,

Etc/GMT+0,

Etc/GMT+1,

Etc/GMT+10,

Etc/GMT+11,

Etc/GMT+12,

Etc/GMT+2,

Etc/GMT+3,

Etc/GMT+4,

Etc/GMT+5,

Etc/GMT+6,

Etc/GMT+7,

Etc/GMT+8,

Etc/GMT+9,

Etc/GMT-0,

Etc/GMT-1,

Etc/GMT-10,

Etc/GMT-11,

Etc/GMT-12,

Etc/GMT-13,

Etc/GMT-14,

Etc/GMT-2,

Etc/GMT-3,

Etc/GMT-4,

Etc/GMT-5,

Etc/GMT-6,

Etc/GMT-7,

Etc/GMT-8,

Etc/GMT-9,

Etc/GMT0,

Etc/Greenwich,

Etc/UCT,

Etc/UTC,

Etc/Universal,

Etc/Zulu,

Europe/Amsterdam,

Europe/Andorra,

Europe/Astrakhan,

Europe/Athens,

Europe/Belfast,

Europe/Belgrade,

Europe/Berlin,

Europe/Bratislava,

Europe/Brussels,

Europe/Bucharest,

Europe/Budapest,

Europe/Busingen,

Europe/Chisinau,

Europe/Copenhagen,

Europe/Dublin,

Europe/Gibraltar,

Europe/Guernsey,

Europe/Helsinki,

Europe/Isle_of_Man,

Europe/Istanbul,

Europe/Jersey,

Europe/Kaliningrad,

Europe/Kiev,

Europe/Kirov,

Europe/Kyiv,

Europe/Lisbon,

Europe/Ljubljana,

Europe/London,

Europe/Luxembourg,

Europe/Madrid,

Europe/Malta,

Europe/Mariehamn,

Europe/Minsk,

Europe/Monaco,

Europe/Moscow,

Europe/Nicosia,

Europe/Oslo,

Europe/Paris,

Europe/Podgorica,

Europe/Prague,

Europe/Riga,

Europe/Rome,

Europe/Samara,

Europe/San_Marino,

Europe/Sarajevo,

Europe/Saratov,

Europe/Simferopol,

Europe/Skopje,

Europe/Sofia,

Europe/Stockholm,

Europe/Tallinn,

Europe/Tirane,

Europe/Tiraspol,

Europe/Ulyanovsk,

Europe/Uzhgorod,

Europe/Vaduz,

Europe/Vatican,

Europe/Vienna,

Europe/Vilnius,

Europe/Volgograd,

Europe/Warsaw,

Europe/Zagreb,

Europe/Zaporozhye,

Europe/Zurich,

Factory,

GB,

GB-Eire,

GMT,

GMT+0,

GMT-0,

GMT0,

Greenwich,

HST,

Hongkong,

Iceland,

Indian/Antananarivo,

Indian/Chagos,

Indian/Christmas,

Indian/Cocos,

Indian/Comoro,

Indian/Kerguelen,

Indian/Mahe,

Indian/Maldives,

Indian/Mauritius,

Indian/Mayotte,

Indian/Reunion,

Iran,

Israel,

Jamaica,

Japan,

Kwajalein,

Libya,

MET,

MST,

MST7MDT,

Mexico/BajaNorte,

Mexico/BajaSur,

Mexico/General,

NZ,

NZ-CHAT,

Navajo,

PRC,

PST8PDT,

Pacific/Apia,

Pacific/Auckland,

Pacific/Bougainville,

Pacific/Chatham,

Pacific/Chuuk,

Pacific/Easter,

Pacific/Efate,

Pacific/Enderbury,

Pacific/Fakaofo,

Pacific/Fiji,

Pacific/Funafuti,

Pacific/Galapagos,

Pacific/Gambier,

Pacific/Guadalcanal,

Pacific/Guam,

Pacific/Honolulu,

Pacific/Johnston,

Pacific/Kanton,

Pacific/Kiritimati,

Pacific/Kosrae,

Pacific/Kwajalein,

Pacific/Majuro,

Pacific/Marquesas,

Pacific/Midway,

Pacific/Nauru,

Pacific/Niue,

Pacific/Norfolk,

Pacific/Noumea,

Pacific/Pago_Pago,

Pacific/Palau,

Pacific/Pitcairn,

Pacific/Pohnpei,

Pacific/Ponape,

Pacific/Port_Moresby,

Pacific/Rarotonga,

Pacific/Saipan,

Pacific/Samoa,

Pacific/Tahiti,

Pacific/Tarawa,

Pacific/Tongatapu,

Pacific/Truk,

Pacific/Wake,

Pacific/Wallis,

Pacific/Yap,

Poland,

Portugal,

ROC,

ROK,

Singapore,

Turkey,

UCT,

US/Alaska,

US/Aleutian,

US/Arizona,

US/Central,

US/East-Indiana,

US/Eastern,

US/Hawaii,

US/Indiana-Starke,

US/Michigan,

US/Mountain,

US/Pacific,

US/Samoa,

UTC,

Universal,

W-SU,

WET,

Zulu

tag_ids

string[] | null

A comma separated list of Tag IDs. Only return Transactions with all of the given Tags.

expand

enum<string>[] | null

Comma-separated list of Transaction expand paths.

Available options:

ledger,

line_entry,

journal_entry,

opposing_line_entries,

opposing_line_entries.ledger,

transfer,

transfer.matched_transaction,

transfer.matched_transaction.ledger,

transfer.from_journal_entry,

transfer.to_journal_entry

sort

enum<string>[] | null

A comma separated list of sort orders for the results.

Available options:

description,

-description,

datetime,

-datetime

limit

integer | null

default: 50

The number of records to return. Max limit is 100.

Required range: 1 < x < 101

page_token

string

Response

200 - application/json

next_page_token

string | null

required

The token to use to request the next page

prev_page_token

string | null

required

The token to use to request the previous page

records

object[]

required

A list of Transaction objects

records.id

string

required

The unique ID of the object. This is used as an idempotency key to prevent duplicates. This is manually set as part of the create transactions request. If the transaction is created via a data integration, Plaid for example, it will be set to the transaction_id to enforce idempotency with the data source.

records.amount

number

required

The value of the transaction in decimal dollar cents.

records.datetime

string

required

The UTC datetime that the Transaction was created. This will never be before an Instance's entries_start date. When importing transactions, transactions whose datetime is before the Instance’s entries_start date will be skipped. Other transactions will be processed as normal.

records.description

string

required

An arbitrary string on the object, useful for displaying information to the user.

records.metadata

object | null

Arbitrary structured information about the transaction. This could be location of the transaction to display to the user or vendor information to use as part of a Platform or Instance categorization rule. Teal does not use metadata for any accounting purposes.

records.categorization_method

enum<string> | null

How the Transaction was assigned its category.

See the categorization guide for more details.

Available options:

ai,

rules,

similarity,

transfer_between_accounts,

uncategorized,

user

records.posted_status

enum<string>

required

Indicates if the corresponding journal entry and line entries for the transaction have been have been created. deleted indicates that the transaction is posted but the corresponding journal entry and line entries have been deleted.

Available options:

not_posted,

posted,

deleted

records.review_status

enum<string>

required

Indicates if the transaction has been reviewed. See the reviewing transactions for steps on how to use this.

Available options:

unreviewed,

reviewed

records.journal_entry_id

string | null

The ID of the Journal Entry that the Transaction's Line Entry is associated with.

records.journal_entry

object | null

The transaction's Journal Entry. Included in expanded responses.

records.source_account_id

string

required

The ID of the transaction source account where the transaction is stored.

records.ledger_id

string | null

The ID of the financial account ledger associated with the Transaction.

records.ledger

object | null

The transaction's ledger. Included in expanded responses.

records.ledger.id

string

required

The unique ID of the object.

records.ledger.debit_credit

enum<string>

required

Indicates if the ledger is a credit or debit ledger.

Required if financial_account_type is not specified.

Available options:

debit,

credit

records.ledger.editable

boolean

required

Whether line entries can be manually added or removed from the Ledger. Set to false if you control the source of truth for the Ledger and want to restrict user changes, for example, if the Ledger is for a bank account or a payments account you control (i.e. you are a neobank or using a Banking as a Service platform).

records.ledger.is_required

boolean

required

Indicates that the ledger is one of the four system ledgers required for teal to work. In the default chart of accounts, these are named one of: Transfers Between Accounts, Opening Balance Retained Earnings, Uncategorized Cash Inflow, Uncategorized Cash Outflow. You can update the names of these to fit your needs.

records.ledger.name

string

required

The name of the ledger. Teal does not enforce any other conventions or patterns on naming schemes; however, we recommend you use concise, descriptive names, especially for financial account ledgers.

records.ledger.parent_id

string | null

required

If the Ledger is a child Ledger, the ID of the parent Ledger object.

records.ledger.report_cash_flow

boolean

required

Whether Teal includes this ledger in the cash flow report.

Required if financial_account_type is not specified.

records.ledger.sort_code

string

required

Determines the display order in reports, ordered digit by digit, starting from the leftmost position. For example, 20010 will come before 3050.

Teal does not enforce any other conventions or patterns on sort codes. However, it is recommended to adopt a common convention such as starting all ledgers of the same type with the same number (assets start with 1, liabilities start with 2, etc.). The default CoA templates provided by Teal follow best practices for sort code numbering.

records.ledger.sub_type

enum<string>

required

Indicates similar characteristics and accounting treatment for a group of ledgers within a type.

Required if financial_account_type is not specified.

Available options:

current_assets,

non-current_assets,

transfers_between_accounts,

uncategorized_assets,

current_liabilities,

non-current_liabilities,

equity,

operating_revenues,

other_income,

cost_of_goods_sold,

operating_expenses,

other_expenses

records.ledger.type

enum<string>

required

Indicates the purpose and location of the funds and value recorded in the Ledger and which report it is included in: asset, liability and equity ledgers are displayed on the balance sheet; revenue and expenses are displayed on the income statement.

    Required if `financial_account_type` is not specified.

Available options:

asset,

liability,

equity,

revenue,

expense

records.ledger.financial_account_type

enum<string> | null

If specified, indicates that the ledger represents a real-world financial account.

If provided when creating a new Ledger object, you do not need to provide debit_credit, type, sub_type, or report_cash_flow values as we will provide default values.

Available options:

bank_account,

credit_card,

payments,

payroll,

loan,

prepaid_card,

accounts_receivable,

accounts_payable

records.ledger.parent

any | null

Expandable. If the ledger is a child ledger, the parent Ledger object.

records.line_entry_id

string | null

The ID of the financial account ledger associated with the Transaction.

records.line_entry

object | null

The transaction's Line Entry. Included in expanded responses.

records.line_entry.amount

number

required

The value of the line entry in decimal dollar cents.

records.line_entry.debit_credit

enum<string>

required

Indicates if the amount is a credit or debit.

Available options:

debit,

credit

records.line_entry.ledger_id

string

required

The ID of the Line Entry's Ledger. Can be null in some cases for Instances using QuickBooks as their accounting package.

records.line_entry.id

string | null

required

The unique ID of the object. Can be null in some cases for Instances using QuickBooks as their accounting package.

records.line_entry.datetime

string

required

The datetime the Line Entry was created in UTC time.

records.line_entry.editable

boolean

required

Indicates if the Line Entry can be manually added or removed from a Ledger, as dictated by the editable property on the Ledger.

records.line_entry.journal_entry_id

string | null

required

The ID of the associated Journal Entry. Can be null in some cases for Instances using QuickBooks as their accounting package.

records.line_entry.journal_entry_description

string

required

An arbitrary string on the object, useful for displaying to users.

records.line_entry.ledger_name

string

required

The name of the Line Entry's Ledger.

records.line_entry.description

string | null

An arbitrary string on the object, useful for displaying to the user or for categorization.

If the Line Entry is identified as a transfer between accounts, the ID of the Line Entry in the opposing Ledger.

Related guide: Auto-categorization

records.line_entry.transaction_id

string | null

The ID of the associated Transaction, if one exists.

records.line_entry.journal_entry

null

Expandable. The associated Journal Entry object.

records.line_entry.ledger

null

Expandable. The associated Ledger object.

records.line_entry.tags

object[] | null

A list of all the Tags associated with the Line Entry, if any.

records.line_entry.transaction

null

Expandable. The associated Transaction object, if one exists.

records.opposing_line_entry_ids

string[] | null

A list of IDs of all the Line Entries objects in the journal entry with the opposite debit_credit status. For example if the Transaction's line entry is a debit this opposing line entries will be credit line entries.

records.opposing_line_entries

object[] | null

The transaction's opposing Line Entry. Included in expanded responses.

records.opposing_line_entries.amount

number

required

The value of the line entry in decimal dollar cents.

records.opposing_line_entries.debit_credit

enum<string>

required

Indicates if the amount is a credit or debit.

Available options:

debit,

credit

records.opposing_line_entries.description

string | null

An arbitrary string on the object, useful for displaying to the user or for categorization.

records.opposing_line_entries.ledger_id

string

required

The ID of the Line Entry's Ledger. Can be null in some cases for Instances using QuickBooks as their accounting package.

If the Line Entry is identified as a transfer between accounts, the ID of the Line Entry in the opposing Ledger.

Related guide: Auto-categorization

records.opposing_line_entries.transaction_id

string | null

The ID of the associated Transaction, if one exists.

records.opposing_line_entries.id

string | null

required

The unique ID of the object. Can be null in some cases for Instances using QuickBooks as their accounting package.

records.opposing_line_entries.datetime

string

required

The datetime the Line Entry was created in UTC time.

records.opposing_line_entries.editable

boolean

required

Indicates if the Line Entry can be manually added or removed from a Ledger, as dictated by the editable property on the Ledger.

records.opposing_line_entries.journal_entry

object | null

Expandable. The associated Journal Entry object.

records.opposing_line_entries.journal_entry_id

string | null

required

The ID of the associated Journal Entry. Can be null in some cases for Instances using QuickBooks as their accounting package.

records.opposing_line_entries.journal_entry_description

string

required

An arbitrary string on the object, useful for displaying to users.

records.opposing_line_entries.ledger

object | null

Expandable. The associated Ledger object.

records.opposing_line_entries.ledger.id

string

required

The unique ID of the object.

records.opposing_line_entries.ledger.debit_credit

enum<string>

required

Indicates if the ledger is a credit or debit ledger.

Required if financial_account_type is not specified.

Available options:

debit,

credit

records.opposing_line_entries.ledger.editable

boolean

required

records.opposing_line_entries.ledger.is_required

boolean

required

records.opposing_line_entries.ledger.name

string

required

The name of the ledger. Teal does not enforce any other conventions or patterns on naming schemes; however, we recommend you use concise, descriptive names, especially for financial account ledgers.

records.opposing_line_entries.ledger.parent_id

string | null

required

If the Ledger is a child Ledger, the ID of the parent Ledger object.

records.opposing_line_entries.ledger.report_cash_flow

boolean

required

Whether Teal includes this ledger in the cash flow report.

Required if financial_account_type is not specified.

records.opposing_line_entries.ledger.sort_code

string

required

Determines the display order in reports, ordered digit by digit, starting from the leftmost position. For example, 20010 will come before 3050.

records.opposing_line_entries.ledger.sub_type

enum<string>

required

Indicates similar characteristics and accounting treatment for a group of ledgers within a type.

Required if financial_account_type is not specified.

Available options:

current_assets,

non-current_assets,

transfers_between_accounts,

uncategorized_assets,

current_liabilities,

non-current_liabilities,

equity,

operating_revenues,

other_income,

cost_of_goods_sold,

operating_expenses,

other_expenses

records.opposing_line_entries.ledger.type

enum<string>

required

    Required if `financial_account_type` is not specified.

Available options:

asset,

liability,

equity,

revenue,

expense

records.opposing_line_entries.ledger.financial_account_type

enum<string> | null

If specified, indicates that the ledger represents a real-world financial account.

If provided when creating a new Ledger object, you do not need to provide debit_credit, type, sub_type, or report_cash_flow values as we will provide default values.

Available options:

bank_account,

credit_card,

payments,

payroll,

loan,

prepaid_card,

accounts_receivable,

accounts_payable

records.opposing_line_entries.ledger.parent

any | null

Expandable. If the ledger is a child ledger, the parent Ledger object.

records.opposing_line_entries.ledger_name

string

required

The name of the Line Entry's Ledger.

records.opposing_line_entries.tags

object[] | null

A list of all the Tags associated with the Line Entry, if any.

records.opposing_line_entries.transaction

object | null

Expandable. The associated Transaction object, if one exists.

records.opposing_line_entries.transaction.id

string

required

records.opposing_line_entries.transaction.amount

number

required

The value of the transaction in decimal dollar cents.

records.opposing_line_entries.transaction.datetime

string

required

records.opposing_line_entries.transaction.description

string

required

An arbitrary string on the object, useful for displaying information to the user.

records.opposing_line_entries.transaction.posted_status

enum<string>

required

Available options:

not_posted,

posted,

deleted

records.opposing_line_entries.transaction.review_status

enum<string>

required

Indicates if the transaction has been reviewed. See the reviewing transactions for steps on how to use this.

Available options:

unreviewed,

reviewed

records.opposing_line_entries.transaction.source_account_id

string

required

The ID of the transaction source account where the transaction is stored.

records.opposing_line_entries.transaction.personal

boolean

required

Whether the transaction is a non-business personal transaction.

records.opposing_line_entries.transaction.metadata

object | null

records.opposing_line_entries.transaction.categorization_method

enum<string> | null

How the Transaction was assigned its category.

See the categorization guide for more details.

Available options:

ai,

rules,

similarity,

transfer_between_accounts,

uncategorized,

user

records.opposing_line_entries.transaction.journal_entry_id

string | null

The ID of the Journal Entry that the Transaction's Line Entry is associated with.

records.opposing_line_entries.transaction.journal_entry

null

Expandable. The associated Journal Entry object.

records.opposing_line_entries.transaction.ledger_id

string | null

The ID of the financial account ledger associated with the Transaction.

records.opposing_line_entries.transaction.ledger

null

Expandable. The Ledger object of the financial account associated with the Transaction.

records.opposing_line_entries.transaction.line_entry_id

string | null

The ID of the financial account ledger associated with the Transaction.

records.opposing_line_entries.transaction.line_entry

null

Expandable. The associated Line Entry.

records.opposing_line_entries.transaction.opposing_line_entry_ids

string[] | null

records.opposing_line_entries.transaction.opposing_line_entries

null

Expandable. A list of the Line Entry objects with the opposite debit_credit status.

records.opposing_line_entries.transaction.tags

object[] | null

A list of all the Tags associated with the Transaction, if any. Note that Tags are not transitive and the tags on a Transaction can be different than those on its line entry or entires.

records.tags

object[] | null

A list of all the Tags associated with the Transaction, if any. Note that Tags are not transitive and the tags on a Transaction can be different than those on its line entry or entires.

records.personal

boolean

required

Whether the transaction is a non-business personal transaction.

records.transfer_id

string | null

The ID of the Transfer

records.transfer

object | null

The transaction's ledger. Included in expanded responses.

records.transfer.id

string

required

records.transfer.from_journal_entry_id

string

required

The ID of the Journal Entry on the 'from' side of the Transfer

records.transfer.to_journal_entry_id

string

required

The ID of the Journal Entry on the 'to' side of the Transfer

records.transfer.matched_transaction_id

string

required

records.transfer.from_journal_entry

object | null

The Transfer's 'from' Journal Entry. Included in expanded responses.

records.transfer.from_journal_entry.id

string

required

The unique ID of the object.

records.transfer.from_journal_entry.description

string

required

An arbitrary string on the object, useful for displaying to the user.

records.transfer.from_journal_entry.datetime

string

required

The datetime the Journal Entry was created in UTC time.

records.transfer.from_journal_entry.files

object[] | null

A list of files attached to the Journal Entry. Only available to Instances using Platform GL as their accounting package.

records.transfer.from_journal_entry.line_entry_ids

string[] | null

The ids of the Line Entries detailing the Journal Entry's movement of value. Only null if the Instance is using QuickBooks as their accounting package.

records.transfer.from_journal_entry.linked_entity

object | null

The entity that is linked with this journal entry. Journal entries with linked entities may not be modified or deleted directly.

records.transfer.from_journal_entry.line_entries

object[] | null

List of Line Entries. platformGL instances only. Included in expanded responses.

records.transfer.from_journal_entry.line_entries.amount

number

required

The value of the line entry in decimal dollar cents.

records.transfer.from_journal_entry.line_entries.debit_credit

enum<string>

required

Indicates if the amount is a credit or debit.

Available options:

debit,

credit

records.transfer.from_journal_entry.line_entries.description

string | null

An arbitrary string on the object, useful for displaying to the user or for categorization.

records.transfer.from_journal_entry.line_entries.ledger_id

string

required

The ID of the Line Entry's Ledger. Can be null in some cases for Instances using QuickBooks as their accounting package.

If the Line Entry is identified as a transfer between accounts, the ID of the Line Entry in the opposing Ledger.

Related guide: Auto-categorization

records.transfer.from_journal_entry.line_entries.transaction_id

string | null

The ID of the associated Transaction, if one exists.

records.transfer.from_journal_entry.line_entries.id

string | null

required

The unique ID of the object. Can be null in some cases for Instances using QuickBooks as their accounting package.

records.transfer.from_journal_entry.line_entries.datetime

string

required

The datetime the Line Entry was created in UTC time.

records.transfer.from_journal_entry.line_entries.editable

boolean

required

Indicates if the Line Entry can be manually added or removed from a Ledger, as dictated by the editable property on the Ledger.

records.transfer.from_journal_entry.line_entries.journal_entry

object | null

Expandable. The associated Journal Entry object.

records.transfer.from_journal_entry.line_entries.journal_entry_id

string | null

required

The ID of the associated Journal Entry. Can be null in some cases for Instances using QuickBooks as their accounting package.

records.transfer.from_journal_entry.line_entries.journal_entry_description

string

required

An arbitrary string on the object, useful for displaying to users.

records.transfer.from_journal_entry.line_entries.ledger

object | null

Expandable. The associated Ledger object.

records.transfer.from_journal_entry.line_entries.ledger_name

string

required

The name of the Line Entry's Ledger.

records.transfer.from_journal_entry.line_entries.tags

object[] | null

A list of all the Tags associated with the Line Entry, if any.

records.transfer.from_journal_entry.line_entries.transaction

object | null

Expandable. The associated Transaction object, if one exists.

records.transfer.to_journal_entry

object | null

The Transfer's 'to' Journal Entry. Included in expanded responses.

records.transfer.to_journal_entry.id

string

required

The unique ID of the object.

records.transfer.to_journal_entry.description

string

required

An arbitrary string on the object, useful for displaying to the user.

records.transfer.to_journal_entry.datetime

string

required

The datetime the Journal Entry was created in UTC time.

records.transfer.to_journal_entry.files

object[] | null

A list of files attached to the Journal Entry. Only available to Instances using Platform GL as their accounting package.

records.transfer.to_journal_entry.line_entry_ids

string[] | null

The ids of the Line Entries detailing the Journal Entry's movement of value. Only null if the Instance is using QuickBooks as their accounting package.

records.transfer.to_journal_entry.linked_entity

object | null

The entity that is linked with this journal entry. Journal entries with linked entities may not be modified or deleted directly.

records.transfer.to_journal_entry.line_entries

object[] | null

List of Line Entries. platformGL instances only. Included in expanded responses.

records.transfer.to_journal_entry.line_entries.amount

number

required

The value of the line entry in decimal dollar cents.

records.transfer.to_journal_entry.line_entries.debit_credit

enum<string>

required

Indicates if the amount is a credit or debit.

Available options:

debit,

credit

records.transfer.to_journal_entry.line_entries.description

string | null

An arbitrary string on the object, useful for displaying to the user or for categorization.

records.transfer.to_journal_entry.line_entries.ledger_id

string

required

The ID of the Line Entry's Ledger. Can be null in some cases for Instances using QuickBooks as their accounting package.

If the Line Entry is identified as a transfer between accounts, the ID of the Line Entry in the opposing Ledger.

Related guide: Auto-categorization

records.transfer.to_journal_entry.line_entries.transaction_id

string | null

The ID of the associated Transaction, if one exists.

records.transfer.to_journal_entry.line_entries.id

string | null

required

The unique ID of the object. Can be null in some cases for Instances using QuickBooks as their accounting package.

records.transfer.to_journal_entry.line_entries.datetime

string

required

The datetime the Line Entry was created in UTC time.

records.transfer.to_journal_entry.line_entries.editable

boolean

required

Indicates if the Line Entry can be manually added or removed from a Ledger, as dictated by the editable property on the Ledger.

records.transfer.to_journal_entry.line_entries.journal_entry

object | null

Expandable. The associated Journal Entry object.

records.transfer.to_journal_entry.line_entries.journal_entry_id

string | null

required

The ID of the associated Journal Entry. Can be null in some cases for Instances using QuickBooks as their accounting package.

records.transfer.to_journal_entry.line_entries.journal_entry_description

string

required

An arbitrary string on the object, useful for displaying to users.

records.transfer.to_journal_entry.line_entries.ledger

object | null

Expandable. The associated Ledger object.

records.transfer.to_journal_entry.line_entries.ledger_name

string

required

The name of the Line Entry's Ledger.

records.transfer.to_journal_entry.line_entries.tags

object[] | null

A list of all the Tags associated with the Line Entry, if any.

records.transfer.to_journal_entry.line_entries.transaction

object | null

Expandable. The associated Transaction object, if one exists.

records.transfer.matched_transaction

object | null

The Transfer's 'from' Transaction. Included in expanded responses.

records.transfer.matched_transaction.id

string

required

records.transfer.matched_transaction.amount

number

required

The value of the transaction in decimal dollar cents.

records.transfer.matched_transaction.datetime

string

required

records.transfer.matched_transaction.description

string

required

An arbitrary string on the object, useful for displaying information to the user.

records.transfer.matched_transaction.posted_status

enum<string>

required

Available options:

not_posted,

posted,

deleted

records.transfer.matched_transaction.review_status

enum<string>

required

Indicates if the transaction has been reviewed. See the reviewing transactions for steps on how to use this.

Available options:

unreviewed,

reviewed

records.transfer.matched_transaction.source_account_id

string

required

The ID of the transaction source account where the transaction is stored.

records.transfer.matched_transaction.personal

boolean

required

Whether the transaction is a non-business personal transaction.

records.transfer.matched_transaction.metadata

object | null

records.transfer.matched_transaction.categorization_method

enum<string> | null

How the Transaction was assigned its category.

See the categorization guide for more details.

Available options:

ai,

rules,

similarity,

transfer_between_accounts,

uncategorized,

user

records.transfer.matched_transaction.journal_entry_id

string | null

The ID of the Journal Entry that the Transaction's Line Entry is associated with.

records.transfer.matched_transaction.journal_entry

null

Expandable. The associated Journal Entry object.

records.transfer.matched_transaction.ledger_id

string | null

The ID of the financial account ledger associated with the Transaction.

records.transfer.matched_transaction.ledger

object | null

The transaction's ledger. Included in expanded responses.

records.transfer.matched_transaction.ledger.id

string

required

The unique ID of the object.

records.transfer.matched_transaction.ledger.debit_credit

enum<string>

required

Indicates if the ledger is a credit or debit ledger.

Required if financial_account_type is not specified.

Available options:

debit,

credit

records.transfer.matched_transaction.ledger.editable

boolean

required

records.transfer.matched_transaction.ledger.is_required

boolean

required

records.transfer.matched_transaction.ledger.name

string

required

The name of the ledger. Teal does not enforce any other conventions or patterns on naming schemes; however, we recommend you use concise, descriptive names, especially for financial account ledgers.

records.transfer.matched_transaction.ledger.parent_id

string | null

required

If the Ledger is a child Ledger, the ID of the parent Ledger object.

records.transfer.matched_transaction.ledger.report_cash_flow

boolean

required

Whether Teal includes this ledger in the cash flow report.

Required if financial_account_type is not specified.

records.transfer.matched_transaction.ledger.sort_code

string

required

Determines the display order in reports, ordered digit by digit, starting from the leftmost position. For example, 20010 will come before 3050.

records.transfer.matched_transaction.ledger.sub_type

enum<string>

required

Indicates similar characteristics and accounting treatment for a group of ledgers within a type.

Required if financial_account_type is not specified.

Available options:

current_assets,

non-current_assets,

transfers_between_accounts,

uncategorized_assets,

current_liabilities,

non-current_liabilities,

equity,

operating_revenues,

other_income,

cost_of_goods_sold,

operating_expenses,

other_expenses

records.transfer.matched_transaction.ledger.type

enum<string>

required

    Required if `financial_account_type` is not specified.

Available options:

asset,

liability,

equity,

revenue,

expense

records.transfer.matched_transaction.ledger.financial_account_type

enum<string> | null

If specified, indicates that the ledger represents a real-world financial account.

If provided when creating a new Ledger object, you do not need to provide debit_credit, type, sub_type, or report_cash_flow values as we will provide default values.

Available options:

bank_account,

credit_card,

payments,

payroll,

loan,

prepaid_card,

accounts_receivable,

accounts_payable

records.transfer.matched_transaction.ledger.parent

any | null

Expandable. If the ledger is a child ledger, the parent Ledger object.

records.transfer.matched_transaction.line_entry_id

string | null

The ID of the financial account ledger associated with the Transaction.

records.transfer.matched_transaction.line_entry

null

Expandable. The associated Line Entry.

records.transfer.matched_transaction.opposing_line_entry_ids

string[] | null

records.transfer.matched_transaction.opposing_line_entries

null

Expandable. A list of the Line Entry objects with the opposite debit_credit status.

records.transfer.matched_transaction.tags

object[] | null

A list of all the Tags associated with the Transaction, if any. Note that Tags are not transitive and the tags on a Transaction can be different than those on its line entry or entires.

Delete all Transactions in a Source Account Retrieve a Transaction Processing Task

API overview

Teal API Endpoints

API Migration

List a Source Account's Transactions

Authorizations

Headers

Path Parameters

Query Parameters

Response