Skip to main content
GET
Retrieve a financial account transaction

Authorizations

Authorization
string
header
required

OAuth2 client_credentials grant for server-to-server access. Onboard via your Nova admin to receive a client_id and client_secret, then POST /oauth/token to exchange them for a short-lived access token. Send the token as Authorization: Bearer <access_token> on every authenticated request. Tokens expire after 3600 seconds — refresh by re-exchanging credentials.

Headers

X-Organization-Id
string

ID of the organization the request acts on. Optional when the access token is bound to a specific organization, or when the integration has access to exactly one organization.

Required string length: 32
Pattern: ^org_[A-Za-z0-9]+$
Example:

"org_EkzhrUc3U6C0UbxNBlK7WLz51ofT"

Path Parameters

fa_id
string
required

ID of the financial account

Required string length: 31
Pattern: ^fa_[A-Za-z0-9]+$
Example:

"fa_RoYxEYPaMtOgRX7lDYzfxVE14uPK"

tx_id
string
required

ID of the transaction

Required string length: 31 - 33
Pattern: ^tx_[A-Za-z0-9]+$
Example:

"tx_jlZBEplxMpzsPGL9IdboNDvQ1jFV"

Response

The transaction

object
enum<string>
required

Object type identifier.

Available options:
transaction
Example:

"transaction"

livemode
boolean
required

Whether this object exists in live mode (true) or test mode (false).

id
string
required

ID of the transaction

Required string length: 31 - 33
Pattern: ^tx_[A-Za-z0-9]+$
Example:

"tx_jlZBEplxMpzsPGL9IdboNDvQ1jFV"

financial_account
string
required

ID of the financial account this transaction belongs to

Required string length: 31
Pattern: ^fa_[A-Za-z0-9]+$
Example:

"fa_RoYxEYPaMtOgRX7lDYzfxVE14uPK"

source
required
TransactionSource

Type: TransactionSource What caused this entry. Null when the transaction has not reached the bank.

workflow
required
TransactionWorkflow

Type: TransactionWorkflow Nova workflow this transaction is related to (e.g. distribution). null for out-of-band bank activity, or non-nova related transactions. New workflow types will be added.

amount
integer | null
required

Signed amount in cents. Positive amounts are credits, and negative amounts are debits. Can be null in some pending cases, but never once settled_at is set.

Example:

-50000

currency
enum<string>
required
Currency

Type: Currency ISO 4217 currency code (USD-only currently)

Available options:
USD
Example:

"USD"

balance
integer | null
required

Running balance after the entry. Null when the bank holds no entry for the row.

Example:

950000

status
enum<string>
required
TransactionStatus

Type: TransactionStatus Where the transaction is in its lifecycle

Available options:
pending,
processing,
completed,
rejected,
returned,
cancelled,
failed,
unknown
Example:

"completed"

description
string | null
required

Short label, when the bank supplies one.

Example:

"Wire to Acme LLC, Chase **7862"

created_at
string<date-time>
required
UtcDateTime

Type: UtcDateTime Date and time in UTC

Example:

"2026-01-01T09:00:00.000Z"

updated_at
string<date-time>
required
UtcDateTime

Type: UtcDateTime Date and time in UTC

Example:

"2026-01-01T09:00:00.000Z"

settled_at
string<date-time>
required
UtcDateTime

Type: UtcDateTime Date and time in UTC

Example:

"2026-01-01T09:00:00.000Z"