URL Expired

The URL for this request expired after 30 days.

subaccountId

uuid

required

bankAccountId

uuid

Filter by bank account identifier

cardId

uuid

startDate

date

Filter results from this date (inclusive), in YYYY-MM-DD format

endDate

date

Filter results up to this date (inclusive), in YYYY-MM-DD format

minAmount

number

Filter transactions with an amount greater than or equal to this value

maxAmount

number

Filter transactions with an amount less than or equal to this value

transactionType

string

enum

Filter bank transactions by transaction type

debitdebitcredit

Allowed:

debit``credit

matched

string

enum

Filter bank transactions by match status. Set to true to return only matched transactions, or false for unmatched.

truetruefalse

Allowed:

true``false

source

string

enum

Filter transactions by source.

PLAIDUPLOAD

Allowed:

PLAID``UPLOAD

statementId

uuid

Filter transactions by the statement they were imported from.

limit

integer

1 to 1000

Defaults to 250

Maximum number of items to return

cursor

string

The cursor to use for pagination. Identifies your place on the list

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

items

array of objects

required

items*

object

_links

object

required

HAL-style links to related resources.

_links 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).

settlement object | null

createdAt

date-time

required

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

pagination

object

required

cursor

string

Cursor to use for the next page of results.

hasMore

boolean

required

Whether there are more results available.

``400 The server cannot or will not process the request due to something that is perceived to be a client error

``401 Authentication credentials were either missing or incorrect

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

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

Updated 12 days ago

xxxxxxxxxx

curl --request GET \

--url 'https://api.astrada.co/bank-transactions/subaccountId?limit=250' \

--header 'accept: application/json'

xxxxxxxxxx

{

"items": [

{

"_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": "matched",

"settlement": null,

"createdAt": "2025-10-15T14:30:00.000Z"

},

{

"_links": {

"self": {

"href": "/bank-transactions/1fcb895e-9217-4a6f-9d10-5a7dcef86c11/2e5f8a1b-4c7d-3e9f-b0a2-8d6c4f1e7b3a"

},

"bankAccount": {

"href": "/bank-accounts/3a8f2c1d-5e7b-4d9a-b6c8-9f0e1d2a3b4c"

},

"card": {

"href": "/cards/5dec2c49-0aa5-4683-a317-427eb5d115f3"

}

},

"id": "2e5f8a1b-4c7d-3e9f-b0a2-8d6c4f1e7b3a",

"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": null,

"date": "2025-10-14",

"amount": 156.23,

"currency": "USD",

"description": "AMAZON MARKETPLACE",

"merchantName": "Amazon",

"category": [

"Shopping"

],

"transactionType": "debit",

"source": "PLAID",

"statementId": null,

"status": "posted",

"settlement": null,

"createdAt": "2025-10-14T09:15:00.000Z"

}

],

"pagination": {

"cursor": "ZXhhbXBsZQ==",

"hasMore": true

}

}