# Transfers

Endpoints to initiate transfers and view transfer statuses. Note that for all transfer endpoints, the 'money' field is positive or unsigned for outgoing transfers (debits), and negative for incoming transfers (credits).

## Create incoming transfer

 - [POST /v1/incoming_transfers](https://developer.brex.com/openapi/payments_api/transfers/createincomingtransfer.md): This endpoint creates a new incoming transfer. You may use use any eligible bank account connection to fund (ACH Debit) 
any active Brex business account.

Reminder: You may not use the Brex API for any activity that requires a license or registration from any 
governmental authority without Brex's prior review and approval. This includes but is not limited to any money services
business or money transmission activity.

Please review the Brex Access Agreement and contact us if 
you have any questions.

## Lists transfers

 - [GET /v1/transfers](https://developer.brex.com/openapi/payments_api/transfers/listtransfers.md): This endpoint lists existing transfers for an account.

Currently, the API can only return transfers for the following payment rails:
- ACH
- DOMESTIC_WIRE
- CHEQUE
- INTERNATIONAL_WIRE

## Create transfer

 - [POST /v1/transfers](https://developer.brex.com/openapi/payments_api/transfers/createtransfer.md): This endpoint creates a new transfer.

Currently, the API can only create transfers for the following payment rails:
- ACH
- DOMESTIC_WIRE
- CHEQUE
- INTERNATIONAL_WIRES

Transaction Descriptions
* For outgoing check payments, a successful transfer will return a response containing a description value with a format of Check # to  - .
* For book transfers (from one Brex Business account to another), the recipient value will have a format of  -  and the sender will have a format of  - .
* For other payment rails, the format will be  - , where Counterparty name is payment_instrument.beneficiary_name or contact.name
For vendors created from the Payments API, the counterparty_name will be the company_name field.

Reminder: You may not use the Brex API for any activity that requires a license or registration from any 
governmental authority without Brex's prior review and approval. This includes but is not limited to any money services
business or money transmission activity.

Please review the Brex Access Agreement and contact us if 
you have any questions.

## Get transfer

 - [GET /v1/transfers/{id}](https://developer.brex.com/openapi/payments_api/transfers/gettransfersbyid.md): This endpoint gets a transfer by ID.

Currently, the API can only return transfers for the following payment rails:
- ACH
- DOMESTIC_WIRE
- CHEQUE
- INTERNATIONAL_WIRE