---
title: "Get the transfer request lines list"
method: GET
path: "/transferRequests/{transferRequestId}/transferRequestLines"
tags: ["Transfers"]
---

# Get the transfer request lines list

`GET /transferRequests/{transferRequestId}/transferRequestLines`

## Request

- Base URL: `https://api.groupebpce.com/retail/moneyTransfer/v1`
- URL: `https://api.groupebpce.com/retail/moneyTransfer/v1/transferRequests/{transferRequestId}/transferRequestLines`
- Auth: OAuth 2
  - Authorization code: `/api/oauth/authorize`
  - Token URL: `/api/oauth/token` scopes: `moneyTransfer.transferRequests:READ`

Get a transfers list that fit some criterias. Transfers were initiated throught the API and the debited account is one of the current user.

## Path parameters

- `transferRequestId` string, required

## Query parameters

- `transferRequestLineStatus` string
- `pageSize` integer
- `pageNumber` integer
- `after` string

## Response `200`

OK. The result is a list of TransferRequestLines.

- object
  - `items` TransferRequestLineSummary[], required
    - `transferRequestLineId` string, required: Identifier of a transfer request line.
    - `transferRequestId` string, required: Identifier of a transfer request within the transfer request line is embedded.
    - `amount` Amount, required: Default objet which stands for an amount (number value + currency code).
      - `value` number, double, required: Value of the amount.
      - `currencyCode` string, required: Alphabetical code of the currency code (ISO 4217)
    - `creationDateTime` string, date-time: Timestamp of transfer request creation
    - `status` 'TO_VALIDATE' | 'VALIDATED' | 'WAITING_DECISION' | 'PENDING' | 'REFUSED' | 'CANCELED' | 'REJECTED' | 'EXECUTED' | 'REFUNDED' | 'TERMINATED' | 'REJECTED_BY_RECIPIENT_BANK_AND_REFUNDED', required: Transfer processing status (i.e. a transfer request line status).<table><tr><td> Status </td> <td> Meaning </td></tr> <tr><td>TO_VALIDATE</td> <td>Needs to be validated.</td></tr><tr><td>VALIDATED</td> <td>Validated by the subscriber or by an authorized validator.</td></tr><tr><td>WAITING_DECISION</td> <td>Waiting for a decision.</td></tr><tr><td>PENDING</td> <td>Waiting for execution.</td></tr><tr><td>REFUSED</td> <td>Refused.</td></tr><tr><td>CANCELED</td> <td>Canceled by the subscriber.</td></tr><tr><td>REJECTED</td> <td>Rejected by the system.</td></tr><tr><td>EXECUTED</td> <td>Executed.</td></tr><tr><td>REFUNDED</td> <td>Refunded.</td></tr><tr><td>TERMINATED</td> <td>Terminated.</td></tr><tr><td>REJECTED_BY_RECIPIENT_BANK_AND_REFUNDED</td> <td>Transfer that has been rejected by the beneficiary bank and so the transfer request line is refunded in an individual way.</td></tr></table>
    - `frequencyType` 'ONESHOT' | 'STANDING', required: Indicates if a transfer will be processed only one time or if it is a standing transfer.<table><tr><td>Code</td> <td>Meaning</td></tr><tr><td>ONESHOT</td> <td>The transfer will be processed only one time</td></tr><tr><td>STANDING</td> <td>The transfer will be processed several times in a periodic way</td></tr></table>
    - `requestedExecutionDate` string, date: Requested execution date of the transfer. Significant if executionDeadlineType is DELAYED.
    - `executionDate` string, date: Date of execution of the transfer.
    - `remittanceInformation` string, required: Reason for transfer, transmitted to the recipient
    - `sourceAccount` string, required: Identifier of an account.
    - `recipientAccount` string, required: Identifier of an account.
  - `page` union: A pagination structure. This may be a pagination by index or by cursor.
    - object: Pagination by index of page.
      - `pageSize` integer, required: Number of items by page
      - `pageNumber` integer, required: Page number requested.
      - `totalElements` integer: Number of items matching the query
      - `totalPages` integer: Number of pages of items matching the query
    - object: Pagination via cursor of the last element of the previous call.
      - `pageSize` integer, required: Number of items by page
      - `after` string, required: Cursor of the last element of the previous call. Used to get the next page.

## Other responses

- `400`: Bad Request - HTTP 400
- `401`: Unauthorized - HTTP 401
- `403`: Forbidden - HTTP 403
- `404`: Resource Not Found - HTTP 404
- `500`: Internal Server Error - HTTP 500.
- `503`: Service Unavailable - HTTP 503.

---

[API](https://skmtc.dev/groupebpce/apis/bpce-open-finance-transfer.md) - [All operations](https://skmtc.dev/groupebpce/apis/bpce-open-finance-transfer/llms.txt) - [OpenAPI document](https://skmtc.dev/groupebpce/apis/bpce-open-finance-transfer/revisions/b85ff7120f49?raw)