Get Transactions

get/v1/transactions/{transaction_id}

Fetches a single transaction by its public id within the active workspace. Read only, no side effects. Returns 404 when the id is unknown or falls outside the caller's workspace scope.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

Name	Type	Required	Description
transaction_id	string <uuid>	Yes	Public UUID of the transaction.e.g. f0e1d2c3-0000-4000-8000-0000000000a1

Query parameters

Name	Type	Required	Description
workspaceId	string <uuid>	No	Explicit workspace scope. The authenticated user must hold an active membership in this workspace. Defaults to the session workspace when omitted.e.g. a1b2c3d4-0000-4000-8000-000000000001

Request

cURL

curl -X GET https://api.wellapp.ai/v1/transactions/{transaction_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — The requested transaction.

{
  "data": {
    "type": "transaction",
    "id": "f0e1d2c3-0000-4000-8000-0000000000a1",
    "attributes": {
      "transaction_id": "f0e1d2c3-0000-4000-8000-0000000000a1",
      "transaction_external_id": "txn_stripe_3PqRb2",
      "type": "credit",
      "status": "booked",
      "scheme": "sepa_credit_transfer",
      "instructed_amount": {
        "amount": 4820.5,
        "currency": "USD"
      },
      "settlement_amount": {
        "amount": 4820.5,
        "currency": "USD"
      },
      "fees": null,
      "foreign_exchange": null,
      "remittance": {
        "unstructured": "STRIPE PAYOUT FOLDSPACE AI"
      },
      "booking_date": "2026-04-27",
      "value_date": "2026-04-27",
      "executed_at": "2026-04-27T09:14:32Z",
      "category_normalized": "platform_payout",
      "category_source": "model",
      "category_confidence": 0.97,
      "created_at": "2026-04-27T09:15:00Z",
      "updated_at": "2026-04-27T09:15:00Z",
      "deleted_at": null
    },
    "relationships": {
      "debtor_payment_means": {
        "data": {
          "type": "PaymentMeans",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "creditor_payment_means": {
        "data": {
          "type": "PaymentMeans",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "account_balance": {
        "data": {
          "type": "AccountBalance",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "sourceWorkspaceConnector": {
        "data": {
          "type": "WorkspaceConnector",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "ledger_account": {
        "data": {
          "type": "LedgerAccount",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "transaction_documents": {
        "data": [
          {
            "type": "TransactionDocument",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        ]
      },
      "transactionWorkspaceConnectors": {
        "data": [
          {
            "type": "TransactionWorkspaceConnector",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        ]
      }
    }
  }
}

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — Not found

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}