increase-test
GET/account_transfers/{account_transfer_id}

Retrieve an Account Transfer

Retrieves an Account Transfer by its identifier. Use this operation to inspect the transfer's amount, source and destination Accounts, and current lifecycle status.

1 parameter
account_transfer_idstringrequired
The identifier of the Account Transfer to retrieve.

3 status codes
200Returns the Account Transfer, including its amount, originating and destination Account identifiers, description, and lifecycle status.
account_idstringrequired
The Account from which the transfer originated.
amountintegerrequired
The transfer amount in cents. This will always be positive and indicates the amount of money leaving the originating account.
approvalobjectrequired
If your account requires approvals for transfers and the transfer was approved, this will contain details of the approval.
cancellationobjectrequired
If your account requires approvals for transfers and the transfer was not approved, this will contain details of the cancellation.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the transfer was created.
created_byobjectrequired
What object created the transfer, either via the API or the dashboard.
currencystringrequired
The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the transfer's currency.
Allowed:USD
descriptionstringrequired
An internal-facing description for the transfer for display in the API and dashboard. This will also show in the description of the created Transactions.
destination_account_idstringrequired
The destination Account's identifier.
destination_transaction_idstringrequired
The identifier of the Transaction on the destination Account representing the received funds.
idstringrequired
The Account Transfer's identifier.
idempotency_keystringrequired
The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
pending_transaction_idstringrequired
The ID for the pending transaction representing the transfer. A pending transaction is created when the transfer [requires approval](https://increase.com/documentation/transfer-approvals#transfer-approvals) by someone else in your organization.
statusstringrequired
The lifecycle status of the transfer.
Allowed:pending_approvalcanceledcomplete
transaction_idstringrequired
The identifier of the Transaction on the originating account representing the transferred funds.
typestringrequired
A constant representing the object's type. For this resource it will always be `account_transfer`.
Allowed:account_transfer
4XXReturned when the request encounters a client error.
5XXReturned when the service encounters a server error.

Error handling

The account_transfer_id path parameter must identify the Account Transfer to retrieve. Use the transfer's identifier, rather than an Account or Transaction identifier.