Skip to main content
GET
/
v1
/
internal_transfer
/
{internal_transfer_id}
Retrieve an Internal Transfer
curl --request GET \
  --url https://api.sandbox.lead.bank/v1/internal_transfer/{internal_transfer_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "internal_transfer_xyz123",
  "amount": 5000,
  "currency_code": "USD",
  "sender_account_id": "account_xyz123",
  "sender_account_number_id": "account_number_xyz123",
  "receiver_account_id": "account_xyz123",
  "receiver_account_number_id": "account_number_xyz123",
  "status": "posted",
  "description": "<string>",
  "metadata": {},
  "created_at": "2022-06-27T11:22:33Z",
  "updated_at": "2022-06-27T11:22:33Z",
  "rejection": {
    "reason": "account_number_not_active",
    "details": "Account number account_123 is inactive."
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
internal_transfer_id
string
required

The ID of the internal transfer object to be retrieved.

Minimum string length: 5
Pattern: ^internal_transfer_\w+$

Response

An Internal Transfer object.

​
id
string
required

The ID of the Internal Transfer object.

Pattern: ^internal_transfer_\w+$
Example:

"internal_transfer_xyz123"

​
amount
integer<int64>
required

The amount of the transaction in cents.

Required range: 0 <= x <= 9900000000
Example:

5000

​
currency_code
enum<string>
required

A three-letter currency code as defined in ISO 4217.

Available options:
USD
Example:

"USD"

​
sender_account_id
string
required

The ID of the Account object.

Pattern: ^account_\w+$
Example:

"account_xyz123"

​
sender_account_number_id
string
required

The ID of the Lead Bank Account Number object.

Pattern: ^account_number_\w+$
Example:

"account_number_xyz123"

​
receiver_account_id
string
required

The ID of the Account object.

Pattern: ^account_\w+$
Example:

"account_xyz123"

​
receiver_account_number_id
string
required

The ID of the Lead Bank Account Number object.

Pattern: ^account_number_\w+$
Example:

"account_number_xyz123"

​
status
enum<string>
required

The current status of the InternalTransfer object.

Available options:
processing,
posted,
rejected
Example:

"posted"

​
description
string
required

Memo string for the transfer

​
metadata
object
required

A set of key-value pairs that can be used to store additional information related to this object.

​
created_at
string<date-time>
required

The RFC3339 timestamp at which the InternalTransfer object was created.

Example:

"2022-06-27T11:22:33Z"

​
updated_at
string<date-time>
required

The RFC3339 timestamp at which the InternalTransfer object was last updated.

Example:

"2022-06-27T11:22:33Z"

​
rejection
object