Accounts

Overview

The Accounts module of the Customer API is a crucial component designed to provide a comprehensive view of a customer's financial activities within the system. This module features three primary API endpoints, each are essential for a different aspect of account information retrieval:

1. Create Asset Account: Allows users to set up new asset accounts for customers, defining the account's name and currency. This is often the first step in customer account management, necessary before any transactions or account customizations can take place. By default, a customer will not have an account for a most currencies until an asset account is created, or if they do an exchange into that currency.

2. Get Asset Account by ID: By specifying an account ID, users can obtain detailed information about a particular customer account. This functionality allows users to quickly access specific account details as needed.

3. Get Manager Account Balances - This endpoint allows customers to quickly obtain real-time information about the current state of their accounts, including the available balance and any pending transactions that might affect this balance.

4. List Asset Accounts for Customer - This endpoint allows customers to quickly obtain real-time information about the current state of either the manager or a managee accounts. This endpoint differs from Get Manager Account Balances as you can specify a CustomersID to retrieve account information for, where as the prior endpoint will only retrieve account details for the manager.

5. List Transactions - A historical record is vital for customers to track their spendings, earnings, and all other transaction activities. The 'List Transactions' endpoint serves this need by enabling customers to retrieve a list of all their transactions over a specified period. This function helps them review their financial movements comprehensively.

6. Get Transaction Details - For a deeper dive into any particular transaction, this endpoint is critical. Customers can use it to fetch detailed information about a single transaction, allowing for an in-depth understanding of specific financial events, such as the parties involved, the transaction amount, date, status, and any associated fees.

7. Withdraw Crypto from Customer Account to External Wallet - This operation allows users to initiate withdrawals from a customer's cryptocurrency account to an external wallet, effectively moving assets out of the customer's account.

8. Get Deposit Address for a Crypto Asset Account - Enables users to retrieve the deposit address of a cryptocurrency wallet associated with a customer's asset account. By retrieving a deposit address, users can make an external deposit and see the transaction reflected in their account once it's been confirmed.

---

Create Asset Account

This API endpoint is used to create a new account for a customer. It requires the ID of the customer, the desired name for the account, and the account asset (currency).

When someone wants to create an account for a customer, they use a specific pathway on our system to set it up. They need to provide who it's for (the customer's ID), what they want to call it (name of the account), and what kind of currency it will use (like USD). Once they send this info, our system creates the account and sends back details like the account number and balances. It's like opening a bank account for someone else, making sure it's labeled and set up with the right details. A managed customer will have an account created for each account held by the manager.

• Endpoint: /api/v2/customer/accounts/create

• Method: POST

Create an account for a customer

Request body:

• CustomersId: Id of the customer
• Name: Name of the account (max length 100)
• Asset: account asset

Response:

• CustomersId: Id of the customer
• CustomersReference: User set customer reference
• Account: Account object
  • Id: Account Id
  • Name: Name of the account
  • RoutingNumber: Account routing number
  • AccountNumber: Account number
  • Reference: Account reference
  • Asset: Account asset
  • TotalBalance: Account total balance
  • AvailableBalance: Account available balance
  • PendingBalance: Account pending balance
  • bSuppressed: is account suppressed

Possible validation errors:

• Required
• Invalid (field value invalid)
• Invalid_Length (field exceeds length limit (100))
• Account_Limit_Reached (account limit has been reached)

POST/api/v2/customer/accounts/create

Header parameters

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

customersIdinteger (int32)

namenullable string

assetnullable string

Response

200400

OK

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Dtos.CustomerRole.AccountsV2Module.CreateMultipleAccountResponseDto (object)

Request

JavaScriptCurlPython

const response = await fetch('/api/v2/customer/accounts/create', {
    method: 'POST',
    headers: {
      "otp": "text",
      "Content-Type": "application/json-patch+json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "id": 0,
  "details": {
    "customersId": 0,
    "customersReference": "text",
    "accounts": [
      {
        "id": 0,
        "name": "text",
        "routingNumber": "text",
        "accountNumber": "text",
        "swiftCode": "text",
        "reference": "text",
        "asset": "text",
        "totalBalance": 0,
        "availableBalance": 0,
        "pendingBalance": 0,
        "bSuppressed": false
      }
    ]
  }
}

Request Parameters:

• CustomersId (Integer): The ID of the customer.

• Name (String): The name of the account.

• Asset (String): The asset (currency) of the account, currently limited to USD and supported cryptocurrencies.

Request Example:

{
  "CustomersId": 1037,
  "Name": "Fiat account",
  "Asset": "USD"
}

Response Parameters:

• id (Integer): This field is not used in the response.

• details.customersId (Integer): The ID of the customer.

• details.customersReference (String): User-set customer reference.

• details.accounts (Object Array): Contains details of the created accounts.

• details.accounts.id (Integer): The ID of the newly created account.

• details.accounts.name (String): The name of the account.

• details.accounts.routingNumber (String): The routing number of the account.

• details.accounts.accountNumber (String): The account number.

• details.accounts.asset (String): The asset (currency) of the account.

• details.accounts.totalBalance (Decimal): The total balance of the account.

• details.accounts.availableBalance (Decimal): The available balance of the account.

• details.accounts.pendingBalance (Decimal): The pending balance of the account.

• details.accounts.bSuppressed (Bool): Indicates whether the account is suppressed.

Success Response Example:

{
    "id": 0,
    "details": {
        "customersId": 1728,
        "customersReference": "CST1728",
        "accounts": [
            {
                "id": 3770,
                "name": "Fiat account",
                "routingNumber": "999999999",
                "accountNumber": "123456789",
                "swiftCode": null,
                "reference": "REF3770",
                "asset": "USD",
                "totalBalance": 0.0,
                "availableBalance": 0.0,
                "pendingBalance": 0.0,
                "bSuppressed": false
            }
        ]
    },
    "status": "1",
    "errors": []
}

Possible Error Messages

Error Message Code	Description
Required	Named field is missing or zero
Invalid	Value given for named field is invalid
Documents_Not_Verified	Cannot perform this action for this customer due to the KYC state

---

Get Asset Account by ID

This API endpoint retrieves the details of a single account by its unique identifier (ID). This gives you the ability to look up a specific account's details using its unique number. It shows you everything you need to know about this account, including what type of currency it has and its current balance.

• Endpoint: /api/v1/customer/accounts/account

• Method: GET

• Query Parameter:

  • Id (Integer): The unique Account ID.

Get account by Id

Request query:

• Id: Account Id

Response:

• Id: Account Id
• CustomersId: Id of customer to which the account belongs
• Name: Name of the account
• RoutingNumber: Account routing number
• AccountNumber: Account number
• Reference: Account reference
• Asset: Account asset
• TotalBalance: Account total balance
• AvailableBalance: Account available balance
• PendingBalance: Account pending balance
• bSuppressed: true if account is suppressed
• DateAdded: date account was added

GEThttp://public-api.ibanera.com/api/v1/customer/accounts/account

Query parameters

Header parameters

Response

200404

Success

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Dtos.CustomerRole.AccountsModule.AccountDto (object)

Request

JavaScriptCurlPython

const response = await fetch('http://public-api.ibanera.com/api/v1/customer/accounts/account', {
    method: 'GET',
    headers: {
      "otp": "text"
    },
});
const data = await response.json();

Response

200404

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "id": 0,
  "details": {
    "id": 0,
    "customersId": 0,
    "name": "text",
    "routingNumber": "text",
    "accountNumber": "text",
    "swiftCode": "text",
    "reference": "text",
    "asset": "text",
    "totalBalance": 0,
    "availableBalance": 0,
    "pendingBalance": 0,
    "bSuppressed": false,
    "dateAdded": "2024-12-21T12:03:20.057Z"
  }
}

Response Body Parameters and Types:

• id (Integer): A reference ID for the operation; typically the requested Account ID.

• details (Object): Contains the detailed information of the account.

  • id (Integer): The account’s unique ID.

  • customersId (Integer): The customer’s ID related to this account.

  • name (String): The name of the account.

  • routingNumber (String): The routing number associated with the account.

  • accountNumber (String): The account number.

  • asset (String): The account's currency code.

  • totalBalance (Decimal): The total balance available in the account.

  • availableBalance (Decimal): The balance readily available for transactions.

  • pendingBalance (Decimal): The balance currently in processing (not yet cleared).

  • bSuppressed (Boolean): Indicates whether the account is suppressed or active.

  • dateAdded (String): The date and time when the account was added.

• status (String): The status of the request.

• errors (Array): Any error messages, if present.

Success Response Example:

{
  "id": 1025,
  "details": {
    "id": 1055,
    "customersId": 1004,
    "name": "Account Name",
    "routingNumber": "021214891",
    "accountNumber": "357901009807",
    "asset": "USD",
    "totalBalance": 100.0,
    "availableBalance": 0.0,
    "pendingBalance": 100.0,
    "bSuppressed": false,
    "dateAdded": "2022-07-07T16:33:08.413+00:00"
  },
  "pageSize": 10,
  "pageNumber": 1,
  "numberOfPages": 1,
  "status": "1",
  "errors": []
}

The response returns an object containing detailed information about the customer's account, including the name, routing and account numbers, asset (currency), balances, suppress status, and the date the account was added.

---

Get Manager Account Balances

Fetches a list of the manager's asset accounts along with the current balances, including total, available, and pending balances. This endpoint is essential for users to obtain a clear overview of their financial status within the system. If you would like to get balances of a managee, use the Get List of Accounts for a Managee by ID endpoint.

• Endpoint: /api/v1/customer/accounts/balances

• Method: GET

List of asset accounts

Response:

• assetAccountId: Asset account ID
• asset: Asset account asset
• totalBalance: Total balance
• availableBalance: Total balance minus incoming pending transaction amounts
• pendingBalance: Sum of pending transaction amounts

GEThttps://public-api.ibanera.com/api/v1/customer/accounts/balances

Query parameters

Header parameters

Response

200400

Success

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsnullable array of AvamaeTemplate.Core.Types.Dtos.CustomerRole.AccountsModule.AccountsDto (object)

pageSizenullable integer (int32)

pageNumbernullable integer (int32)

numberOfPagesnullable integer (int32)

Request

JavaScriptCurlPython

const response = await fetch('https://public-api.ibanera.com/api/v1/customer/accounts/balances', {
    method: 'GET',
    headers: {
      "otp": "text"
    },
});
const data = await response.json();

Response

200400

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "id": 0,
  "details": [
    {
      "id": 0,
      "asset": "text",
      "totalBalance": 0,
      "availableBalance": 0,
      "pendingBalance": 0,
      "bSuppressed": false
    }
  ],
  "pageSize": 0,
  "pageNumber": 0,
  "numberOfPages": 0
}

Query Parameters:

• pageNumber (Integer, Optional): The page of results to return.

• pageSize (Integer, Optional): The maximum number of results to return.

If pageNumber and pageSize are not supplied, then an unpaginated list will be returned.

Request Example:

To request the first page with ten results:

GET /api/v1/customer/accounts/balances?pageNumber=1&pageSize=10

Response Body Parameters:

• id (Integer): Not used in the example.

• details (Array of Objects): Each object contains the details of an asset account balance.

  • id (Integer): The ID of the asset account.

  • asset (String): The type of asset the account holds.

  • totalBalance (Decimal): The total balance in the account.

  • availableBalance (Decimal): The available balance that is ready for use.

  • pendingBalance (Decimal): The balance that is currently in pending transactions and not yet cleared.

  • bSuppressed (Boolean): Indicates whether the use of this account is currently disabled.

Success Response Example:

{
  "id": 0,
  "details": [
    {
      "id": 1000,
      "asset": "USDC",
      "totalBalance": 100.00,
      "availableBalance": 98.00,
      "pendingBalance": 2.00,
      "bSuppressed": false
    }
  ],
  "pageSize": 10,
  "pageNumber": 1,
  "status": "1",
  "errors": []
}

---

List Asset Accounts for Customer

Fetches a list of asset accounts along with the current balances for a CustomersID, including total, available, and pending balances. This endpoint is essential for users to obtain a clear overview of their financial status within the system.

• Endpoint: /api/v1/customer/accounts/list-accounts

• Method: GET

Get a list of accounts

Request query:

• CustomersId: Customer's Id filter
• Asset: Asset filter
• PageNumber: List page number (optional, default = 1)
• PageSize: List page size (optional, default = 10)

Response:

• array of
  • Id: Account Id
  • Name: Name of the account
  • RoutingNumber: Account routing number
  • AccountNumber: Account number
  • Asset: Account asset
  • TotalBalance: Account total balance
  • AvailableBalance: Account available balance
  • PendingBalance: Account pending balance
  • bSuppressed: true if account is suppressed
  • DateAdded: date account was added

GET/api/v1/customer/accounts/list-accounts

Query parameters

Header parameters

Response

200400

OK

Body

application/json

idinteger (int64)

detailsnullable array of CustomerRole.AccountsModule.CustomerAccountDto (object)

pageSizenullable integer (int32)

pageNumbernullable integer (int32)

numberOfPagesnullable integer (int32)

statusnullable string

errorsnullable array of Results.Base.ErrorResultDto (object)

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/customer/accounts/list-accounts', {
    method: 'GET',
    headers: {
      "otp": "text"
    },
});
const data = await response.json();

Response

200400

{
  "id": 0,
  "details": [
    {
      "id": 0,
      "customersId": 0,
      "name": "text",
      "routingNumber": "text",
      "accountNumber": "text",
      "swiftCode": "text",
      "virtualAccountNumber": "text",
      "reference": "text",
      "asset": "text",
      "assetDisplayName": "text",
      "totalBalance": 0,
      "availableBalance": 0,
      "pendingBalance": 0,
      "bSuppressed": false,
      "dateAdded": "2024-12-21T12:03:20.057Z"
    }
  ],
  "pageSize": 0,
  "pageNumber": 0,
  "numberOfPages": 0,
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ]
}

Success Response Example:

{
    "id": 14631,
    "details": [
        {
            "id": 4646,
            "customersId": 14391,
            "name": "dUSD Account",
            "routingNumber": null,
            "accountNumber": null,
            "swiftCode": null,
            "virtualAccountNumber": null,
            "reference": null,
            "asset": "dUSD",
            "assetDisplayName": "dUSD",
            "totalBalance": 0.000000000000000000,
            "availableBalance": 0.000000000000000000,
            "pendingBalance": 0.000000000000000000,
            "bSuppressed": false,
            "dateAdded": "2024-09-10T03:58:40.1066667+00:00"
        },
        {
            "id": 4681,
            "customersId": 14391,
            "name": "USD Account (Domestic)",
            "routingNumber": "999999999",
            "accountNumber": "336674726730",
            "swiftCode": null,
            "virtualAccountNumber": null,
            "reference": "REF4681",
            "asset": "USD",
            "assetDisplayName": "United States Dollar",
            "totalBalance": 999935.160000000000000000,
            "availableBalance": 999934.160000000000000000,
            "pendingBalance": -50.000000000000000000,
            "bSuppressed": false,
            "dateAdded": "2024-09-11T18:29:10.4833333+00:00"
        },
        {
            "id": 6306,
            "customersId": 14391,
            "name": "AED Account",
            "routingNumber": null,
            "accountNumber": "11020048859",
            "swiftCode": "GLDTSGSG",
            "virtualAccountNumber": null,
            "reference": "REF6306",
            "asset": "AED ",
            "assetDisplayName": "Arab Emirates Dirham",
            "totalBalance": 1000000.000000000000000000,
            "availableBalance": 1000000.000000000000000000,
            "pendingBalance": 0.000000000000000000,
            "bSuppressed": false,
            "dateAdded": "2024-11-20T05:18:41.4566667+00:00"
        },
        {
            "id": 6307,
            "customersId": 14391,
            "name": "AUD Account",
            "routingNumber": null,
            "accountNumber": "11020048859",
            "swiftCode": "GLDTSGSG",
            "virtualAccountNumber": null,
            "reference": "REF6307",
            "asset": "AUD",
            "assetDisplayName": "Australian Dollar",
            "totalBalance": 999985.000000000000000000,
            "availableBalance": 999985.000000000000000000,
            "pendingBalance": -15.000000000000000000,
            "bSuppressed": false,
            "dateAdded": "2024-11-20T05:18:41.4566667+00:00"
        },
        {
            "id": 6308,
            "customersId": 14391,
            "name": "CNH Account",
            "routingNumber": null,
            "accountNumber": "11020048859",
            "swiftCode": "GLDTSGSG",
            "virtualAccountNumber": null,
            "reference": "REF6308",
            "asset": "CNH",
            "assetDisplayName": "Chinese Yuan Renminbi",
            "totalBalance": 999892.930000000000000000,
            "availableBalance": 999892.930000000000000000,
            "pendingBalance": -107.070000000000000000,
            "bSuppressed": false,
            "dateAdded": "2024-11-20T05:18:41.4566667+00:00"
        },
        {
            "id": 6309,
            "customersId": 14391,
            "name": "EUR Account",
            "routingNumber": null,
            "accountNumber": "11020048859",
            "swiftCode": "GLDTSGSG",
            "virtualAccountNumber": null,
            "reference": "REF6309",
            "asset": "EUR",
            "assetDisplayName": "Euro",
            "totalBalance": 999985.870000000000000000,
            "availableBalance": 999985.870000000000000000,
            "pendingBalance": -14.130000000000000000,
            "bSuppressed": false,
            "dateAdded": "2024-11-20T05:18:41.4566667+00:00"
        },
        {
            "id": 6310,
            "customersId": 14391,
            "name": "GBP Account",
            "routingNumber": null,
            "accountNumber": "11020048859",
            "swiftCode": "GLDTSGSG",
            "virtualAccountNumber": null,
            "reference": "REF6310",
            "asset": "GBP",
            "assetDisplayName": "Pound Sterling",
            "totalBalance": 999988.330000000000000000,
            "availableBalance": 999988.330000000000000000,
            "pendingBalance": -11.670000000000000000,
            "bSuppressed": false,
            "dateAdded": "2024-11-20T05:18:41.4566667+00:00"
        },
        {
            "id": 6311,
            "customersId": 14391,
            "name": "HKD Account",
            "routingNumber": null,
            "accountNumber": "11020048859",
            "swiftCode": "GLDTSGSG",
            "virtualAccountNumber": null,
            "reference": "REF6311",
            "asset": "HKD",
            "assetDisplayName": "Hong Kong Dollar",
            "totalBalance": 999883.990000000000000000,
            "availableBalance": 999883.990000000000000000,
            "pendingBalance": -116.010000000000000000,
            "bSuppressed": false,
            "dateAdded": "2024-11-20T05:18:41.4566667+00:00"
        },
        {
            "id": 6312,
            "customersId": 14391,
            "name": "SGD Account",
            "routingNumber": null,
            "accountNumber": "11020048859",
            "swiftCode": "GLDTSGSG",
            "virtualAccountNumber": null,
            "reference": "REF6312",
            "asset": "SGD",
            "assetDisplayName": "Singapore Dollar",
            "totalBalance": 999979.960000000000000000,
            "availableBalance": 999979.960000000000000000,
            "pendingBalance": -20.040000000000000000,
            "bSuppressed": false,
            "dateAdded": "2024-11-20T05:18:41.4566667+00:00"
        },
        {
            "id": 6313,
            "customersId": 14391,
            "name": "USD Account",
            "routingNumber": null,
            "accountNumber": "11020048859",
            "swiftCode": "GLDTSGSG",
            "virtualAccountNumber": null,
            "reference": "REF6313",
            "asset": "USD",
            "assetDisplayName": "United States Dollar",
            "totalBalance": 999985.000000000000000000,
            "availableBalance": 999985.000000000000000000,
            "pendingBalance": -15.000000000000000000,
            "bSuppressed": false,
            "dateAdded": "2024-11-20T05:18:41.4566667+00:00"
        }
    ],
    "pageSize": 25,
    "pageNumber": 1,
    "numberOfPages": 1,
    "status": "1",
    "errors": []
}

---

List Account Transactions

Retrieve a comprehensive list of transactions for a user's asset account, which may include deposits, withdrawals, and other types of transactions. It helps users track their deposits, withdrawals, and other transactions across accounts, providing transparency into their financial movements and the status of each transaction

• Endpoint: /api/v1/customer/accounts/transactions

• Method: GET

Get a list of transactions

Request query:

• AccountsId: Account Id filter
• FromDate: From date filter
• ToDate: To date filter
• PageNumber: list page number (optional, default = 1)
• PageSize: list page size (optional, default = 10)

Response:

• array of
  • Id: Transaction Id
  • AccountsId: Transaction account Id
  • Amount: Transaction amount
  • Description: Transaction description
  • DateTime: Transaction date
  • bPending: Is transaction pending
  • bCancellable: Is transaction cancellable

GET/api/v1/customer/accounts/transactions

Query parameters

Header parameters

Response

200404

OK

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsnullable array of AvamaeTemplate.Core.Types.Dtos.CustomerRole.AccountsModule.TransactionDto (object)

pageSizenullable integer (int32)

pageNumbernullable integer (int32)

numberOfPagesnullable integer (int32)

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/customer/accounts/transactions', {
    method: 'GET',
    headers: {
      "otp": "text"
    },
});
const data = await response.json();

Response

200404

{
  "status": "text",
  "errors": [
    {
      "errorType": "text",
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "id": 0,
  "details": [
    {
      "id": 0,
      "accountsId": 0,
      "fromTransactionsId": 0,
      "fromAccountsId": 0,
      "toTransactionsId": 0,
      "toAccountsId": 0,
      "amount": 0,
      "description": "text",
      "dateTime": "2024-12-21T12:03:20.057Z",
      "bPending": false,
      "bCancellable": false
    }
  ],
  "pageSize": 0,
  "pageNumber": 0,
  "numberOfPages": 0
}

Query Parameters:

• AccountsId (Integer): The ID of the user's asset account for which transactions are to be listed—optional.

• FromDate (ISO 8601 date): The start date to filter transactions—optional.

• ToDate (ISO 8601 date): The end date to filter transactions—optional.

• PageNumber (Integer): The page of results to return, with 1 as the default—optional.

• PageSize (Integer): The number of records per page, with 10 as the default—optional.

Request Example:

To request a list of transactions for a specific account:

GET /api/v1/customer/accounts/transactions?AccountsId=1056&FromDate=2022-07-01&ToDate=2022-07-31

Response Body Parameters:

• id (Integer): Not actively used in the example.

• details (Array of Objects): Each object contains detailed transaction information.

  • id (Integer): The transaction ID.

  • accountsId (Integer): The account ID from which the transaction originated or was directed to.

  • fromTransactionsId (Integer, Nullable): The ID of the source transaction, if applicable.

  • fromAccountsId (Integer, Nullable): The ID of the source account, if applicable.

  • toTransactionsId (Integer, Nullable): The ID of the destination transaction, if applicable.

  • toAccountsId (Integer): The ID of the destination account.

  • amount (Decimal): The amount involved in the transaction.

  • description (String): Description of the transaction.

  • dateTime (ISO 8601 date): The timestamp when the transaction occurred.

  • bPending (Boolean): A flag indicating whether the transaction is pending.

  • bCancellable (Boolean): A flag indicating whether the transaction might be cancelled. For a more accurate and real-time check on whether or not a transaction may be cancelled, users are encouraged to use this endpoint.

Success Response Example:

{
  "id": 1025,
  "details": [
    {
      "id": 1864,
      "accountsId": 1056,
      "fromTransactionsId": null,
      "fromAccountsId": null,
      "toTransactionsId": 1006,
      "toAccountsId": 1001,
      "amount": 100.00,
      "description": "USD deposit",
      "dateTime": "2022-07-08T16:57:12.127+00:00",
      "bPending": false,
      "bCancellable": false
    }
  ],
  "pageSize": 1,
  "pageNumber": 1,
  "numberOfPages": 26,
  "status": "1",
  "errors": []
}

---

Get Transaction Details

Obtain details for a specific transaction within the user's account. This includes all available data points from the amount and type of asset traded to when the transaction took place and its current processing status. It is essential for users to track and reconcile individual transactions against their account records.

• Endpoint: /api/v2/customer/accounts/transactions/get

• Method: GET

Get transaction details for a given transaction

Request query:

• Id: transaction id

Response:

• array of
  • Id: Transaction Id
  • AccountsId: Transaction account Id
  • Amount: Transaction amount
  • Description: Transaction description
  • DateTime: Transaction date
  • bPending: is transaction pending

GET/api/v2/customer/accounts/transactions/get

Query parameters

Header parameters

Response

200404

OK

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Dtos.CustomerRole.AccountsV2Module.TransactionDetailDto (object)

Request

JavaScriptCurlPython

const response = await fetch('/api/v2/customer/accounts/transactions/get', {
    method: 'GET',
    headers: {
      "otp": "text"
    },
});
const data = await response.json();

Response

200404

{
  "status": "text",
  "errors": [
    {
      "errorType": "text",
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "id": 0,
  "details": {
    "transactionId": 0,
    "customerId": 0,
    "assetAccountId": 0,
    "assetClass": "text",
    "asset": "text",
    "amount": 0,
    "description": "text",
    "timestamp": "2024-12-21T12:03:20.057Z",
    "transactionStatus": "text",
    "rollbackTransactionId": 0,
    "originalTransactionId": 0,
    "transactionType": "text",
    "feeTransactionId": 0,
    "feeTransactionAmount": 0,
    "bEligibleForReversal": false,
    "assetExchangeTransferDetails": {
      "assetExchangeId": 0,
      "assetExchangeType": "text",
      "customerId": 0,
      "assetExchangeStatus": "text",
      "fromTransactionsId": 0,
      "toTransactionsId": 0,
      "fromAsset": "text",
      "toAsset": "text",
      "fromAssetClass": "text",
      "toAssetClass": "text",
      "fromAssetRequestedAmount": 0,
      "toAssetRequestedAmount": 0,
      "toAssetExecutedAmount": 0,
      "commissionFee": 0,
      "payeesId": 0,
      "fromCustomerAssetAccountId": 0,
      "toCustomerAssetAccountId": 0
    },
    "achTransferDetails": {
      "paymentType": "text",
      "achTransactionType": "text",
      "direction": "text",
      "accountNumber": "text",
      "originatorRoutingNumber": "text",
      "originatorName": "text",
      "receiverRoutingNumber": "text",
      "receiverName": "text"
    },
    "wireTransferDetails": {
      "wirePaymentType": "text",
      "accountNumber": "text",
      "imad": "text",
      "senderRoutingNumber": "text",
      "senderName": "text",
      "receiverRoutingNumber": "text",
      "receiverName": "text",
      "originatorName": "text",
      "beneficiaryName": "text",
      "completedAt": "2024-12-21T12:03:20.057Z"
    },
    "bookTransferDetails": {
      "debitSubAccountNumber": "text",
      "creditSubAccountNumber": "text",
      "payeeId": 0
    },
    "internalTransferDetails": {
      "complementaryTransactionId": 0,
      "fromCustomerId": 0,
      "fromAssetAccountId": 0,
      "toCustomerId": 0,
      "toAssetAccountId": 0
    },
    "walletTransferDetails": {
      "fromWalletAddress": "text",
      "toWalletAddress": "text"
    },
    "externalTransferDetails": {
      "paymentType": "text",
      "transferType": "text",
      "direction": "text",
      "imad": "text",
      "senderAccountNumber": "text",
      "senderRoutingNumber": "text",
      "senderSwiftCode": "text",
      "senderIban": "text",
      "senderName": "text",
      "originatorName": "text",
      "receiverAccountNumber": "text",
      "receiverRoutingNumber": "text",
      "receiverSwiftCode": "text",
      "receiverIban": "text",
      "receiverName": "text",
      "beneficiaryName": "text",
      "reference": "text",
      "completedAt": "2024-12-21T12:03:20.057Z"
    }
  }
}

Query Parameters:

• Id (Integer): The unique identifier of the account transaction to get details for—required.

Request Example:

GET /api/v1/customer/accounts/transactions/get?Id=1089

Response Body Parameters:

• id (Integer): A reference value not actively used in the response.

• details (Object): An encapsulation of the transaction details.

  • transactionId (Integer): The identifier of the specific transaction.

  • customerId (Integer): The customer ID associated with the transaction.

  • assetAccountId (Integer): The account ID where the asset transaction took place.

  • assetClass (String): The category of the asset, e.g., "Cryptocurrency".

  • asset (String): The specific asset involved in the transaction, e.g., "BTC".

  • amount (Decimal): The quantity of the asset transferred in the transaction.

  • description (String): A narrative describing the transaction.

  • timestamp (ISO 8601 date): The exact moment the transaction was recorded.

  • transactionStatus (String): The current processing status of the transaction, e.g., "Pending".

  • feeTransactionId (Integer, Nullable): The transaction ID for any fees, if applicable.

  • rollbackTransactionId (Integer, Nullable): The transaction ID for a rollback, if that occurred.

  • bEligibleForReversal (Boolean): A flag indicating whether the transaction can be reversed.

  • bookTransferDetails (Object, Nullable): Details if the transaction involved a book transfer.

  • achTransferDetails (Object, Nullable): Details if the transaction was an ACH transfer.

  • wireTransferDetails (Object, Nullable): Details if the transaction was a wire transfer.

  • internalTransferDetails (Object, Nullable): Details if the transaction was an internal transfer.

  • walletTransferDetails (Object, Nullable): Details if the transaction involved a wallet transfer.

  • assetExchangeTransferDetails (Object, Nullable): Details specifically for asset exchange transactions.

    • assetExchangeId (Integer): The ID of the asset exchange, if applicable.

    • assetExchangeType (String): The type of exchange, e.g., "Buy".

    • customerId (Integer): The ID of the customer engaged in the exchange.

    • assetExchangeStatus (String): The status of the asset exchange, e.g., "Pending".

    • fromTransactionsId (Integer, Nullable): The originating transaction ID for the exchange.

    • toTransactionsId (Integer): The receiving transaction ID for the exchange.

    • fromAsset (String): The asset being exchanged from.

    • toAsset (String): The asset being exchanged to.

    • fromAssetClass (String): The asset class for the originating asset.

    • toAssetClass (String): The asset class for the receiving asset.

    • requestAmount (Decimal): The amount requested for the exchange.

    • requestPrice (Decimal): The price requested for the exchange.

    • executedAmount (Decimal, Nullable): The amount actually executed in the exchange.

    • executedPrice (Decimal, Nullable): The price at which the exchange was executed.

    • commissionFee (Decimal): The commission fee for the exchange.

    • payeesId (Integer, Nullable): The payee ID, if another party is involved.

    • fromCustomerAssetAccountId (Integer, Nullable): The customer's originating asset account ID.

    • toCustomerAssetAccountId (Integer): The customer's destination asset account ID for the asset received.

Success Response Example:

{
  "id": 0,
  "details": {
    "transactionId": 1089,
    "customerId": 1061,
    "assetAccountId": 1040,
    "assetClass": "Cryptocurrency",
    "asset": "BTC",
    "amount": 0.001,
    "description": "Bitcoin Purchase",
    "timestamp": "2023-06-09T15:03:40.183",
    "transactionStatus": "Pending",
    "feeTransactionId": null,
    "feeTransactionAmount": null,
    "rollbackTransactionId": null,
    "bookTransferDetails": null,
    "achTransferDetails": null,
    "wireTransferDetails": null,
    "internalTransferDetails": null,
    "walletTransferDetails": null,
    "bEligibleForReversal": false,
    "assetExchangeTransferDetails": {
      "assetExchangeId": 1108,
      "assetExchangeType": "Buy",
      "customerId": 1061,
      "assetExchangeStatus": "Pending",
      "fromTransactionsId": null,
      "toTransactionsId": 1089,
      "fromAsset": "USD",
      "toAsset": "BTC",
      "fromAssetClass": "Currency",
      "toAssetClass": "Cryptocurrency",
      "requestAmount": 0.001,
      "requestPrice": 32.92,
      "executedAmount": null,
      "executedPrice": null,
      "commissionFee": 5.00,
      "payeesId": null,
      "fromCustomerAssetAccountId": null,
      "toCustomerAssetAccountId": 1040
    }
  },
  "status": 1,
  "errors": []
}

---

Withdraw Crypto from Customer Account to External Wallet

Allows a user to withdraw cryptocurrency from a customer account to an external blockchain wallet. Users have the capability to send cryptocurrency from an customer's account to another digital wallet that they specify. To do this, they provide the account ID from which the money will come, how much they want to send, and the address of the digital wallet to receive the funds. Once the request is made, the system processes it and either confirms the transaction has taken place or gives an error if something went wrong during the process.

• Endpoint: /api/v1/customer/accounts/crypto/withdraw

• Method: POST

• Request Body Parameters:

  • accountsId (Integer): The ID of the customer account from which the withdrawal is to be made.

  • amount (Decimal): The amount of cryptocurrency to be withdrawn.

  • destinationAddress (String): The blockchain wallet address to which the funds will be withdrawn.

Withdraw crypto asset from account to external wallet address

Request query:

• accountsId: Account Id filter
• amount: Amount to withdraw (must be >0)
• destinationAddress : on-chain address to withdraw to (max length 100)

Response:

• Id: new transaction Id
• AccountsId: Id of account debited
• Amount: amount to transfer
• Description: description for the transfer
• DateTime: initiation timestamp
• bPending: pending status of the transfer

POSThttp://public-api.ibanera.com/api/v1/customer/accounts/crypto/withdraw

Header parameters

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

accountsIdinteger (int32)

amountnumber (double)

destinationAddress*string

Response

200404

Success

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Dtos.CustomerRole.AccountsModule.WithdrawResponseDto (object)

Request

JavaScriptCurlPython

const response = await fetch('http://public-api.ibanera.com/api/v1/customer/accounts/crypto/withdraw', {
    method: 'POST',
    headers: {
      "otp": "text",
      "Content-Type": "application/json-patch+json"
    },
    body: JSON.stringify({
      "destinationAddress": "text"
    }),
});
const data = await response.json();

Response

200404

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "id": 0,
  "details": {
    "id": 0,
    "accountsId": 0,
    "amount": 0,
    "description": "text",
    "dateTime": "2024-12-21T12:03:20.057Z",
    "bPending": false
  }
}

Request Example:

{
  "accountsId": 1004,
  "amount": 0.005,
  "destinationAddress": "mxcMwdmLsyQGRNhvHSBuxomxhL1"
}

Response Body Parameters:

• id (Integer): A reference ID for the transaction; not used in the example.

• details.id (Integer): The ID of the withdrawal transaction.

• details.accountsId (Integer): The ID of the customer account.

• details.amount (Decimal): The amount withdrawn.

• details.description (String): A description of the transaction.

• details.dateTime (String): Timestamp of when the transaction took place.

• details.bPending (Boolean): Indicates whether the transaction is pending.

Success Response Example:

{
  "id": 1025,
  "details": {
    "id": 1864,
    "accountsId": 1056,
    "amount": 0.0001,
    "description": "BTC withdrawal",
    "dateTime": "2022-07-08T16:57:12.127+00:00",
    "bPending": false
  },
  "status": "1",
  "errors": []
}

Error Codes:

• If the withdrawal request fails due to screening, a BadRequest error with a Transaction_Blocked messageCode can be returned in the response.

• errorType: The type of error encountered during the request processing.

• fieldName: The field that caused the error.

• messageCode: A code that designates the specific error, for example, "Transaction_Blocked."

Error Response Example:

{
  "id": 0,
  "details": null,
  "status": "0",
  "errors": [
    {
      "errorType": "BadRequest",
      "fieldName": "Screening",
      "messageCode": "Transaction_Blocked"
    }
  ]
}

---

Get Deposit Address for a Crypto Asset Account

Enables users to retrieve the deposit address of a cryptocurrency wallet associated with a customer's asset account. By retrieving a deposit address, users can make an external deposit and see the transaction reflected in their account once it's been confirmed.

• Endpoint: /api/v1/customer/accounts/crypto/depositaddress

• Method: POST

• Request Body Parameters:

  • accountsId (Integer): The ID of the customer account to retrieve a deposit address for.

Get Deposit address for a crypto account

Request query:

• AccountsId: Account Id filter Response:
  • address: blockchain wallet address

GEThttp://public-api.ibanera.com/api/v1/customer/accounts/crypto/depositaddress

Query parameters

Header parameters

Response

200404

Success

Body

application/json

statusnullable string

errorsnullable array of AvamaeTemplate.Core.Types.Results.Base.ErrorResultDto (object)

idinteger (int64)

detailsAvamaeTemplate.Core.Types.Dtos.CustomerRole.AccountsModule.DepositAddressResponseDto (object)

Request

JavaScriptCurlPython

const response = await fetch('http://public-api.ibanera.com/api/v1/customer/accounts/crypto/depositaddress', {
    method: 'GET',
    headers: {
      "otp": "text"
    },
});
const data = await response.json();

Response

200404

{
  "status": "text",
  "errors": [
    {
      "fieldName": "text",
      "messageCode": "text"
    }
  ],
  "id": 0,
  "details": {
    "address": "text"
  }
}

---