URL Expired

The URL for this request expired after 30 days.

subaccountId

uuid

required

transactionId

uuid

required

accept

string

enum

Defaults to application/json

Generated from available response content types

application/jsonapplication/problem+json

Allowed:

application/json``application/problem+json

``200 Successful operation

object

_links

object

required

HAL-style links to related resources.

self

object

required

self object

bankAccount

object

required

bankAccount object

card

object

card object

match

object

match object

id

uuid

required

The unique identifier of the bank transaction.

accountId

uuid

required

The unique identifier of the account that owns this transaction.

subaccountId

uuid

required

The unique identifier of the subaccount associated with this transaction.

bankAccountId

uuid

required

The unique identifier of the bank account this transaction belongs to.

cardId

uuid | null

required

The identifier of the card linked to the bank account, used for transaction matching.

matchId

uuid | null

required

The identifier of the transaction match, if this bank transaction has been matched to a card transaction.

date

date

required

The date the transaction was posted, in YYYY-MM-DD format.

amount

number

required

The transaction amount.

currency

string

required

length between 3 and 3

The currency of the transaction following ISO 4217 format.

description

string | null

required

The transaction description provided by the financial institution.

merchantName

string | null

required

The name of the merchant.

category

array of strings | null

required

The transaction categories assigned by the provider.

transactionType

string

enum

required

The type of transaction.

• debit: Money sent (outflow).
• credit: Money received (inflow).

debit``credit

source

string

enum

required

The source of this transaction.

• PLAID: Synced from a connected financial institution via Plaid.
• UPLOAD: Imported from a manually uploaded bank statement.

PLAID``UPLOAD

statementId

uuid | null

The identifier of the bank statement this transaction was imported from, if applicable.

status

string

enum

required

The lifecycle stage of the bank movement, derived from its match pointer and settlement state.

• posted: Synced, not yet matched.
• matched: Paired to a card transaction without an early settlement of its own (e.g. connector off, or a below-HIGH match) — the movement is represented by the card transaction's network settlement, and any standalone it previously emitted is netted to zero.
• settled: A bank-only movement settled standalone on the unified feed.
• early_cleared: A matched movement settled its card transaction early.
• superseded: A previously bank-only movement was retracted or corrected.

posted``matched``settled``early_cleared``superseded

settlement

object | null

required

Settlement outcome on the unified transaction feed. Present when the movement has settled live; null otherwise (unmatched, connector off, or shadow-only).

state

string

enum

required

settled``early_cleared``superseded

emissionType

string

enum

required

early_clearing``bank_only

emittedAt

date-time | null

required

When the settlement was emitted to the feed.

supersededAt

date-time | null

required

When the settlement was superseded or corrected, if applicable.

createdAt

date-time

required

Date and time when this resource was created, in UTC, following ISO 8601 format.

``401 Authentication credentials were either missing or incorrect

``403 Authentication credentials used do not have have permissions to perform the request

``404 The requested resource was not found on the server

``500 The server encountered an unexpected condition that prevented it from fulfilling the request

{
  "_links": {
    "self": {
      "href": "/bank-transactions/1fcb895e-9217-4a6f-9d10-5a7dcef86c11/7f2a9c4e-3b1d-4e8f-a5c7-6d0e2f9b8a3c"
    },
    "bankAccount": {
      "href": "/bank-accounts/3a8f2c1d-5e7b-4d9a-b6c8-9f0e1d2a3b4c"
    },
    "card": {
      "href": "/cards/5dec2c49-0aa5-4683-a317-427eb5d115f3"
    },
    "match": {
      "href": "/transaction-matches/1fcb895e-9217-4a6f-9d10-5a7dcef86c11/b1c2d3e4-f5a6-7b8c-9d0e-1f2a3b4c5d6e"
    }
  },
  "id": "7f2a9c4e-3b1d-4e8f-a5c7-6d0e2f9b8a3c",
  "accountId": "8f3a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
  "subaccountId": "1fcb895e-9217-4a6f-9d10-5a7dcef86c11",
  "bankAccountId": "3a8f2c1d-5e7b-4d9a-b6c8-9f0e1d2a3b4c",
  "cardId": "5dec2c49-0aa5-4683-a317-427eb5d115f3",
  "matchId": "b1c2d3e4-f5a6-7b8c-9d0e-1f2a3b4c5d6e",
  "date": "2025-10-15",
  "amount": 42.5,
  "currency": "USD",
  "description": "UBER TRIP",
  "merchantName": "Uber",
  "category": [
    "Travel"
  ],
  "transactionType": "debit",
  "source": "PLAID",
  "statementId": null,
  "status": "early_cleared",
  "settlement": {
    "state": "early_cleared",
    "emissionType": "early_clearing",
    "emittedAt": "2025-10-15T15:00:00.000Z",
    "supersededAt": null
  },
  "createdAt": "2025-10-15T14:30:00.000Z"
}

Updated 12 days ago