Transfers v0.5.0

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

With the Transfers API, clients can schedule transfer requests to move funds from one account to another. To schedule a new transfer, use the POST operation at /scheduledTransfers path. The GET operation there returns a paginated collection of scheduled transfers. Scheduled transfers which have been processed are automatically removed from /scheduledTransfers. The /pastTransfers collection contains processed (or canceled) transfers. This differs from the Payments API which allows scheduling bill or other payments to external payees.

Download OpenAPI Definition (YAML)

Base URLs:

• /transfers

Terms of service

Email: Apiture Web: Apiture

API

Endpoints which describe this API.

getApi

Code samples

# You can also use wget
curl -X GET /transfers/ \
  -H 'Accept: application/hal+json'

GET /transfers/ HTTP/1.1

Accept: application/hal+json

var headers = {
  'Accept':'application/hal+json'

};

$.ajax({
  url: '/transfers/',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json'

};

fetch('/transfers/',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json'
}

result = RestClient.get '/transfers/',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json'
}

r = requests.get('/transfers/', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Top-level resources and operations in this API

GET /

Return links to the top-level resources and operations in this API.

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "id": "apiName",
  "name": "API name",
  "apiVersion": "0.0.1-SNAPSHOT",
  "_profile": "https://api.apiture.com/schema/apiRoot/v1.0.0/profile.json",
  "_links": {}
}

Responses

getApiDoc

Code samples

# You can also use wget
curl -X GET /transfers/apiDoc \
  -H 'Accept: application/json'

GET /transfers/apiDoc HTTP/1.1

Accept: application/json

var headers = {
  'Accept':'application/json'

};

$.ajax({
  url: '/transfers/apiDoc',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/json'

};

fetch('/transfers/apiDoc',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/json'
}

result = RestClient.get '/transfers/apiDoc',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/json'
}

r = requests.get('/transfers/apiDoc', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/apiDoc");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/apiDoc", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Return API definition document

GET /apiDoc

Return the OpenAPI document that describes this API.

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{}

Responses

Response Schema

Scheduled Transfer

Scheduled transfers from a source account to a target account

getScheduledTransfers

Code samples

# You can also use wget
curl -X GET /transfers/scheduledTransfers \
  -H 'Accept: application/hal+json'

GET /transfers/scheduledTransfers HTTP/1.1

Accept: application/hal+json

var headers = {
  'Accept':'application/hal+json'

};

$.ajax({
  url: '/transfers/scheduledTransfers',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json'

};

fetch('/transfers/scheduledTransfers',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json'
}

result = RestClient.get '/transfers/scheduledTransfers',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json'
}

r = requests.get('/transfers/scheduledTransfers', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/scheduledTransfers");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/scheduledTransfers", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Return a collection of scheduled transfers

GET /scheduledTransfers

Return a paginated sortable filterable searchable collection of transfers. The links in the response include pagination links.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "_profile": "http://api.apiture.com/schemas/transfers/transfers/v1.0.0/profile.json",
  "start": 10,
  "limit": 10,
  "count": 67,
  "name": "transfers",
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers?start=10&limit=10"
    },
    "first": {
      "href": "/transfers/scheduledTransfers?start=0&limit=10"
    },
    "next": {
      "href": "/transfers/scheduledTransfers?start=20&limit=10"
    },
    "collection": {
      "href": "/transfers/scheduledTransfers"
    }
  },
  "_embedded": {
    "items": [
      {
        "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
        "_profile": "http://api.apiture.com/schemas/transfers/summaryScheduledTransfer/v1.0.0/profile.json",
        "amount": {
          "value": "345.50",
          "currency": "USD"
        },
        "description": "Car payment",
        "state": "recurring",
        "schedule": {
          "start": "2018-02-05",
          "count": 3,
          "every": "P1M",
          "end": "2021-04-05"
        },
        "_links": {
          "apiture:source": {
            "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
          },
          "apiture:target": {
            "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
          },
          "apiture:transactions": {
            "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
          },
          "self": {
            "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
          }
        }
      },
      {
        "_id": "a3bbba3c-d26b-497d-87b7-09eb47b24d77",
        "_profile": "http://api.apiture.com/schemas/transfers/summaryScheduledTransfer/v1.0.0/profile.json",
        "amount": {
          "value": "120.0",
          "currency": "USD"
        },
        "description": "Monthly allowance for Suzy's college expenses and meals",
        "state": "recurring",
        "schedule": {
          "start": "2018-08-01",
          "count": 24,
          "every": "P1M",
          "end": "2020-05-15"
        },
        "_links": {
          "apiture:source": {
            "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
          },
          "apiture:target": {
            "href": "/accounts/externalAccounts/4fda6275-0a3b-49ad-ad12-5ebcd7013362"
          },
          "apiture:transactions": {
            "href": "/transaction?transfer=/transfers/transfers/a3bbba3c-d26b-497d-87b7-09eb47b24d77"
          },
          "self": {
            "href": "/transfers/scheduledTransfers/a3bbba3c-d26b-497d-87b7-09eb47b24d77"
          }
        }
      }
    ]
  }
}

Responses

createScheduledTransfer

Code samples

# You can also use wget
curl -X POST /transfers/scheduledTransfers \
  -H 'Content-Type: application/hal+json' \
  -H 'Accept: application/hal+json'

POST /transfers/scheduledTransfers HTTP/1.1

Content-Type: application/hal+json
Accept: application/hal+json

var headers = {
  'Content-Type':'application/hal+json',
  'Accept':'application/hal+json'

};

$.ajax({
  url: '/transfers/scheduledTransfers',
  method: 'post',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');
const inputBody = '{
  "_profile": "http://api.apiture.com/schemas/transfers/createScheduledTransfer/v1.0.0/profile.json",
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "schedule": {
    "start": "2018-02-05",
    "maximumCount": 36,
    "every": "P1M",
    "skipNext": false,
    "end": "2021-04-05"
  },
  "_links": {
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    }
  }
}';
const headers = {
  'Content-Type':'application/hal+json',
  'Accept':'application/hal+json'

};

fetch('/transfers/scheduledTransfers',
{
  method: 'POST',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/hal+json',
  'Accept' => 'application/hal+json'
}

result = RestClient.post '/transfers/scheduledTransfers',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/hal+json',
  'Accept': 'application/hal+json'
}

r = requests.post('/transfers/scheduledTransfers', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/scheduledTransfers");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/hal+json"},
        "Accept": []string{"application/hal+json"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/transfers/scheduledTransfers", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Create a new scheduled transfer request

POST /scheduledTransfers

This operation adds either a new one-time or a recurring transfer, depending on the content of the embedded schedule. The request includes the amount of the transfer in the body, and the source and target accounts in the request's _links via the link relations apiture:source and apiture:target. The accounts must be active and available for transfers and the amount must be in the allowed transfer range.

If the request's transfer date (schedule.start) is the current day, the financial institution is processing transfers on that day, and the time is before the financial institution's transfer processing cutoff time, internal transfers will be processed as soon as possible and the transfer state will change to processing and then completed. If the request's transfer date (schedule.start) is the current day and the time is past the cutoff time, the transfer will be processed on the next processing day. The cutoff time is available as cutoffTime via this service's basic configuration values GET /transfers/configuration/groups/basic/values; those values are defined by the JSON schema GET /transfers/configuration/groups/basic/schema.

If the transfer is scheduled for a future date that is not a valid transfer processing day, the request fails with a 400 error. The holidays and other non-processing days are available via this service's calendar configuration values GET /transfers/configuration/groups/calendar/values; those values are defined by the JSON schema GET /transfers/configuration/groups/calendar/schema.

The service will reject duplicate requests, defined by a request that exactly matches an existing transfer (same amount, schedule, description, source and target accounts), returning a 409 Conflict status. To schedule a duplicate transfer with the same amount, schedule, and accounts, change at least the description.

Scheduled transfers will be deleted automatically at some point after they have completed (typically 7 days), up until which they are available with a state of completed if successful or failed if not.

Body parameter

{
  "_profile": "http://api.apiture.com/schemas/transfers/createScheduledTransfer/v1.0.0/profile.json",
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "schedule": {
    "start": "2018-02-05",
    "maximumCount": 36,
    "every": "P1M",
    "skipNext": false,
    "end": "2021-04-05"
  },
  "_links": {
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    }
  }
}

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

201 Response

{
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "_profile": "http://api.apiture.com/schemas/transfers/scheduledTransfer/v1.0.0/profile.json",
  "createdBy": "lucille-4700",
  "createdAt": "2018-05-08T13:37:57.375Z",
  "modifiedBy": "lucille-4700",
  "modifiedAt": "2018-05-18T16:42:57.000Z",
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    },
    "apiture:creator": {
      "href": "/users/users/d076e102-facf-46e2-8ecf-bcdb531cd9e6"
    },
    "apiture:transactions": {
      "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    }
  },
  "_embedded": {
    "transactions": {
      "start": 0,
      "count": 3,
      "items": [
        {
          "_id": "da8682e3-cc0b-4a1a-b8d2-8ce4dc45bf36",
          "occurredAt": "2018-02-05T11:10:00.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "a847c5c7-4a34-4464-b514-5ca1680cc00d",
          "occurredAt": "2018-03-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "d9ab0002-2cbb-4a4c-a01f-c3ce3ad20782",
          "occurredAt": "2018-04-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        }
      ]
    },
    "source": {
      "_id": "34f8bec8-3939-4b7e-9ad5-10ee059ab250",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "Personal Savings",
      "productName": "Basic Personal Savings",
      "type": "Personal Savings",
      "subtype": "Basic Personal Savings",
      "state": "active",
      "balance": {
        "value": "3450.30",
        "available": "3450.30",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/34f8bec8-3939-4b7e-9ad5-10ee059ab250"
        }
      }
    },
    "target": {
      "_id": "c9839d60-73e5-47ba-9676-ca8138e9494d",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "My Basic Checking",
      "productName": "Basic Personal Checking",
      "type": "Personal Checking",
      "subtype": "Basic Personal Checking",
      "state": "active",
      "balance": {
        "value": "450.12",
        "available": "450.12",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/c9839d60-73e5-47ba-9676-ca8138e9494d"
        }
      }
    },
    "_links": {
      "self": {
        "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
      }
    }
  },
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "state": "recurring",
  "schedule": {
    "start": "2018-02-05",
    "count": 3,
    "every": "P1M",
    "end": "2021-04-05"
  }
}

Responses

Response Headers

getScheduledTransfer

Code samples

# You can also use wget
curl -X GET /transfers/scheduledTransfers/{scheduledTransferId} \
  -H 'Accept: application/hal+json' \
  -H 'If-None-Match: string'

GET /transfers/scheduledTransfers/{scheduledTransferId} HTTP/1.1

Accept: application/hal+json
If-None-Match: string

var headers = {
  'Accept':'application/hal+json',
  'If-None-Match':'string'

};

$.ajax({
  url: '/transfers/scheduledTransfers/{scheduledTransferId}',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json',
  'If-None-Match':'string'

};

fetch('/transfers/scheduledTransfers/{scheduledTransferId}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json',
  'If-None-Match' => 'string'
}

result = RestClient.get '/transfers/scheduledTransfers/{scheduledTransferId}',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json',
  'If-None-Match': 'string'
}

r = requests.get('/transfers/scheduledTransfers/{scheduledTransferId}', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/scheduledTransfers/{scheduledTransferId}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        "If-None-Match": []string{"string"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/scheduledTransfers/{scheduledTransferId}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Fetch a representation of this transfer

GET /scheduledTransfers/{scheduledTransferId}

Return a HAL representation of this transfer resource. To also receive the full account number when fetching an account, include the ?unmasked=true option. When linking an external account, the full account number should be in the accountNumbers.full property in the request.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "_profile": "http://api.apiture.com/schemas/transfers/scheduledTransfer/v1.0.0/profile.json",
  "createdBy": "lucille-4700",
  "createdAt": "2018-05-08T13:37:57.375Z",
  "modifiedBy": "lucille-4700",
  "modifiedAt": "2018-05-18T16:42:57.000Z",
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    },
    "apiture:creator": {
      "href": "/users/users/d076e102-facf-46e2-8ecf-bcdb531cd9e6"
    },
    "apiture:transactions": {
      "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    }
  },
  "_embedded": {
    "transactions": {
      "start": 0,
      "count": 3,
      "items": [
        {
          "_id": "da8682e3-cc0b-4a1a-b8d2-8ce4dc45bf36",
          "occurredAt": "2018-02-05T11:10:00.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "a847c5c7-4a34-4464-b514-5ca1680cc00d",
          "occurredAt": "2018-03-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "d9ab0002-2cbb-4a4c-a01f-c3ce3ad20782",
          "occurredAt": "2018-04-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        }
      ]
    },
    "source": {
      "_id": "34f8bec8-3939-4b7e-9ad5-10ee059ab250",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "Personal Savings",
      "productName": "Basic Personal Savings",
      "type": "Personal Savings",
      "subtype": "Basic Personal Savings",
      "state": "active",
      "balance": {
        "value": "3450.30",
        "available": "3450.30",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/34f8bec8-3939-4b7e-9ad5-10ee059ab250"
        }
      }
    },
    "target": {
      "_id": "c9839d60-73e5-47ba-9676-ca8138e9494d",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "My Basic Checking",
      "productName": "Basic Personal Checking",
      "type": "Personal Checking",
      "subtype": "Basic Personal Checking",
      "state": "active",
      "balance": {
        "value": "450.12",
        "available": "450.12",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/c9839d60-73e5-47ba-9676-ca8138e9494d"
        }
      }
    },
    "_links": {
      "self": {
        "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
      }
    }
  },
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "state": "recurring",
  "schedule": {
    "start": "2018-02-05",
    "count": 3,
    "every": "P1M",
    "end": "2021-04-05"
  }
}

Responses

Response Headers

deleteScheduledTransfer

Code samples

# You can also use wget
curl -X DELETE /transfers/scheduledTransfers/{scheduledTransferId} \
  -H 'Accept: application/hal+json'

DELETE /transfers/scheduledTransfers/{scheduledTransferId} HTTP/1.1

Accept: application/hal+json

var headers = {
  'Accept':'application/hal+json'

};

$.ajax({
  url: '/transfers/scheduledTransfers/{scheduledTransferId}',
  method: 'delete',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json'

};

fetch('/transfers/scheduledTransfers/{scheduledTransferId}',
{
  method: 'DELETE',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json'
}

result = RestClient.delete '/transfers/scheduledTransfers/{scheduledTransferId}',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json'
}

r = requests.delete('/transfers/scheduledTransfers/{scheduledTransferId}', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/scheduledTransfers/{scheduledTransferId}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("DELETE");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("DELETE", "/transfers/scheduledTransfers/{scheduledTransferId}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Delete this scheduled transfer

DELETE /scheduledTransfers/{scheduledTransferId}

Delete this transfer. Any processing transfers may complete; future scheduled transfers, if this is a recurring transfer, will be canceled. After deleting a transfer, there is no direct access to the transactions or transaction errors.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

404 Response

{
  "_id": "2eae46e1-575c-4d69-8a8f-0a7b0115a4b3",
  "_profile": "https://api.apiture.com/schema/error/v1.0.0/profile.json",
  "message": "The value for deposit must be greater than 0.",
  "statusCode": 422,
  "type": "positiveNumberRequired",
  "attributes": {
    "value": -125.5
  },
  "remediation": "Provide a value which is greater than 0",
  "occurredAt": "2018-01-25T05:50:52.375Z",
  "_links": {
    "describedby": {
      "href": "http://doc.apiture.com/errors/positiveNumberRequired"
    }
  },
  "_embedded": {
    "errors": []
  }
}

Responses

patchScheduledTransfer

Code samples

# You can also use wget
curl -X PATCH /transfers/scheduledTransfers/{scheduledTransferId} \
  -H 'Content-Type: application/hal+json' \
  -H 'Accept: application/hal+json' \
  -H 'If-Match: string'

PATCH /transfers/scheduledTransfers/{scheduledTransferId} HTTP/1.1

Content-Type: application/hal+json
Accept: application/hal+json
If-Match: string

var headers = {
  'Content-Type':'application/hal+json',
  'Accept':'application/hal+json',
  'If-Match':'string'

};

$.ajax({
  url: '/transfers/scheduledTransfers/{scheduledTransferId}',
  method: 'patch',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');
const inputBody = '{
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "_profile": "http://api.apiture.com/schemas/transfers/scheduledTransfer/v1.0.0/profile.json",
  "state": "recurring",
  "amount": {
    "value": "356.40",
    "currency": "USD"
  },
  "description": "Car payment",
  "schedule": {
    "start": "2018-02-05",
    "maximumCount": 36,
    "skippedCount": 1,
    "count": 11,
    "skipNext": true,
    "every": "P1M",
    "end": "2021-04-05"
  },
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    }
  }
}';
const headers = {
  'Content-Type':'application/hal+json',
  'Accept':'application/hal+json',
  'If-Match':'string'

};

fetch('/transfers/scheduledTransfers/{scheduledTransferId}',
{
  method: 'PATCH',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/hal+json',
  'Accept' => 'application/hal+json',
  'If-Match' => 'string'
}

result = RestClient.patch '/transfers/scheduledTransfers/{scheduledTransferId}',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/hal+json',
  'Accept': 'application/hal+json',
  'If-Match': 'string'
}

r = requests.patch('/transfers/scheduledTransfers/{scheduledTransferId}', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/scheduledTransfers/{scheduledTransferId}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PATCH");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/hal+json"},
        "Accept": []string{"application/hal+json"},
        "If-Match": []string{"string"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PATCH", "/transfers/scheduledTransfers/{scheduledTransferId}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Update this scheduled transfer

PATCH /scheduledTransfers/{scheduledTransferId}

Perform a partial update of this transfer. Fields which are omitted are not updated. Nested _embedded and _links are ignored if included. If the state of the transfer allow, this operation may change the description, amount, and schedule; the source and target accounts and _embedded objects may not be changed. In the schedule, the user may not changed the count. The user may not change the state.

Future operations will include suspending, resuming, or canceling a recurring transfer.

This update operation is subject to the same constraints defined in the createTransfer (POST /transfers/transfers) operation.

Body parameter

{
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "_profile": "http://api.apiture.com/schemas/transfers/scheduledTransfer/v1.0.0/profile.json",
  "state": "recurring",
  "amount": {
    "value": "356.40",
    "currency": "USD"
  },
  "description": "Car payment",
  "schedule": {
    "start": "2018-02-05",
    "maximumCount": 36,
    "skippedCount": 1,
    "count": 11,
    "skipNext": true,
    "every": "P1M",
    "end": "2021-04-05"
  },
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    }
  }
}

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "_profile": "http://api.apiture.com/schemas/transfers/scheduledTransfer/v1.0.0/profile.json",
  "createdBy": "lucille-4700",
  "createdAt": "2018-05-08T13:37:57.375Z",
  "modifiedBy": "lucille-4700",
  "modifiedAt": "2018-05-18T16:42:57.000Z",
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    },
    "apiture:creator": {
      "href": "/users/users/d076e102-facf-46e2-8ecf-bcdb531cd9e6"
    },
    "apiture:transactions": {
      "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    }
  },
  "_embedded": {
    "transactions": {
      "start": 0,
      "count": 3,
      "items": [
        {
          "_id": "da8682e3-cc0b-4a1a-b8d2-8ce4dc45bf36",
          "occurredAt": "2018-02-05T11:10:00.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "a847c5c7-4a34-4464-b514-5ca1680cc00d",
          "occurredAt": "2018-03-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "d9ab0002-2cbb-4a4c-a01f-c3ce3ad20782",
          "occurredAt": "2018-04-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        }
      ]
    },
    "source": {
      "_id": "34f8bec8-3939-4b7e-9ad5-10ee059ab250",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "Personal Savings",
      "productName": "Basic Personal Savings",
      "type": "Personal Savings",
      "subtype": "Basic Personal Savings",
      "state": "active",
      "balance": {
        "value": "3450.30",
        "available": "3450.30",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/34f8bec8-3939-4b7e-9ad5-10ee059ab250"
        }
      }
    },
    "target": {
      "_id": "c9839d60-73e5-47ba-9676-ca8138e9494d",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "My Basic Checking",
      "productName": "Basic Personal Checking",
      "type": "Personal Checking",
      "subtype": "Basic Personal Checking",
      "state": "active",
      "balance": {
        "value": "450.12",
        "available": "450.12",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/c9839d60-73e5-47ba-9676-ca8138e9494d"
        }
      }
    },
    "_links": {
      "self": {
        "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
      }
    }
  },
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "state": "recurring",
  "schedule": {
    "start": "2018-02-05",
    "count": 3,
    "every": "P1M",
    "end": "2021-04-05"
  }
}

Responses

Response Headers

suspendScheduledTransfer

Code samples

# You can also use wget
curl -X POST /transfers/suspendedScheduledTransfers?scheduledTransfer=string \
  -H 'Accept: application/hal+json' \
  -H 'If-Match: string'

POST /transfers/suspendedScheduledTransfers?scheduledTransfer=string HTTP/1.1

Accept: application/hal+json
If-Match: string

var headers = {
  'Accept':'application/hal+json',
  'If-Match':'string'

};

$.ajax({
  url: '/transfers/suspendedScheduledTransfers',
  method: 'post',
  data: '?scheduledTransfer=string',
  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json',
  'If-Match':'string'

};

fetch('/transfers/suspendedScheduledTransfers?scheduledTransfer=string',
{
  method: 'POST',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json',
  'If-Match' => 'string'
}

result = RestClient.post '/transfers/suspendedScheduledTransfers',
  params: {
  'scheduledTransfer' => 'string'
}, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json',
  'If-Match': 'string'
}

r = requests.post('/transfers/suspendedScheduledTransfers', params={
  'scheduledTransfer': 'string'
}, headers = headers)

print r.json()

URL obj = new URL("/transfers/suspendedScheduledTransfers?scheduledTransfer=string");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        "If-Match": []string{"string"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/transfers/suspendedScheduledTransfers", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Suspend a scheduled transfer

POST /suspendedScheduledTransfers

POST the URI of a scheduled transfer to suspend it. This disables future recurring transfers until the scheduled transfer is either resumed or canceled. Any transfers that would have occurred on dates that passed while suspended will not be processed on those dates. Use the apiture:resume or apiture:cancel links on the instance to resume or cancel the remaining transfers. This operation is only valid on scheduled transfers which are in the scheduled or recurring states.

This operation is invoked by submitting a POST to the href in the scheduled transfer's apiture:suspend link, The link will be present if the transfer can be suspended.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "_profile": "http://api.apiture.com/schemas/transfers/scheduledTransfer/v1.0.0/profile.json",
  "createdBy": "lucille-4700",
  "createdAt": "2018-05-08T13:37:57.375Z",
  "modifiedBy": "lucille-4700",
  "modifiedAt": "2018-05-18T16:42:57.000Z",
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    },
    "apiture:creator": {
      "href": "/users/users/d076e102-facf-46e2-8ecf-bcdb531cd9e6"
    },
    "apiture:transactions": {
      "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    }
  },
  "_embedded": {
    "transactions": {
      "start": 0,
      "count": 3,
      "items": [
        {
          "_id": "da8682e3-cc0b-4a1a-b8d2-8ce4dc45bf36",
          "occurredAt": "2018-02-05T11:10:00.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "a847c5c7-4a34-4464-b514-5ca1680cc00d",
          "occurredAt": "2018-03-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "d9ab0002-2cbb-4a4c-a01f-c3ce3ad20782",
          "occurredAt": "2018-04-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        }
      ]
    },
    "source": {
      "_id": "34f8bec8-3939-4b7e-9ad5-10ee059ab250",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "Personal Savings",
      "productName": "Basic Personal Savings",
      "type": "Personal Savings",
      "subtype": "Basic Personal Savings",
      "state": "active",
      "balance": {
        "value": "3450.30",
        "available": "3450.30",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/34f8bec8-3939-4b7e-9ad5-10ee059ab250"
        }
      }
    },
    "target": {
      "_id": "c9839d60-73e5-47ba-9676-ca8138e9494d",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "My Basic Checking",
      "productName": "Basic Personal Checking",
      "type": "Personal Checking",
      "subtype": "Basic Personal Checking",
      "state": "active",
      "balance": {
        "value": "450.12",
        "available": "450.12",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/c9839d60-73e5-47ba-9676-ca8138e9494d"
        }
      }
    },
    "_links": {
      "self": {
        "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
      }
    }
  },
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "state": "recurring",
  "schedule": {
    "start": "2018-02-05",
    "count": 3,
    "every": "P1M",
    "end": "2021-04-05"
  }
}

Responses

Response Headers

resumeScheduledTransfer

Code samples

# You can also use wget
curl -X POST /transfers/resumedScheduledTransfers?scheduledTransfer=string \
  -H 'Accept: application/hal+json' \
  -H 'If-Match: string'

POST /transfers/resumedScheduledTransfers?scheduledTransfer=string HTTP/1.1

Accept: application/hal+json
If-Match: string

var headers = {
  'Accept':'application/hal+json',
  'If-Match':'string'

};

$.ajax({
  url: '/transfers/resumedScheduledTransfers',
  method: 'post',
  data: '?scheduledTransfer=string',
  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json',
  'If-Match':'string'

};

fetch('/transfers/resumedScheduledTransfers?scheduledTransfer=string',
{
  method: 'POST',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json',
  'If-Match' => 'string'
}

result = RestClient.post '/transfers/resumedScheduledTransfers',
  params: {
  'scheduledTransfer' => 'string'
}, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json',
  'If-Match': 'string'
}

r = requests.post('/transfers/resumedScheduledTransfers', params={
  'scheduledTransfer': 'string'
}, headers = headers)

print r.json()

URL obj = new URL("/transfers/resumedScheduledTransfers?scheduledTransfer=string");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        "If-Match": []string{"string"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/transfers/resumedScheduledTransfers", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Resume a suspended scheduled transfer

POST /resumedScheduledTransfers

POST the URI of a suspended scheduled transfer to resume it. This enables future recurring transfers. Any transfers that would have occurred on dates that passed while suspended will not be processed on those dates. See also the extendSchedule query parameter on this operation. This operation is only valid on scheduled transfers which are in the suspended state.

This operation is invoked by submitting a POST to the href in the scheduled transfer's apiture:resume link, The link will be present if the transfer can be resumed.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "_profile": "http://api.apiture.com/schemas/transfers/scheduledTransfer/v1.0.0/profile.json",
  "createdBy": "lucille-4700",
  "createdAt": "2018-05-08T13:37:57.375Z",
  "modifiedBy": "lucille-4700",
  "modifiedAt": "2018-05-18T16:42:57.000Z",
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    },
    "apiture:creator": {
      "href": "/users/users/d076e102-facf-46e2-8ecf-bcdb531cd9e6"
    },
    "apiture:transactions": {
      "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    }
  },
  "_embedded": {
    "transactions": {
      "start": 0,
      "count": 3,
      "items": [
        {
          "_id": "da8682e3-cc0b-4a1a-b8d2-8ce4dc45bf36",
          "occurredAt": "2018-02-05T11:10:00.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "a847c5c7-4a34-4464-b514-5ca1680cc00d",
          "occurredAt": "2018-03-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "d9ab0002-2cbb-4a4c-a01f-c3ce3ad20782",
          "occurredAt": "2018-04-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        }
      ]
    },
    "source": {
      "_id": "34f8bec8-3939-4b7e-9ad5-10ee059ab250",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "Personal Savings",
      "productName": "Basic Personal Savings",
      "type": "Personal Savings",
      "subtype": "Basic Personal Savings",
      "state": "active",
      "balance": {
        "value": "3450.30",
        "available": "3450.30",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/34f8bec8-3939-4b7e-9ad5-10ee059ab250"
        }
      }
    },
    "target": {
      "_id": "c9839d60-73e5-47ba-9676-ca8138e9494d",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "My Basic Checking",
      "productName": "Basic Personal Checking",
      "type": "Personal Checking",
      "subtype": "Basic Personal Checking",
      "state": "active",
      "balance": {
        "value": "450.12",
        "available": "450.12",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/c9839d60-73e5-47ba-9676-ca8138e9494d"
        }
      }
    },
    "_links": {
      "self": {
        "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
      }
    }
  },
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "state": "recurring",
  "schedule": {
    "start": "2018-02-05",
    "count": 3,
    "every": "P1M",
    "end": "2021-04-05"
  }
}

Responses

Response Headers

cancelScheduledTransfer

Code samples

# You can also use wget
curl -X POST /transfers/canceledScheduledTransfers?scheduledTransfer=string \
  -H 'Accept: application/hal+json' \
  -H 'If-Match: string'

POST /transfers/canceledScheduledTransfers?scheduledTransfer=string HTTP/1.1

Accept: application/hal+json
If-Match: string

var headers = {
  'Accept':'application/hal+json',
  'If-Match':'string'

};

$.ajax({
  url: '/transfers/canceledScheduledTransfers',
  method: 'post',
  data: '?scheduledTransfer=string',
  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json',
  'If-Match':'string'

};

fetch('/transfers/canceledScheduledTransfers?scheduledTransfer=string',
{
  method: 'POST',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json',
  'If-Match' => 'string'
}

result = RestClient.post '/transfers/canceledScheduledTransfers',
  params: {
  'scheduledTransfer' => 'string'
}, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json',
  'If-Match': 'string'
}

r = requests.post('/transfers/canceledScheduledTransfers', params={
  'scheduledTransfer': 'string'
}, headers = headers)

print r.json()

URL obj = new URL("/transfers/canceledScheduledTransfers?scheduledTransfer=string");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("POST");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        "If-Match": []string{"string"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "/transfers/canceledScheduledTransfers", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Cancel a scheduled transfer

POST /canceledScheduledTransfers

POST the URI of a scheduled transfer to cancel it. This cancels all future recurring transfers. Any transfers that would have occurred on future dates will be canceled. This operation is only valid on scheduled transfers which are in the scheduled, recurring, or suspended state.

This operation is invoked by submitting a POST to the href in the scheduled transfer's apiture:cancel link, The link will be present if the transfer can be canceled.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "_profile": "http://api.apiture.com/schemas/transfers/scheduledTransfer/v1.0.0/profile.json",
  "createdBy": "lucille-4700",
  "createdAt": "2018-05-08T13:37:57.375Z",
  "modifiedBy": "lucille-4700",
  "modifiedAt": "2018-05-18T16:42:57.000Z",
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    },
    "apiture:creator": {
      "href": "/users/users/d076e102-facf-46e2-8ecf-bcdb531cd9e6"
    },
    "apiture:transactions": {
      "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    }
  },
  "_embedded": {
    "transactions": {
      "start": 0,
      "count": 3,
      "items": [
        {
          "_id": "da8682e3-cc0b-4a1a-b8d2-8ce4dc45bf36",
          "occurredAt": "2018-02-05T11:10:00.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "a847c5c7-4a34-4464-b514-5ca1680cc00d",
          "occurredAt": "2018-03-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        },
        {
          "_id": "d9ab0002-2cbb-4a4c-a01f-c3ce3ad20782",
          "occurredAt": "2018-04-05T11:11:17.375Z",
          "amount": {
            "value": "345.50",
            "currency": "USD",
            "description": "Car payment"
          }
        }
      ]
    },
    "source": {
      "_id": "34f8bec8-3939-4b7e-9ad5-10ee059ab250",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "Personal Savings",
      "productName": "Basic Personal Savings",
      "type": "Personal Savings",
      "subtype": "Basic Personal Savings",
      "state": "active",
      "balance": {
        "value": "3450.30",
        "available": "3450.30",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/34f8bec8-3939-4b7e-9ad5-10ee059ab250"
        }
      }
    },
    "target": {
      "_id": "c9839d60-73e5-47ba-9676-ca8138e9494d",
      "_profile": "http://api.apiture.com/schemas/accounts/summaryAccount/v1.0.0/profile.json",
      "name": "My Basic Checking",
      "productName": "Basic Personal Checking",
      "type": "Personal Checking",
      "subtype": "Basic Personal Checking",
      "state": "active",
      "balance": {
        "value": "450.12",
        "available": "450.12",
        "currency": "USD"
      },
      "_links": {
        "self": {
          "href": "http://api.apiture.com/accounts/c9839d60-73e5-47ba-9676-ca8138e9494d"
        }
      }
    },
    "_links": {
      "self": {
        "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
      }
    }
  },
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "state": "recurring",
  "schedule": {
    "start": "2018-02-05",
    "count": 3,
    "every": "P1M",
    "end": "2021-04-05"
  }
}

Responses

Response Headers

Past Transfer

Processed transfers

getPastTransfers

Code samples

# You can also use wget
curl -X GET /transfers/pastTransfers \
  -H 'Accept: application/hal+json'

GET /transfers/pastTransfers HTTP/1.1

Accept: application/hal+json

var headers = {
  'Accept':'application/hal+json'

};

$.ajax({
  url: '/transfers/pastTransfers',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json'

};

fetch('/transfers/pastTransfers',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json'
}

result = RestClient.get '/transfers/pastTransfers',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json'
}

r = requests.get('/transfers/pastTransfers', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/pastTransfers");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/pastTransfers", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Return a collection of past transfers

GET /pastTransfers

Return a paginated sortable filterable searchable collection of past transfers. The links in the response include pagination links.

Past transfers are transfers which have been processed or canceled.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "_profile": "http://api.apiture.com/schemas/transfers/pastTransfers/v1.0.0/profile.json",
  "start": 10,
  "limit": 10,
  "count": 67,
  "name": "transfers",
  "_links": {
    "self": {
      "href": "/transfers/pastTransfers?start=10&limit=10"
    },
    "first": {
      "href": "/transfers/pastTransfers?start=0&limit=10"
    },
    "next": {
      "href": "/transfers/pastTransfers?start=20&limit=10"
    },
    "collection": {
      "href": "/transfers/pastTransfers"
    }
  },
  "_embedded": {
    "items": [
      {
        "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
        "_profile": "http://api.apiture.com/schemas/transfers/summaryPastTransfer/v1.0.0/profile.json",
        "amount": {
          "value": "345.50",
          "currency": "USD"
        },
        "description": "Car payment",
        "state": "recurring",
        "schedule": {
          "start": "2018-02-05",
          "count": 3,
          "every": "P1M",
          "end": "2021-04-05"
        },
        "_links": {
          "apiture:source": {
            "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
          },
          "apiture:target": {
            "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
          },
          "apiture:transactions": {
            "href": "/transaction?transfer=/transfers/transfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
          },
          "self": {
            "href": "/transfers/pastTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
          }
        }
      },
      {
        "_id": "a3bbba3c-d26b-497d-87b7-09eb47b24d77",
        "_profile": "http://api.apiture.com/schemas/transfers/summaryPastTransfer/v1.0.0/profile.json",
        "amount": {
          "value": "120.0",
          "currency": "USD"
        },
        "description": "Monthly allowance for Suzy's college expenses and meals",
        "state": "recurring",
        "schedule": {
          "start": "2018-08-01",
          "count": 24,
          "every": "P1M",
          "end": "2020-05-15"
        },
        "_links": {
          "apiture:source": {
            "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
          },
          "apiture:target": {
            "href": "/accounts/externalAccounts/4fda6275-0a3b-49ad-ad12-5ebcd7013362"
          },
          "apiture:transactions": {
            "href": "/transaction?transfer=/transfers/transfers/a3bbba3c-d26b-497d-87b7-09eb47b24d77"
          },
          "self": {
            "href": "/transfers/pastTransfers/a3bbba3c-d26b-497d-87b7-09eb47b24d77"
          }
        }
      }
    ]
  }
}

Responses

getPastTransfer

Code samples

# You can also use wget
curl -X GET /transfers/pastTransfers/{pastTransferId} \
  -H 'Accept: application/hal+json' \
  -H 'If-None-Match: string'

GET /transfers/pastTransfers/{pastTransferId} HTTP/1.1

Accept: application/hal+json
If-None-Match: string

var headers = {
  'Accept':'application/hal+json',
  'If-None-Match':'string'

};

$.ajax({
  url: '/transfers/pastTransfers/{pastTransferId}',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json',
  'If-None-Match':'string'

};

fetch('/transfers/pastTransfers/{pastTransferId}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json',
  'If-None-Match' => 'string'
}

result = RestClient.get '/transfers/pastTransfers/{pastTransferId}',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json',
  'If-None-Match': 'string'
}

r = requests.get('/transfers/pastTransfers/{pastTransferId}', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/pastTransfers/{pastTransferId}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        "If-None-Match": []string{"string"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/pastTransfers/{pastTransferId}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Fetch a representation of this past transfer

GET /pastTransfers/{pastTransferId}

Return a HAL representation of this transfer resource.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "_profile": "http://api.apiture.com/schemas/transfers/summaryScheduledTransfer/v1.0.0/profile.json",
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    }
  },
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "state": "recurring",
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "schedule": {
    "start": "2018-02-05",
    "maximumCount": 36,
    "skippedCount": 1,
    "count": 11,
    "skipNext": false,
    "every": "P1M",
    "end": "2021-04-05"
  },
  "createdBy": "lucille-4700",
  "createdAt": "2018-05-08T13:37:57.375Z",
  "modifiedBy": "lucille-4700",
  "modifiedAt": "2018-05-18T16:42:57.000Z",
  "sourceAccount": {
    "accountTitle": "John Smith",
    "institutionName": "3rd Party Bank",
    "routingNumber": "021000021",
    "accountNumbers": {
      "masked": "*************3210",
      "full": "9876543210"
    }
  },
  "targetAccount": {
    "accountTitle": "John Smith",
    "institutionName": "3rd Party Bank",
    "routingNumber": "021000021",
    "accountNumbers": {
      "masked": "*************3210",
      "full": "9876543210"
    }
  },
  "confirmationId": "6e5413df-9574-4568-b0c4-dfd96bbb454b",
  "completedAt": "2018-05-08T14:08:50.375Z"
}

Responses

Response Headers

Configuration

A set of endpoints that allows for the creation and retrieval of configuration options specific to this service

getConfiguration

Code samples

# You can also use wget
curl -X GET /transfers/configuration \
  -H 'Accept: application/hal+json'

GET /transfers/configuration HTTP/1.1

Accept: application/hal+json

var headers = {
  'Accept':'application/hal+json'

};

$.ajax({
  url: '/transfers/configuration',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json'

};

fetch('/transfers/configuration',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json'
}

result = RestClient.get '/transfers/configuration',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json'
}

r = requests.get('/transfers/configuration', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/configuration");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/configuration", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Configuration definition for this API

GET /configuration

Returns the configuration for this API

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "_links": {
    "self": {
      "href": "/transfers/configuration/"
    },
    "apiture:groups": {
      "href": "/transfers/configuration/groups"
    }
  }
}

Responses

getConfigurationGroups

Code samples

# You can also use wget
curl -X GET /transfers/configuration/groups \
  -H 'Accept: application/hal+json'

GET /transfers/configuration/groups HTTP/1.1

Accept: application/hal+json

var headers = {
  'Accept':'application/hal+json'

};

$.ajax({
  url: '/transfers/configuration/groups',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json'

};

fetch('/transfers/configuration/groups',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json'
}

result = RestClient.get '/transfers/configuration/groups',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json'
}

r = requests.get('/transfers/configuration/groups', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/configuration/groups");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/configuration/groups", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Return a collection of configuration groups

GET /configuration/groups

Return a paginated sortable filterable searchable collection of configuration groups. The links in the response include pagination links.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "_profile": "http://api.apiture.com/schemas/transfers/configurationGroups/v1.0.0/profile.json",
  "start": 10,
  "limit": 10,
  "count": 67,
  "name": "configurationGroups",
  "_links": {
    "self": {
      "href": "/transfers/configuration/groups?start=10&limit=10"
    },
    "first": {
      "href": "/transfers/configuration/groups?start=0&limit=10"
    },
    "next": {
      "href": "/transfers/configuration/groups?start=20&limit=10"
    },
    "collection": {
      "href": "/transfers/configuration/groups"
    }
  },
  "_embedded": {
    "items": [
      {
        "_profile": "http://api.apiture.com/schemas/transfers/configurationGroup/v1.0.0/profile.json",
        "_links": {
          "self": {
            "href": "/configuration/groups/basic"
          },
          "apiture:configuration": {
            "href": "/configuration"
          }
        },
        "name": "basic",
        "label": "Basic Settings",
        "description": "The basic settings for the Transfers API"
      },
      {
        "_profile": "http://api.apiture.com/schemas/transfers/configurationGroup/v1.0.0/profile.json",
        "_links": {
          "self": {
            "href": "/configuration/groups/calendar"
          },
          "apiture:configuration": {
            "href": "/configuration"
          }
        },
        "name": "calendar",
        "label": "Calendar",
        "description": "A calendar that specifies which dates are valid for performing transfers (e.g., weekdays excluding federal holidays)"
      }
    ]
  }
}

Responses

getConfigurationGroup

Code samples

# You can also use wget
curl -X GET /transfers/configuration/groups/{groupName} \
  -H 'Accept: application/hal+json' \
  -H 'If-None-Match: string'

GET /transfers/configuration/groups/{groupName} HTTP/1.1

Accept: application/hal+json
If-None-Match: string

var headers = {
  'Accept':'application/hal+json',
  'If-None-Match':'string'

};

$.ajax({
  url: '/transfers/configuration/groups/{groupName}',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json',
  'If-None-Match':'string'

};

fetch('/transfers/configuration/groups/{groupName}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json',
  'If-None-Match' => 'string'
}

result = RestClient.get '/transfers/configuration/groups/{groupName}',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json',
  'If-None-Match': 'string'
}

r = requests.get('/transfers/configuration/groups/{groupName}', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/configuration/groups/{groupName}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        "If-None-Match": []string{"string"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/configuration/groups/{groupName}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Fetch a representation of this configuration group

GET /configuration/groups/{groupName}

Return a HAL representation of this configuration group resource.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "_profile": "http://api.apiture.com/schemas/transfers/configurationGroup/v1.0.0/profile.json",
  "_links": {
    "self": {
      "href": "/configuration/groups/basic"
    },
    "apiture:configuration": {
      "href": "/configuration"
    }
  },
  "name": "basic",
  "label": "Basic Settings",
  "description": "The basic settings for the Transfers API",
  "schema": {
    "type": "object",
    "properties": {
      "dailyLimit": {
        "type": "number",
        "description": "The daily limit for the number of transfers"
      },
      "cutoffTime": {
        "type": "string",
        "format": "time",
        "description": "The cutoff time for scheduling transfers for the current day"
      }
    }
  },
  "values": {
    "dailyLimit": 5,
    "cutoffTime": "17:30:00"
  }
}

Responses

Response Headers

getConfigurationGroupSchema

Code samples

# You can also use wget
curl -X GET /transfers/configuration/groups/{groupName}/schema \
  -H 'Accept: application/hal+json' \
  -H 'If-None-Match: string'

GET /transfers/configuration/groups/{groupName}/schema HTTP/1.1

Accept: application/hal+json
If-None-Match: string

var headers = {
  'Accept':'application/hal+json',
  'If-None-Match':'string'

};

$.ajax({
  url: '/transfers/configuration/groups/{groupName}/schema',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json',
  'If-None-Match':'string'

};

fetch('/transfers/configuration/groups/{groupName}/schema',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json',
  'If-None-Match' => 'string'
}

result = RestClient.get '/transfers/configuration/groups/{groupName}/schema',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json',
  'If-None-Match': 'string'
}

r = requests.get('/transfers/configuration/groups/{groupName}/schema', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/configuration/groups/{groupName}/schema");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        "If-None-Match": []string{"string"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/configuration/groups/{groupName}/schema", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Fetch the schema for this configuration group

GET /configuration/groups/{groupName}/schema

Return a HAL representation of this configuration group schema resource.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "type": "object",
  "properties": {
    "dailyLimit": {
      "type": "number",
      "description": "The daily limit for the number of transfers"
    },
    "cutoffTime": {
      "type": "string",
      "format": "time",
      "description": "The cutoff time for scheduling transfers for the current day"
    }
  }
}

Responses

Response Headers

getConfigurationGroupValues

Code samples

# You can also use wget
curl -X GET /transfers/configuration/groups/{groupName}/values \
  -H 'Accept: application/hal+json' \
  -H 'If-None-Match: string'

GET /transfers/configuration/groups/{groupName}/values HTTP/1.1

Accept: application/hal+json
If-None-Match: string

var headers = {
  'Accept':'application/hal+json',
  'If-None-Match':'string'

};

$.ajax({
  url: '/transfers/configuration/groups/{groupName}/values',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json',
  'If-None-Match':'string'

};

fetch('/transfers/configuration/groups/{groupName}/values',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json',
  'If-None-Match' => 'string'
}

result = RestClient.get '/transfers/configuration/groups/{groupName}/values',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json',
  'If-None-Match': 'string'
}

r = requests.get('/transfers/configuration/groups/{groupName}/values', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/configuration/groups/{groupName}/values");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        "If-None-Match": []string{"string"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/configuration/groups/{groupName}/values", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Fetch the values for the specified configuration group

GET /configuration/groups/{groupName}/values

Return a representation of this configuration group values resource.

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "dailyLimit": 5,
  "cutoffTime": "17:30:00"
}

Responses

Response Headers

updateConfigurationGroupValues

Code samples

# You can also use wget
curl -X PUT /transfers/configuration/groups/{groupName}/values \
  -H 'Content-Type: application/hal+json' \
  -H 'Accept: application/hal+json' \
  -H 'If-Match: string'

PUT /transfers/configuration/groups/{groupName}/values HTTP/1.1

Content-Type: application/hal+json
Accept: application/hal+json
If-Match: string

var headers = {
  'Content-Type':'application/hal+json',
  'Accept':'application/hal+json',
  'If-Match':'string'

};

$.ajax({
  url: '/transfers/configuration/groups/{groupName}/values',
  method: 'put',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');
const inputBody = '{
  "dailyLimit": 5,
  "cutoffTime": "17:30:00"
}';
const headers = {
  'Content-Type':'application/hal+json',
  'Accept':'application/hal+json',
  'If-Match':'string'

};

fetch('/transfers/configuration/groups/{groupName}/values',
{
  method: 'PUT',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/hal+json',
  'Accept' => 'application/hal+json',
  'If-Match' => 'string'
}

result = RestClient.put '/transfers/configuration/groups/{groupName}/values',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/hal+json',
  'Accept': 'application/hal+json',
  'If-Match': 'string'
}

r = requests.put('/transfers/configuration/groups/{groupName}/values', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/configuration/groups/{groupName}/values");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PUT");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/hal+json"},
        "Accept": []string{"application/hal+json"},
        "If-Match": []string{"string"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PUT", "/transfers/configuration/groups/{groupName}/values", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Update the values for the specified configuration group

PUT /configuration/groups/{groupName}/values

Perform a complete replacement of this set of values

Body parameter

{
  "dailyLimit": 5,
  "cutoffTime": "17:30:00"
}

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{
  "type": "object",
  "properties": {
    "dailyLimit": {
      "type": "number",
      "description": "The daily limit for the number of transfers"
    },
    "cutoffTime": {
      "type": "string",
      "format": "time",
      "description": "The cutoff time for scheduling transfers for the current day"
    }
  }
}

Responses

Response Headers

getConfigurationGroupValue

Code samples

# You can also use wget
curl -X GET /transfers/configuration/groups/{groupName}/values/{valueName} \
  -H 'Accept: application/hal+json'

GET /transfers/configuration/groups/{groupName}/values/{valueName} HTTP/1.1

Accept: application/hal+json

var headers = {
  'Accept':'application/hal+json'

};

$.ajax({
  url: '/transfers/configuration/groups/{groupName}/values/{valueName}',
  method: 'get',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');

const headers = {
  'Accept':'application/hal+json'

};

fetch('/transfers/configuration/groups/{groupName}/values/{valueName}',
{
  method: 'GET',

  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/hal+json'
}

result = RestClient.get '/transfers/configuration/groups/{groupName}/values/{valueName}',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Accept': 'application/hal+json'
}

r = requests.get('/transfers/configuration/groups/{groupName}/values/{valueName}', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/configuration/groups/{groupName}/values/{valueName}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/hal+json"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "/transfers/configuration/groups/{groupName}/values/{valueName}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Fetch a single value associated with the specified configuration group

GET /configuration/groups/{groupName}/values/{valueName}

Fetch a single value associated with this configuration group. This provides convenient access to the map of values of the configuration group. To update a specific value, use PUT /transfers/configuration/groups/{groupName}/values/{valueName} (operation updateConfigurationGroupValue).

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{}

Responses

Response Schema

Response Headers

updateConfigurationGroupValue

Code samples

# You can also use wget
curl -X PUT /transfers/configuration/groups/{groupName}/values/{valueName} \
  -H 'Content-Type: application/hal+json' \
  -H 'Accept: application/hal+json'

PUT /transfers/configuration/groups/{groupName}/values/{valueName} HTTP/1.1

Content-Type: application/hal+json
Accept: application/hal+json

var headers = {
  'Content-Type':'application/hal+json',
  'Accept':'application/hal+json'

};

$.ajax({
  url: '/transfers/configuration/groups/{groupName}/values/{valueName}',
  method: 'put',

  headers: headers,
  success: function(data) {
    console.log(JSON.stringify(data));
  }
})

const fetch = require('node-fetch');
const inputBody = '{}';
const headers = {
  'Content-Type':'application/hal+json',
  'Accept':'application/hal+json'

};

fetch('/transfers/configuration/groups/{groupName}/values/{valueName}',
{
  method: 'PUT',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

require 'rest-client'
require 'json'

headers = {
  'Content-Type' => 'application/hal+json',
  'Accept' => 'application/hal+json'
}

result = RestClient.put '/transfers/configuration/groups/{groupName}/values/{valueName}',
  params: {
  }, headers: headers

p JSON.parse(result)

import requests
headers = {
  'Content-Type': 'application/hal+json',
  'Accept': 'application/hal+json'
}

r = requests.put('/transfers/configuration/groups/{groupName}/values/{valueName}', params={

}, headers = headers)

print r.json()

URL obj = new URL("/transfers/configuration/groups/{groupName}/values/{valueName}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PUT");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/hal+json"},
        "Accept": []string{"application/hal+json"},
        
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PUT", "/transfers/configuration/groups/{groupName}/values/{valueName}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Update a single value associated with the specified configuration group

PUT /configuration/groups/{groupName}/values/{valueName}

Update a single value associated with this configuration group. This provides convenient access to individual values of the configuration group as defined in the configuration group's schema. The request body must conform to the configuration group's schema for the named {valueName}. This operation is idempotent.

To update a specific value, use PUT /transfers/configuration/groups/{groupName}/values/{valueName} (operation updateConfigurationGroupValue).

Body parameter

{}

Parameters

Try it

Fields marked with * are mandatory.

Response

    
      Click on 'Try It' to get a response.
    
  

Example responses

200 Response

{}

Responses

Response Schema

Response Headers

Schemas

transferFields

{
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "schedule": {
    "start": "2018-06-10",
    "every": "P14D",
    "count": 5,
    "skippedCount": 0,
    "maximumCount": 10,
    "skipNext": true,
    "end": "2018-08-01"
  },
  "type": "internal",
  "visibility": "visible"
}

Common Transfer Fields

Properties

Enumerated Values

createScheduledTransfer

{
  "_profile": "http://api.apiture.com/schemas/transfers/createScheduledTransfer/v1.0.0/profile.json",
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "schedule": {
    "start": "2018-02-05",
    "maximumCount": 36,
    "every": "P1M",
    "skipNext": false,
    "end": "2021-04-05"
  },
  "_links": {
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    }
  }
}

Create Scheduled Transfer

Properties

allOf

and

summaryScheduledTransfer

{
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "_profile": "http://api.apiture.com/schemas/transfers/summaryScheduledTransfer/v1.0.0/profile.json",
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    }
  },
  "state": "recurring",
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "schedule": {
    "start": "2018-02-05",
    "maximumCount": 36,
    "skippedCount": 1,
    "count": 11,
    "skipNext": false,
    "every": "P1M",
    "end": "2021-04-05"
  }
}

Scheduled Transfer Summary

Properties

allOf

and

and

Enumerated Values

summaryPastTransfer

{
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "_profile": "http://api.apiture.com/schemas/transfers/summaryScheduledTransfer/v1.0.0/profile.json",
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    }
  },
  "state": "recurring",
  "amount": {
    "value": "345.50",
    "currency": "USD"
  },
  "description": "Car payment",
  "schedule": {
    "start": "2018-02-05",
    "maximumCount": 36,
    "skippedCount": 1,
    "count": 11,
    "skipNext": false,
    "every": "P1M",
    "end": "2021-04-05"
  }
}

Past Transfer Summary

Properties

updateScheduledTransfer

{
  "_id": "0399abed-fd3d-4830-a88b-30f38b8a365c",
  "_profile": "http://api.apiture.com/schemas/transfers/scheduledTransfer/v1.0.0/profile.json",
  "state": "recurring",
  "amount": {
    "value": "356.40",
    "currency": "USD"
  },
  "description": "Car payment",
  "schedule": {
    "start": "2018-02-05",
    "maximumCount": 36,
    "skippedCount": 1,
    "count": 11,
    "skipNext": true,
    "every": "P1M",
    "end": "2021-04-05"
  },
  "_links": {
    "self": {
      "href": "/transfers/scheduledTransfers/0399abed-fd3d-4830-a88b-30f38b8a365c"
    },
    "apiture:source": {
      "href": "/accounts/accounts/46a31698-7398-4538-a9c9-9496010da2c2"
    },
    "apiture:target": {
      "href": "/accounts/externalAccounts/599b8ab5-6925-4f58-90c5-f6aa5b05f9d9"
    }
  }
}

Update Scheduled Transfer

Properties

transferAccount

{
  "accountTitle": "John Smith",
  "institutionName": "3rd Party Bank",
  "routingNumber": "021000021",
  "accountNumbers": {
    "masked": "*************3210",
    "full": "9876543210"
  }
}

Transfer Account

Properties

accountNumbers

{
  "masked": "*************3210",
  "full": "9876543210"
}

Account Numbers

Properties