GET
/
v0
/
transactions
/
tasks
/
{task_id}
curl --request GET \
  --url https://api.sandbox.teal.dev/v0/transactions/tasks/{task_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'teal-instance-id: <teal-instance-id>'
{
  "id": "UjL3BQnEaJtecuC7CUeDk",
  "status": "pending",
  "created_datetime": "2024-01-01T00:00:00Z",
  "updated_datetime": [
    "2024-01-01T00:00:00Z"
  ],
  "error": null,
  "source_account_id": "<string>",
  "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

Path Parameters

task_id
string
required

The Transaction Processing Task ID.

Response

200
application/json
Successful Response
id
string
required
Example:

"UjL3BQnEaJtecuC7CUeDk"

status
enum<string>
required

Indicates the status of the task.

Available options:
pending,
failed,
complete
Example:

"pending"

created_datetime
string
required

Indicates the datetime in UTC when the task was created.

Example:

"2024-01-01T00:00:00Z"

updated_datetime
string | null
required

Indicates the datetime in UTC when the task was last updated.

Example:
["2024-01-01T00:00:00Z"]
error
object | null
required

The Error object if any errors were encountered in the processing. If the processing task was created by a Plaid import, the Plaid errors will be passed through there. See Plaid's documentation for more information on their error messages.

Example:

null

source_account_id
string
required

The source account containing the transactions

ledger_id
string | null
required

The ID of the ledger that the transactions are being created for.

Example:

"7JRNsKwy2Lw66caxVU7WGC"

created_transaction_ids
string[] | null

The IDs of Transactions successfully processed by this task.

removed_transaction_ids
string[] | null

The IDs of Transactions that were removed by this task.

modified_transaction_ids
string[] | null

The IDs of Transactions that were modified by this task.

skipped_transaction_ids
string[] | null

The IDs of Transactions that were skipped by this task.