Create a new transfer
POST
/transfer
const url = 'http://localhost:8000/api/v1/transfer';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"client_id":"245cb3df-df3a-428b-a908-e5f74b8d58a3:245cb3df-df3a-428b-a908-e5f74b8d58a4","amount":1,"from_wallet_id":1,"to_wallet_id":1,"exchange_rate":9.23,"datetime":"2026-04-15T12:00:00Z","created_at":"2026-04-15T12:00:00Z","expense_transaction_client_id":"example","income_transaction_client_id":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url http://localhost:8000/api/v1/transfer \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "client_id": "245cb3df-df3a-428b-a908-e5f74b8d58a3:245cb3df-df3a-428b-a908-e5f74b8d58a4", "amount": 1, "from_wallet_id": 1, "to_wallet_id": 1, "exchange_rate": 9.23, "datetime": "2026-04-15T12:00:00Z", "created_at": "2026-04-15T12:00:00Z", "expense_transaction_client_id": "example", "income_transaction_client_id": "example" }'Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ” Media type application/json
object
client_id
Unique identifier for your local client
string format: string
Example
245cb3df-df3a-428b-a908-e5f74b8d58a3:245cb3df-df3a-428b-a908-e5f74b8d58a4 amount
required
number format: float
from_wallet_id
integer
Example
1 to_wallet_id
integer
Example
1 exchange_rate
number format: float
Example
9.23 datetime
string format: date-time
created_at
string format: date-time
expense_transaction_client_id
Client ID of the expense transaction (for sync dedup)
string
income_transaction_client_id
Client ID of the income transaction (for sync dedup)
string
Responses
Section titled “ Responses ”Transfer created successfully
Media type application/json
object
id
ID of the transfer
integer
amount
required
Amount of the transaction
number format: float
from_wallet_id
required
Source wallet
integer
to_wallet_id
required
Destination wallet
integer
exchange_rate
The exchange rate
number format: float
user_id
required
ID of the user
integer
datetime
Date and time of the transfer
string format: date-time
Example generated
{ "id": 1, "amount": 1, "from_wallet_id": 1, "to_wallet_id": 1, "exchange_rate": 1, "user_id": 1, "datetime": "2026-04-15T12:00:00Z"}Invalid input