> ## Documentation Index
> Fetch the complete documentation index at: https://mcp.docs.relayfi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# get_transaction — Retrieve a single transaction

> Reference for the get_transaction MCP tool. Fetch one transaction by its ID for a given organization with transactions.read scope.

The `get_transaction` tool returns a single transaction by `transactionId` within an organization. Use it when your agent already knows the transaction ID and needs full details. `intent`, `organizationId`, and `transactionId` are required, and the token must carry the `transactions.read` scope.

## Scope

Required OAuth scope: `transactions.read`

## Input

**organizationId** `string` *required*

The organization that owns the transaction. Must be one of the organizations the token can access.

**transactionId** `string` *required*

The unique transaction identifier to retrieve.

**intent** `string` *required*

What the user asked for and why this call serves it, in 1 to 500 characters. Required on every tool call. See [Common tool arguments](https://mcp.docs.relayfi.com/concepts/transport.md#common-tool-arguments).

## Output

**data** `Transaction` *required*

The requested transaction object.

**Transaction**

**object** `string` *required*

Always `"transaction"`.

**id** `string` *required*

Unique transaction identifier.

**organizationId** `string` *required*

Organization the transaction belongs to.

**accountId** `string` *required*

Account the transaction belongs to.

**cardId** `string | null` *required*

Card associated with the transaction, if any.

**amount** `Money` *required*

Unsigned amount as a [Money](https://mcp.docs.relayfi.com/concepts/results.md#money) object. Use `direction` for the sign.

**currency** `string` *required*

Always `"USD"`.

**direction** `string` *required*

Sign carrier for the amount. Values: `debit`, `credit`.

**status** `string` *required*

Transaction lifecycle status. Values: `created`, `processing`, `settled`, `returned`, `canceled`, `pending`, `unknown`.

**type** `string` *required*

Payment rail. Values: `ach`, `wire`, `card`, `check`, `transfer`, `fee`, `interest`, `other`.

**description** `string` *required*

Human-readable description.

**counterpartyName** `string` *required*

Name of the counterparty.

**counterpartyCategory** `string` *required*

Category of the counterparty.

**occurredAt** `string` *required*

Timestamp when the transaction occurred, in RFC 3339 format.

## Example

```json Request theme={null}
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_transaction",
    "arguments": {
      "intent": "User asked for the details of a specific payment they referenced.",
      "organizationId": "org_1",
      "transactionId": "txn_1"
    }
  }
}
```

```json Response theme={null}
{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "structuredContent": {
      "data": {
        "object": "transaction",
        "id": "txn_1",
        "organizationId": "org_1",
        "accountId": "acc_1",
        "cardId": null,
        "amount": { "cents": 12500, "display": "125.00", "currency": "USD" },
        "currency": "USD",
        "direction": "debit",
        "status": "settled",
        "type": "card",
        "description": "Coffee",
        "counterpartyName": "Blue Bottle",
        "counterpartyCategory": "restaurants",
        "occurredAt": "2026-07-01T14:03:00.000Z"
      }
    }
  }
}
```

## Error message

If the transaction does not exist or is not accessible with the provided token, the tool returns an MCP error:

```text theme={null}
Transaction not found or not accessible.
```

> [card] [list\_transactions](https://mcp.docs.relayfi.com/tools/list-transactions.md)
>
> Search and list transactions with filters and pagination.

> [card] [Errors](https://mcp.docs.relayfi.com/concepts/errors.md)
>
> Learn how MCP tool errors and HTTP auth failures are surfaced.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.