> ## Documentation Index > Fetch the complete documentation index at: https://docs.venlyfinance.com/llms.txt > Use this file to discover all available pages before exploring further. # List transfers > Page through an account's transfers — sent and received, fiat and crypto. Returns the account's transfers. Filter by `accountRole` (`SENDER`/`RECEIVER`) and `status`, and page with `page`/`size` (see [Pagination](/getting-started/conventions#pagination)). **Concept guide:** [Transfers](/guides/finance/transfers) ## OpenAPI ````yaml api-reference/Finance-API-Specs.yaml GET /accounts/{accountId}/transfers openapi: 3.1.0 info: title: Venly Finance API description: > REST API for the Venly Finance platform: - Party management (Individuals & Organisations) - Account management with party association - Wallet balances & token allowances on supported chains (Base, Avalanche) - Virtual bank account assignment for global payments (EUR SEPA) - Fiat-to-crypto payment sessions (pay-in) - Account-to-account fiat & crypto transfers - EIP-2612 permits and payment requests ## Authentication All endpoints use OAuth2 client credentials. Obtain a token first, then include it in every request: **Step 1 — Get a token:** ```bash curl -X POST https://login.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials&client_id={CLIENT_ID}&client_secret={CLIENT_SECRET}" ``` **Step 2 — Use the token:** ``` Authorization: Bearer {access_token} ``` Tokens expire after **5 minutes**. Implement refresh logic in your client. version: 1.1.0 contact: name: Venly Support email: support@venly.io url: https://docs.venlyfinance.com license: name: Proprietary x-logo: url: https://venlyfinance.com/logo.png x-security-contact: security@venly.io servers: - url: https://api.venlyfinance.com/v1 description: Production - url: https://api-staging.venlyfinance.com/v1 description: Staging security: - OAuth2: [] tags: - name: Parties description: Party management (Individuals & Organisations) - name: Accounts description: Account management, party-role associations - name: Wallets description: Blockchain wallet balances - name: Virtual Bank Accounts description: Virtual bank account payment references for global payments - name: Fiat-to-crypto Payment Sessions description: Fiat-to-crypto payment session creation - name: Payment Requests description: Payment request management for card provider integrations - name: Transfers description: Fiat and crypto transfer operations between accounts - name: Permits description: EIP-712 permit signature management for token approvals - name: Allowances description: Token allowance management for wallets paths: /accounts/{accountId}/transfers: get: tags: - Transfers summary: List transfers for account description: > Retrieves all transfers associated with an account (both sent and received, fiat and crypto). Can filter by account role (sender/receiver) and transfer status. operationId: listTransfers parameters: - $ref: '#/components/parameters/AccountId' - name: accountRole in: query description: Filter by the account's role in the transfer schema: type: string enum: - SENDER - RECEIVER example: SENDER - name: status in: query description: Filter by transfer status schema: $ref: '#/components/schemas/TransferStatus' example: COMPLETED - $ref: '#/components/parameters/SortOn' - $ref: '#/components/parameters/SortOrder' - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/Size' responses: '200': description: List of transfers content: application/json: schema: $ref: '#/components/schemas/TransferListResponse' example: success: true result: - id: a1b2c3d4-e5f6-4789-9abc-def012345678 senderAccountId: b2a1f0e9-8c7d-4e3a-9f21-0a1b2c3d4e5f receiverAccountId: c3b2a1f0-9d8c-4e3a-bf21-1a2b3c4d5e60 chain: BASE asset: USDC amount: 25 description: Invoice settlement idempotencyKey: 3fa85f64-5717-4562-b3fc-2c963f66afa6 status: COMPLETED transactionHash: >- 0xa1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2 createdAt: '2026-01-15T09:30:00Z' updatedAt: '2026-01-15T09:30:02Z' - id: b2c3d4e5-f6a7-4890-abcd-ef0123456789 senderAccountId: b2a1f0e9-8c7d-4e3a-9f21-0a1b2c3d4e5f receiverAccountId: c3b2a1f0-9d8c-4e3a-bf21-1a2b3c4d5e60 chain: BASE asset: USDC amount: 10 description: Invoice settlement idempotencyKey: 3fa85f64-5717-4562-b3fc-2c963f66afa6 status: COMPLETED transactionHash: >- 0xa1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2 createdAt: '2026-01-15T09:30:00Z' updatedAt: '2026-01-15T09:30:02Z' pagination: pageNumber: 1 pageSize: 20 numberOfElements: 2 numberOfPages: 1 hasNextPage: false hasPreviousPage: false '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' components: parameters: AccountId: name: accountId in: path required: true description: Unique account identifier schema: type: string format: uuid example: b2a1f0e9-8c7d-4e3a-9f21-0a1b2c3d4e5f SortOn: name: sortOn in: query description: Field to sort by required: false schema: type: string default: createdAt example: createdAt SortOrder: name: sortOrder in: query description: Sort direction required: false schema: type: string default: ASC enum: - ASC - DESC example: DESC Page: name: page in: query description: Page number (1-based indexing) required: false schema: type: integer format: int32 default: 1 minimum: 1 example: 1 Size: name: size in: query description: Number of items per page required: false schema: type: integer format: int32 default: 100 minimum: 1 example: 20 schemas: TransferStatus: type: string description: Status of a transfer enum: - PENDING - COMPLETED - FAILED TransferListResponse: allOf: - $ref: '#/components/schemas/BaseResponse' - type: object properties: result: type: array items: $ref: '#/components/schemas/Transfer' pagination: $ref: '#/components/schemas/Pagination' BaseResponse: type: object properties: success: type: boolean description: Indicates whether the request was successful Transfer: type: object properties: id: type: string format: uuid senderAccountId: type: string format: uuid receiverAccountId: type: string format: uuid chain: $ref: '#/components/schemas/BlockchainNetwork' asset: type: string amount: type: number fiatOrigin: $ref: '#/components/schemas/FiatOrigin' description: type: string merchantReference: type: string idempotencyKey: type: string status: $ref: '#/components/schemas/TransferStatus' transactionHash: type: string errorMessage: type: string createdAt: type: string format: date-time updatedAt: type: string format: date-time Pagination: type: object description: Pagination metadata (top-level sibling of `result`) properties: pageNumber: type: integer format: int32 description: Current page number (1-based) pageSize: type: integer format: int32 description: Number of items per page numberOfElements: type: integer format: int64 description: Total number of items across all pages numberOfPages: type: integer format: int32 description: Total number of pages hasNextPage: type: boolean description: Whether there is a next page hasPreviousPage: type: boolean description: Whether there is a previous page ErrorResponse: type: object description: Error response wrapper properties: success: type: boolean description: Always false for error responses example: false errors: type: array description: List of errors that occurred items: $ref: '#/components/schemas/ErrorBody' result: type: object nullable: true description: Null or omitted when success is false BlockchainNetwork: type: string description: Supported blockchain network enum: - AVALANCHE - BASE - POLYGON FiatOrigin: type: object description: Fiat origin details for a fiat-denominated transfer properties: currency: type: string amount: type: number exchangeRate: type: number ErrorBody: type: object description: Individual error details properties: code: type: string description: Machine-readable error code example: invalid-request message: type: string description: Human-readable error message example: The request contains invalid parameters. responses: BadRequest: description: Request validation failed (400) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - code: invalid-request message: The request contains invalid parameters. Unauthorized: description: Authentication required or failed (401) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - code: unauthenticated message: Please authenticate to perform this action. Forbidden: description: Caller lacks the required authority/role (403) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - code: forbidden message: You do not have permission to access this resource. NotFound: description: Resource not found (404) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - code: account-not-found message: The requested resource was not found. InternalServerError: description: Unexpected server error (500) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false errors: - code: internal-error message: An unexpected error occurred. Please try again later. securitySchemes: OAuth2: type: oauth2 description: > OAuth2 client credentials flow. Token endpoints: - Staging: https://login-staging.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token - Production: https://login.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token flows: clientCredentials: tokenUrl: >- https://login-staging.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token scopes: {} ````