Skip to main content
GET
/
v0
/
transfers
Get Instance Transfers
curl --request GET \
  --url https://api.sandbox.teal.dev/v0/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'teal-instance-id: <teal-instance-id>'
{
  "next_page_token": "ikal0NEVfMhF8dJf4yQ6KQZmGD",
  "prev_page_token": "vuA7JeKI5c6FLnPt5JfRcZcJxW",
  "records": [
    {
      "id": "<string>",
      "from_journal_entry_id": "<string>",
      "to_journal_entry_id": "<string>",
      "from_journal_entry": {
        "id": "<string>",
        "description": "<string>",
        "datetime": "2023-11-07T05:31:56Z",
        "creation_date": "2023-11-07T05:31:56Z",
        "is_opening_balance": true,
        "creation_source": "manual",
        "files": null,
        "line_entry_ids": [
          "XMDsKVuW4Wmi3LTW31Qw6E",
          "NULcvXTkLczde32qs1rqgB"
        ],
        "linked_entity": "<unknown>",
        "line_entries": [
          {
            "amount": 31282.28,
            "datetime": "2023-02-15T06:42:18Z",
            "debit_credit": "debit",
            "description": "Payroll#230215",
            "editable": false,
            "id": "XMDsKVuW4Wmi3LTW31Qw6E",
            "journal_entry_description": "Payroll#230215",
            "journal_entry_id": "C4ocnUQze8kDwQ3EczkZXn",
            "ledger_id": "7JRNsKwy2Lw66caxVU7WGC",
            "ledger_name": "Pluto Checking 4242",
            "tags": [],
            "transaction_id": "txn_UjL3BQnEaJtecuC7CUeDk"
          },
          {
            "amount": 31282.28,
            "datetime": "2023-02-15T06:42:18Z",
            "debit_credit": "credit",
            "description": "Payroll#230215",
            "editable": false,
            "id": "NULcvXTkLczde32qs1rqgB",
            "journal_entry_description": "Payroll#230215",
            "journal_entry_id": "C4ocnUQze8kDwQ3EczkZXn",
            "ledger_id": "HLn8oy2eqMUCwjp1Cwdgco",
            "ledger_name": "Payroll Expense",
            "tags": []
          }
        ]
      },
      "to_journal_entry": {
        "id": "<string>",
        "description": "<string>",
        "datetime": "2023-11-07T05:31:56Z",
        "creation_date": "2023-11-07T05:31:56Z",
        "is_opening_balance": true,
        "creation_source": "manual",
        "files": null,
        "line_entry_ids": [
          "XMDsKVuW4Wmi3LTW31Qw6E",
          "NULcvXTkLczde32qs1rqgB"
        ],
        "linked_entity": "<unknown>",
        "line_entries": [
          {
            "amount": 31282.28,
            "datetime": "2023-02-15T06:42:18Z",
            "debit_credit": "debit",
            "description": "Payroll#230215",
            "editable": false,
            "id": "XMDsKVuW4Wmi3LTW31Qw6E",
            "journal_entry_description": "Payroll#230215",
            "journal_entry_id": "C4ocnUQze8kDwQ3EczkZXn",
            "ledger_id": "7JRNsKwy2Lw66caxVU7WGC",
            "ledger_name": "Pluto Checking 4242",
            "tags": [],
            "transaction_id": "txn_UjL3BQnEaJtecuC7CUeDk"
          },
          {
            "amount": 31282.28,
            "datetime": "2023-02-15T06:42:18Z",
            "debit_credit": "credit",
            "description": "Payroll#230215",
            "editable": false,
            "id": "NULcvXTkLczde32qs1rqgB",
            "journal_entry_description": "Payroll#230215",
            "journal_entry_id": "C4ocnUQze8kDwQ3EczkZXn",
            "ledger_id": "HLn8oy2eqMUCwjp1Cwdgco",
            "ledger_name": "Payroll Expense",
            "tags": []
          }
        ]
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

teal-instance-id
string
required

The Teal instance ID

Query Parameters

from_ledger_id
string

The Transfer's originating ledger id

to_ledger_id
string | null

The Transfer's destination ledger id

expand
enum<string>[] | null

Comma-separated list of Transfer expand paths.

Available options:
from_journal_entry,
to_journal_entry,
from_journal_entry.line_entries,
to_journal_entry.line_entries,
from_journal_entry.line_entries.ledger,
to_journal_entry.line_entries.ledger,
from_journal_entry.line_entries.transaction,
to_journal_entry.line_entries.transaction
limit
integer
default:50

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

Required range: x >= 1
page_token
string | null

Opaque page token

Response

Successful Response

next_page_token
string | null
required

The token to use to request the next page

Example:

"ikal0NEVfMhF8dJf4yQ6KQZmGD"

prev_page_token
string | null
required

The token to use to request the previous page

Example:

"vuA7JeKI5c6FLnPt5JfRcZcJxW"

records
Transfer · object[]
required

A list of Transfer objects