> ## Documentation Index > Fetch the complete documentation index at: https://docs.teal.dev/llms.txt > Use this file to discover all available pages before exploring further. # List Transaction Processing Tasks > List Transaction Processing Tasks. ## OpenAPI ````yaml GET /v0/transactions/tasks openapi: 3.1.0 info: title: Teal API version: '0.1' servers: - url: https://api.sandbox.teal.dev description: Sandbox - url: https://api.teal.dev description: Production security: [] paths: /v0/transactions/tasks: get: tags: - Transactions summary: List Transaction Processing Tasks description: List Transaction Processing Tasks. operationId: list_txn_processing_tasks_v0_transactions_tasks_get parameters: - name: source_account_id in: query required: false schema: anyOf: - type: string - type: 'null' description: The source account id title: Source Account Id description: The source account id - name: status in: query required: false schema: anyOf: - $ref: '#/components/schemas/TransactionProcessingStatus' - type: 'null' description: The Transaction Processing Task status title: Status description: The Transaction Processing Task status - name: sort in: query required: false schema: anyOf: - type: array items: $ref: '#/components/schemas/TxnProcessingTaskSort' - type: 'null' description: A comma separated list of sort orders for the results. teal_explode: false title: Sort description: A comma separated list of sort orders for the results. - name: ids in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: >- A comma separated list of Transaction Processing Task IDs. Only return Tasks with the specified IDs. Returns 404 if an ID is not found, 403 if any ID is not authorized. teal_explode: false title: Ids description: >- A comma separated list of Transaction Processing Task IDs. Only return Tasks with the specified IDs. Returns 404 if an ID is not found, 403 if any ID is not authorized. - name: limit in: query required: false schema: type: integer minimum: 1 exclusiveMaximum: 1001 description: The number of records to return. Max limit is 1000. default: 50 title: Limit description: The number of records to return. Max limit is 1000. - name: page_token in: query required: false schema: anyOf: - type: string - type: 'null' description: Opaque page token title: Page Token description: Opaque page token - name: teal-instance-id in: header required: true schema: type: string description: The Teal instance ID title: Teal-Instance-Id description: The Teal instance ID responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TxnProcessingTaskPage' '403': content: application/json: schema: $ref: '#/components/schemas/TealErrorResponse' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/TealErrorResponse' description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/TealErrorResponse' description: Unprocessable Content '503': content: application/json: schema: $ref: '#/components/schemas/TealErrorResponse' description: Service Unavailable security: - OAuth2PasswordBearer: [] components: schemas: TransactionProcessingStatus: type: string enum: - pending - posted - complete - failed title: TransactionProcessingStatus TxnProcessingTaskSort: type: string enum: - created_datetime - '-created_datetime' title: TxnProcessingTaskSort TxnProcessingTaskPage: properties: next_page_token: anyOf: - type: string - type: 'null' description: The token to use to request the next page examples: - ikal0NEVfMhF8dJf4yQ6KQZmGD prev_page_token: anyOf: - type: string - type: 'null' description: The token to use to request the previous page examples: - vuA7JeKI5c6FLnPt5JfRcZcJxW records: items: $ref: '#/components/schemas/TxnProcessingTask' type: array title: Records description: A list of Transaction Processing Tasks type: object required: - next_page_token - prev_page_token - records title: TxnProcessingTaskPage TealErrorResponse: properties: message: anyOf: - type: string - type: 'null' title: Message description: A description of the error for API developers. data: title: Data description: Data associated with the error. display_message: anyOf: - type: string - type: 'null' title: Display Message description: A description of the error for end users. error_code: anyOf: - $ref: '#/components/schemas/TealErrorCode' - type: 'null' description: Error code associated with the error. type: object required: - message title: TealErrorResponse TxnProcessingTask: properties: id: type: string title: Id examples: - UjL3BQnEaJtecuC7CUeDk status: $ref: '#/components/schemas/TransactionProcessingStatus' description: Status of the transaction processing task examples: - pending created_datetime: type: string format: date-time title: Created Datetime description: |- Indicates the datetime in UTC when the task was created. examples: - '2024-01-01T00:00:00Z' updated_datetime: anyOf: - type: string format: date-time - type: 'null' title: Updated Datetime description: |- Indicates the datetime in UTC when the task was last updated. examples: - '2024-01-01T00:00:00Z' error: anyOf: - $ref: '#/components/schemas/PlaidError-Output' - $ref: '#/components/schemas/GeneralError' - type: 'null' title: Error description: |- 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](https://plaid.com/docs/errors/) for more information on their error messages. examples: - null source_account_id: type: string title: Source Account Id description: The source account containing the transactions task_type: $ref: '#/components/schemas/TxnProcessingTaskType' description: Type of transaction processing task ledger_id: anyOf: - type: string - type: 'null' title: Ledger Id description: |- The ID of the ledger that the transactions are being created for. examples: - 7JRNsKwy2Lw66caxVU7WGC created_transaction_ids: anyOf: - items: type: string type: array - type: 'null' title: Created Transaction Ids description: |- The IDs of Transactions successfully processed by this task. removed_transaction_ids: anyOf: - items: type: string type: array - type: 'null' title: Removed Transaction Ids description: |- The IDs of Transactions that were removed by this task. modified_transaction_ids: anyOf: - items: type: string type: array - type: 'null' title: Modified Transaction Ids description: |- The IDs of Transactions that were modified by this task. skipped_transaction_ids: anyOf: - items: type: string type: array - type: 'null' title: Skipped Transaction Ids description: |- The IDs of Transactions that were skipped by this task. failed_transaction_ids: anyOf: - items: type: string type: array - type: 'null' title: Failed Transaction Ids description: |- The IDs of Transactions that failed to process in this task. type: object required: - id - status - created_datetime - updated_datetime - error - source_account_id - task_type - ledger_id title: TxnProcessingTask TealErrorCode: type: string enum: - invalid_date - invalid_ledger - missing_parameters - duplicate_name - duplicate_sort_code - invalid_ledger_type - invalid_ledger_report_cash_flow - deleting_required_ledger - repeated_tag_group - deleting_transaction_line - modifying_read_only_ledger - debits_credits_not_equal - modifying_opening_balance_journal_entry - modifying_accrual_journal_entry - modifying_payment_application_journal_entry - invalid_deferral_ledger - duplicate_statement_ending_date - reconciliation_in_progress - reconciled_balance_does_not_match - journal_entry_outside_reconciliation_period - entries_start_date_after_transactions - entries_start_date_after_reconciliations - entries_start_date_after_journal_entries title: TealErrorCode PlaidError-Output: properties: error_type: type: string title: Error Type description: The Plaid error type. examples: - API_ERROR error_code: type: string title: Error Code description: The Plaid error code. examples: - INTERNAL_SERVER_ERROR error_message: type: string title: Error Message description: The Plaid error message. examples: - An unexpected error occurred. display_message: anyOf: - type: string - type: 'null' title: Display Message description: A display message supplied by Plaid. examples: - Something went wrong. request_id: anyOf: - type: string - type: 'null' title: Request Id description: The Plaid request identifier. examples: - KipL51BWnPIpOmi causes: anyOf: - items: $ref: '#/components/schemas/PlaidError-Output' type: array - type: 'null' title: Causes status: anyOf: - type: integer - type: 'null' title: Status description: The status code returned from Plaid. examples: - 500 documentation_url: anyOf: - type: string - type: 'null' title: Documentation Url description: A url to Plaid's documentation about the error. examples: - >- https://plaid.com/docs/errors/api/#internal_server_error-or-plaid-internal-error suggested_action: anyOf: - type: string - type: 'null' title: Suggested Action description: Plaid's suggested action to resolve the error. type: object required: - error_type - error_code - error_message title: PlaidError GeneralError: properties: error_type: type: string title: Error Type description: The error type. examples: - API_ERROR error_message: type: string title: Error Message description: The error message. examples: - An unexpected error occurred. type: object required: - error_type - error_message title: GeneralError TxnProcessingTaskType: type: string enum: - import_transactions - recategorization - delete_date_range - set_business_flag - process_aged_unposted - retry_unposted - legacy title: TxnProcessingTaskType securitySchemes: OAuth2PasswordBearer: type: oauth2 description: >- Bearer authentication header of the form Bearer , where is your auth token. flows: password: scopes: {} tokenUrl: https://developer.teal.dev ````