Skip to main content
GET
/
v0
/
transactions
/
tasks
List Transaction Processing Tasks
curl --request GET \
  --url https://api.sandbox.teal.dev/v0/transactions/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'teal-instance-id: <teal-instance-id>'
{
  "next_page_token": "ikal0NEVfMhF8dJf4yQ6KQZmGD",
  "prev_page_token": "vuA7JeKI5c6FLnPt5JfRcZcJxW",
  "records": [
    {
      "id": "<string>",
      "status": "pending",
      "created_datetime": "2023-11-07T05:31:56Z",
      "updated_datetime": "2024-01-01T00:00:00Z",
      "error": null,
      "source_account_id": "<string>",
      "task_type": "import_transactions",
      "ledger_id": "7JRNsKwy2Lw66caxVU7WGC",
      "created_transaction_ids": [
        "<string>"
      ],
      "removed_transaction_ids": [
        "<string>"
      ],
      "modified_transaction_ids": [
        "<string>"
      ],
      "skipped_transaction_ids": [
        "<string>"
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
teal-instance-id
string
required

The Teal instance ID

Query Parameters

​
source_account_id
string | null

The source account id

​
status
enum<string> | null

The Transaction Processing Task status

Available options:
pending,
failed,
complete
​
sort
enum<string>[] | null

A comma separated list of sort orders for the results.

Available options:
created_datetime,
-created_datetime
​
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
TxnProcessingTask · object[]
required

A list of Transaction Processing Tasks