get_single_transaction
Read-only
Retrieve detailed information for a specific transaction, including plaid metadata, custom metadata, files, and children for split or group parents. Provides complete transaction details not available in bulk queries.
Instructions
Get details of a specific transaction. The response always includes plaid_metadata, custom_metadata, files, and (for split or group parents) the children array — none of which are returned by default in get_transactions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| transaction_id | Yes | ID of the transaction to retrieve. |
Implementation Reference
- src/tools/transactions.ts:272-304 (registration)Registration of the 'get_single_transaction' tool via server.registerTool(), including its description, inputSchema (transaction_id), and readOnlyHint annotation.
server.registerTool( "get_single_transaction", { description: "Get details of a specific transaction. The response always includes plaid_metadata, custom_metadata, files, and (for split or group parents) the children array — none of which are returned by default in get_transactions.", inputSchema: { transaction_id: z.coerce .number() .describe("ID of the transaction to retrieve."), }, annotations: { readOnlyHint: true, }, }, async ({ transaction_id }) => { try { const response = await api.get( `/transactions/${transaction_id}`, ); if (!response.ok) { return handleApiError( response, "Failed to get transaction", ); } return dataResponse(await response.json()); } catch (error) { return catchError(error, "Failed to get transaction"); } }, ); - src/tools/transactions.ts:286-303 (handler)Handler function for 'get_single_transaction' that calls GET /transactions/{transaction_id} and returns the response data.
async ({ transaction_id }) => { try { const response = await api.get( `/transactions/${transaction_id}`, ); if (!response.ok) { return handleApiError( response, "Failed to get transaction", ); } return dataResponse(await response.json()); } catch (error) { return catchError(error, "Failed to get transaction"); } }, - src/tools/transactions.ts:277-281 (schema)Input schema for the tool: transaction_id (coerced number) describing the ID of the transaction to retrieve.
inputSchema: { transaction_id: z.coerce .number() .describe("ID of the transaction to retrieve."), }, - src/tools/transactions.ts:5-12 (helper)Imports for utility helpers used by the handler: api, dataResponse, handleApiError, catchError from '../api.js'.
import { api, dataResponse, successResponse, handleApiError, catchError, errorResponse, } from "../api.js"; - src/index.ts:28-28 (registration)Top-level registration call: registerTransactionTools(server) which registers all transaction tools including get_single_transaction.
registerTransactionTools(server);