> ## Documentation Index > Fetch the complete documentation index at: https://docs.waycore.com/llms.txt > Use this file to discover all available pages before exploring further. # List Transactions > Canonical transaction browse and reconciliation endpoint for building a current mirror. This endpoint is not a snapshot-consistent export: pages may reflect changes that happen while you are backfilling. For a no-gap bootstrap, call `GET /v1/transactions/sync` without a cursor and save `nextCursor`, then backfill with this endpoint, then poll `GET /v1/transactions/sync` from the saved cursor. Duplicates between backfill and later sync calls are expected; reconcile by stable `transaction.id`. ## OpenAPI ````yaml /openapi.json get /v1/transactions openapi: 3.1.0 info: title: Waycore Bank Connections API description: >- Developer-first API for direct bank connections, accounts, and transactions. Design goals: - Flat records with minimal nesting. - Clear, bank-centric naming. - One canonical endpoint per resource. - Sparse fieldsets via `fields=`. - Historical browsing via `GET /transactions`. - Incremental ETL via `GET /transactions/sync`. - Discover supported institutions via `GET /institutions`. - Model downstream client businesses via `/entities` and explicit `entityId` ownership. Authentication: - Opaque API keys passed as `Authorization: Bearer `. - Key format: `way___`. - Keys are organization-bound, environment-bound (`live` or `test`), scope-carrying, and expiring. - Managed via the Waycore Console. version: 0.5.0 servers: - url: https://api.waycore.com security: [] paths: /v1/transactions: get: tags: - transactions summary: List Transactions description: >- Canonical transaction browse and reconciliation endpoint for building a current mirror. This endpoint is not a snapshot-consistent export: pages may reflect changes that happen while you are backfilling. For a no-gap bootstrap, call `GET /v1/transactions/sync` without a cursor and save `nextCursor`, then backfill with this endpoint, then poll `GET /v1/transactions/sync` from the saved cursor. Duplicates between backfill and later sync calls are expected; reconcile by stable `transaction.id`. operationId: list_transactions_v1_transactions_get parameters: - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Pagination cursor from a previous `/v1/transactions` response. List cursors are valid only for the same query and sort order, and are not interchangeable with `/v1/transactions/sync` cursors. title: Cursor description: >- Pagination cursor from a previous `/v1/transactions` response. List cursors are valid only for the same query and sort order, and are not interchangeable with `/v1/transactions/sync` cursors. - name: limit in: query required: false schema: type: integer maximum: 500 minimum: 1 title: Limit description: Maximum number of items to return. default: 100 description: Maximum number of items to return. - name: sort in: query required: false schema: enum: - postedDate - '-postedDate' - updatedAt - '-updatedAt' type: string description: >- Sort order. Stable ordering uses the chosen sort field with id as a tiebreaker. default: '-postedDate' title: Sort description: >- Sort order. Stable ordering uses the chosen sort field with id as a tiebreaker. - name: fields in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Comma-separated sparse fieldset. The server always includes required identifiers. title: Fields description: >- Comma-separated sparse fieldset. The server always includes required identifiers. - name: accountId in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: Filter by account identifier. title: Accountid description: Filter by account identifier. - name: connectionId in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: Filter by connection identifier. title: Connectionid description: Filter by connection identifier. - name: entityId in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Entityid description: Filter by entity identifier. description: Filter by entity identifier. - name: status in: query required: false schema: anyOf: - $ref: '#/components/schemas/TransactionStatus' - type: 'null' description: Filter by transaction status. title: Status description: Filter by transaction status. - name: rail in: query required: false schema: anyOf: - $ref: '#/components/schemas/PaymentRail' - type: 'null' description: Filter by payment rail. title: Rail description: Filter by payment rail. - name: postedDateGte in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: >- Return transactions with postedDate greater than or equal to this date. title: Posteddategte description: >- Return transactions with postedDate greater than or equal to this date. - name: postedDateLt in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: Return transactions with postedDate earlier than this date. title: Posteddatelt description: Return transactions with postedDate earlier than this date. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TransactionsListResponse' type: object additionalProperties: true title: Response List Transactions V1 Transactions Get '400': description: >- Bad Request. `type` may be `invalid_request` for malformed query parameters or validation failures, `invalid_fields` when `fields` contains unknown names, or `invalid_cursor` when a list cursor is malformed or does not match the supplied query and sort. content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' '401': content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' description: Forbidden '429': description: >- Too Many Requests. Retry after the number of seconds in `Retry-After` when present, then retry the same request. headers: Retry-After: description: >- Number of seconds to wait before retrying, when rate limiting provides a specific backoff. schema: type: string content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' '500': content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' description: Internal Server Error security: - apiKeyBearer: - transactions:read components: schemas: TransactionStatus: type: string enum: - pending - posted - reversed - cancelled - unknown title: TransactionStatus PaymentRail: type: string enum: - internalTransfer - card - ach - pix - caEft - auNpp - auBecsDirectEntry - auRtgs - sepaCredit - sepaDebit - bacsDirectDebit - wire - swift - fasterPayments - check - cash - crypto - other - unknown title: PaymentRail TransactionsListResponse: properties: data: items: $ref: '#/components/schemas/Transaction' type: array title: Data pagination: $ref: '#/components/schemas/app__transactions__public__models__Pagination' meta: $ref: '#/components/schemas/app__transactions__public__models__Meta' type: object required: - data - pagination - meta title: TransactionsListResponse PublicErrorResponse: properties: type: title: Type type: string message: type: string title: Message requestId: anyOf: - type: string - type: 'null' title: Requestid details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details type: object required: - type - message title: PublicErrorResponse Transaction: properties: id: type: string format: uuid title: Id connectionId: type: string format: uuid title: Connectionid accountId: type: string format: uuid title: Accountid status: $ref: '#/components/schemas/TransactionStatus' description: >- Transaction lifecycle status. Current implementation emits only `pending` and `posted`; other values are reserved for future use. postedDate: anyOf: - type: string format: date - type: 'null' title: Posteddate updatedAt: type: string format: date-time title: Updatedat description: >- When the serialized public transaction representation last changed. It advances when a change would alter a field currently exposed by this API. Internal-only changes and changes to data not currently surfaced here do not change `updatedAt`. amount: type: string title: Amount currency: title: Currency type: string entryType: $ref: '#/components/schemas/EntryType' description: type: string title: Description rawDescription: anyOf: - type: string - type: 'null' title: Rawdescription customerReference: anyOf: - type: string - type: 'null' title: Customerreference bankReference: anyOf: - type: string - type: 'null' title: Bankreference rail: $ref: '#/components/schemas/PaymentRail' baiCode: anyOf: - type: string - type: 'null' title: Baicode category: anyOf: - type: string - type: 'null' title: Category subcategory: anyOf: - type: string - type: 'null' title: Subcategory mcc: anyOf: - type: string - type: 'null' title: Mcc merchantName: anyOf: - type: string - type: 'null' title: Merchantname counterpartyName: anyOf: - type: string - type: 'null' title: Counterpartyname counterpartyAccountMasked: anyOf: - type: string - type: 'null' title: Counterpartyaccountmasked type: object required: - id - connectionId - accountId - status - postedDate - updatedAt - amount - currency - entryType - description - rail title: Transaction app__transactions__public__models__Pagination: properties: hasMore: type: boolean title: Hasmore nextCursor: anyOf: - type: string - type: 'null' title: Nextcursor type: object required: - hasMore title: Pagination app__transactions__public__models__Meta: properties: requestId: type: string title: Requestid type: object required: - requestId title: Meta EntryType: type: string enum: - credit - debit title: EntryType securitySchemes: apiKeyBearer: type: http scheme: bearer bearerFormat: way___ description: >- Opaque API key passed as `Authorization: Bearer `. Keys are organization-bound, environment-bound (`live` or `test`), scope-carrying, and expiring. Create and manage keys via the console. ````