| Time | Status | User Agent | | | :-- | :-- | :-- | :-- | | Make a request to see history. | #### 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 --- ```shell 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 } }