Get All Transfers

Retrieve all deposits and withdrawals of a particular trading account

Overview

This GET endpoint enables you to retrieve all deposits and withdrawals of a particular trading account.

There are eight required parameters that must be provided in the request:

1. Et-App-Key (header). This is the unique key of your app that identifies your app when communicating with our service. Contact your administrator to get this key.

2. Authorization (header). This is the authorization token from the very first token request.

3. API version (path). Unless necessary, leave it at "1.0".

4. accountId (path). This is the internal identifier of the trading account in Autoshares Trader.

5. pageNumber (query). This is the number of the page (all transfers are split in pages).

6. pageSize (query). This is the preferable size of the page (maximum value is 99).

7. sortField (query). This is a parameter by which all returned transfers must be sorted.

8. desc (query). This boolean parameter indicates if the returned transfers should be sorted in ascending (false) or descending (true) order.

Here's the final template for this API request:

GET apiURL/v1.0/accounts/{accountId}/transfers

Response

In response to this API request, you will receive an array of JSON dictionaries containing detailed information about all transfers on this trading account.

{
  "Result": [
    {
      "Id": "a59448f5-176d-4473-6ce2-08d7bc5cbf81",
      "AccountId": 0,
      "ExternalId": "20200228003627",
      "Mechanism": "ACH",
      "IsDeposit": true,
      "Status": "Complete",
      "Comment": "Deposit allowed",
      "Amount": 100,
      "TotalAmount": 100,
      "TransferDate": "2020-02-28T14:45:57.5867903Z",
      "CreatedAt": "2020-02-28T14:44:43.3666667Z",
      "ClearingAccountNumber": "5DP05506"
    },
    {
      "Id": "99c0509e-04ee-46a4-6ce4-08d7bc5cbf81",
      "AccountId": 0,
      "Mechanism": "ACH",
      "IsDeposit": true,
      "Status": "Submitted",
      "Amount": 50,
      "TotalAmount": 0,
      "CreatedAt": "2020-02-28T16:26:02.7133333Z",
      "ClearingAccountNumber": "5DP05506"
    }
  ],
  "NextPageLink": "",
  "PreviousPageLink": "",
  "TotalCount": 2
}

Common Mistakes

Here are some of the common mistakes that developers make when attempting to send a request to list all transfers.

Failing to Specify the Et-App-Key Parameter

If you specify the wrong Et-App-Key parameter or fail to include it in the header altogether, you'll get the following error:

{
    "error": "Application key is not defined or does not exist"
}