Account Transfers — Increase

Skip to main content

Increase home

Docs

Guides API Reference Changelog Search

Status Dashboard

Account Transfers

Guides\ \ Explanatory and how-to content API Reference\ \ Technical documentation Changelog\ \ Release notes Dashboard\ \ Manage your account Status\ \ Service status

API Reference

Overview

API Reference

Overview Authorization and Testing OpenAPI SDKs OAuth Requests and Responses Object Lists Errors Idempotency Sandbox Simulations

Accounts

Accounts

Overview The Account object List Accounts Create an Account Retrieve an Account Update an Account Retrieve an Account Balance Close an Account Sandbox: Create an account revenue payment Sandbox: Create an interest payment

Account Numbers

Overview The Account Number object List Account Numbers Create an Account Number Retrieve an Account Number Update an Account Number

Account Transfers

Overview The Account Transfer object List Account Transfers Create an Account Transfer Retrieve an Account Transfer Approve an Account Transfer Cancel an Account Transfer

Transactions

Transactions

Overview The Transaction object List Transactions Retrieve a Transaction

Pending Transactions

Overview The Pending Transaction object List Pending Transactions Create a Pending Transaction Retrieve a Pending Transaction Release a user-initiated Pending Transaction Sandbox: Release an Inbound Funds Hold

Declined Transactions

Overview The Declined Transaction object List Declined Transactions Retrieve a Declined Transaction

Ach Transfers

ACH Transfers

Overview The ACH Transfer object List ACH Transfers Create an ACH Transfer Retrieve an ACH Transfer Approve an ACH Transfer Cancel a pending ACH Transfer Sandbox: Acknowledge an ACH Transfer Sandbox: Create a Notification of Change for an ACH Transfer Sandbox: Return an ACH Transfer Sandbox: Settle an ACH Transfer Sandbox: Submit an ACH Transfer

Inbound ACH Transfers

Overview The Inbound ACH Transfer object List Inbound ACH Transfers Retrieve an Inbound ACH Transfer Create a notification of change for an Inbound ACH Transfer Decline an Inbound ACH Transfer Return an Inbound ACH Transfer Sandbox: Create an Inbound ACH Transfer

ACH Prenotifications

Overview The ACH Prenotification object List ACH Prenotifications Create an ACH Prenotification Retrieve an ACH Prenotification

Check Transfers

Check Transfers

Overview The Check Transfer object List Check Transfers Create a Check Transfer Retrieve a Check Transfer Approve a Check Transfer Cancel a pending Check Transfer Stop payment on a Check Transfer Sandbox: Mail a Check Transfer

Inbound Check Deposits

Overview The Inbound Check Deposit object List Inbound Check Deposits Retrieve an Inbound Check Deposit Decline an Inbound Check Deposit Return an Inbound Check Deposit Sandbox: Create an Inbound Check Deposit Sandbox: Accept an Inbound Check Deposit Sandbox: Create an Inbound Check Deposit Adjustment

Physical Check Batches

Overview The Physical Check Batch object Create a Physical Check Batch Cancel a Physical Check Batch Complete a Physical Check Batch

Real Time Payments Transfers

Real-Time Payments Transfers

Overview The Real-Time Payments Transfer object List Real-Time Payments Transfers Create a Real-Time Payments Transfer Retrieve a Real-Time Payments Transfer Approve a Real-Time Payments Transfer Cancel a pending Real-Time Payments Transfer Sandbox: Complete a Real-Time Payments Transfer

Inbound Real-Time Payments Transfers

Overview The Inbound Real-Time Payments Transfer object List Inbound Real-Time Payments Transfers Retrieve an Inbound Real-Time Payments Transfer Sandbox: Create an Inbound Real-Time Payments Transfer

Real-Time Payments Requests for Payment

Overview The Real-Time Payments Request for Payment object List Real-Time Payments Requests for Payment Create a Real-Time Payments Request for Payment Retrieve a Real-Time Payments Request for Payment

Inbound Real-Time Payments Requests for Payment

Overview The Inbound Real-Time Payments Request for Payment object List Inbound Real-Time Payments Requests for Payment Retrieve an Inbound Real-Time Payments Request for Payment

Fednow Transfers

FedNow Transfers

Overview The FedNow Transfer object List FedNow Transfers Create a FedNow Transfer Retrieve a FedNow Transfer Approve a FedNow Transfer Cancel a pending FedNow Transfer Sandbox: Complete a FedNow Transfer

Inbound FedNow Transfers

Overview The Inbound FedNow Transfer object List Inbound FedNow Transfers Retrieve an Inbound FedNow Transfer Sandbox: Create an Inbound FedNow Transfer

Swift Transfers

Swift Transfers

Overview The Swift Transfer object List Swift Transfers Create a Swift Transfer Retrieve a Swift Transfer Approve a Swift Transfer Cancel a pending Swift Transfer

Wire Transfers

Wire Transfers

Overview The Wire Transfer object List Wire Transfers Create a Wire Transfer Retrieve a Wire Transfer Approve a Wire Transfer Cancel a pending Wire Transfer Sandbox: Reverse a Wire Transfer Sandbox: Submit a Wire Transfer

Inbound Wire Transfers

Overview The Inbound Wire Transfer object List Inbound Wire Transfers Retrieve an Inbound Wire Transfer Reverse an Inbound Wire Transfer Sandbox: Create an Inbound Wire Transfer

Wire Drawdown Requests

Overview The Wire Drawdown Request object List Wire Drawdown Requests Create a Wire Drawdown Request Retrieve a Wire Drawdown Request Sandbox: Refuse a Wire Drawdown Request Sandbox: Submit a Wire Drawdown Request

Inbound Wire Drawdown Requests

Overview The Inbound Wire Drawdown Request object List Inbound Wire Drawdown Requests Retrieve an Inbound Wire Drawdown Request Sandbox: Create an Inbound Wire Drawdown request

Card Transfers

Card Tokens

Overview The Card Token object List Card Tokens Retrieve a Card Token Retrieve the capabilities of a Card Token Sandbox: Create a Card Token

Card Push Transfers

Overview The Card Push Transfer object List Card Push Transfers Create a Card Push Transfer Retrieve a Card Push Transfer Approve a Card Push Transfer Cancel a pending Card Push Transfer

Card Validations

Overview The Card Validation object List Card Validations Create a Card Validation Retrieve a Card Validation

Check Deposits

Check Deposits

Overview The Check Deposit object List Check Deposits Create a Check Deposit Retrieve a Check Deposit Sandbox: Adjust a Check Deposit Sandbox: Reject a Check Deposit Sandbox: Return a Check Deposit Sandbox: Submit a Check Deposit

Lockbox Addresses

Overview The Lockbox Address object List Lockbox Addresses Create a Lockbox Address Retrieve a Lockbox Address Update a Lockbox Address

Lockbox Recipients

Overview The Lockbox Recipient object List Lockbox Recipients Create a Lockbox Recipient Retrieve a Lockbox Recipient Update a Lockbox Recipient

Inbound Mail Items

Overview The Inbound Mail Item object List Inbound Mail Items Retrieve an Inbound Mail Item Action an Inbound Mail Item Sandbox: Create an Inbound Mail Item

Cards

Cards

Overview The Card object List Cards Create a Card Retrieve a Card Update a Card Create a Card details iframe Retrieve sensitive details for a Card Update a Card's PIN

Card Payments

Overview The Card Payment object List Card Payments Retrieve a Card Payment Sandbox: Create a Card Authentication attempt Sandbox: Create a Card Authentication Challenge attempt Sandbox: Create an initial Card Authentication Challenge Sandbox: Expire a Card Authorization Sandbox: Create a Card Authorization Sandbox: Create a Card Balance Inquiry Sandbox: Confirm the fuel pump amount for a Card Authorization Sandbox: Increment a Card Authorization Sandbox: Refund a card transaction Sandbox: Reverse a Card Authorization Sandbox: Settle a Card Authorization

Card Purchase Supplements

Overview The Card Purchase Supplement object List Card Purchase Supplements Retrieve a Card Purchase Supplement Sandbox: Create a Card Purchase Supplement

Card Disputes

Overview The Card Dispute object List Card Disputes Create a Card Dispute Retrieve a Card Dispute Submit a User Submission for a Card Dispute Withdraw a Card Dispute Sandbox: Advance the state of a Card Dispute

Physical Cards

Overview The Physical Card object List Physical Cards Create a Physical Card Retrieve a Physical Card Update a Physical Card Sandbox: Advance the shipment status of a Physical Card Sandbox: Create a Physical Card Shipment Tracking Update

Digital Card Profiles

Overview The Digital Card Profile object List Card Profiles Create a Digital Card Profile Retrieve a Digital Card Profile Archive a Digital Card Profile Clones a Digital Card Profile

Physical Card Profiles

Overview The Physical Card Profile object List Physical Card Profiles Create a Physical Card Profile Retrieve a Card Profile Archive a Physical Card Profile Clone a Physical Card Profile

Digital Wallet Tokens

Overview The Digital Wallet Token object List Digital Wallet Tokens Retrieve a Digital Wallet Token Sandbox: Create a digital wallet token request

Compliance

Entities

Overview The Entity object List Entities Create an Entity Retrieve an Entity Update an Entity Archive an Entity Sandbox: Simulate validation of an Entity

Beneficial Owners

Overview The Beneficial Owner object List Beneficial Owners Create a Beneficial Owner Retrieve a Beneficial Owner Update a Beneficial Owner Archive a Beneficial Owner

Supplemental Documents

Overview The Supplemental Document object List Entity Supplemental Document Submissions Create a supplemental document for an Entity

Entity Onboarding Sessions

Overview The Entity Onboarding Session object List Entity Onboarding Session Create an Entity Onboarding Session Retrieve an Entity Onboarding Session Expire an Entity Onboarding Session Sandbox: Submit an Entity Onboarding Session

Programs

Overview The Program object List Programs Retrieve a Program Sandbox: Create a Program

Events and Webhooks

Events

Overview The Event object List Events Retrieve an Event

Event Subscriptions

Overview The Event Subscription object List Event Subscriptions Create an Event Subscription Retrieve an Event Subscription Update an Event Subscription

Real-Time Decisions

Overview The Real-Time Decision object Retrieve a Real-Time Decision Action a Real-Time Decision

External Accounts

Routing Numbers

Overview The Routing Number object List Routing Numbers

External Accounts

Overview The External Account object List External Accounts Create an External Account Retrieve an External Account Update an External Account

Files and Exports

Account Statements

Overview The Account Statement object List Account Statements Retrieve an Account Statement Sandbox: Create an Account Statement

Files

Overview The File object List Files Create a File Retrieve a File Get File Contents

File Links

Overview The File Link object Create a File Link

Exports

Overview The Export object List Exports Create an Export Retrieve an Export Sandbox: Generate a Tax Form Export

OAuth

Groups

Overview The Group object Retrieve Group details

OAuth Applications

Overview The OAuth Application object List OAuth Applications Retrieve an OAuth Application

OAuth Connections

Overview The OAuth Connection object List OAuth Connections Retrieve an OAuth Connection

OAuth Tokens

Overview The OAuth Token object Create an OAuth Token

Intrafi

IntraFi Account Enrollments

Overview The IntraFi Account Enrollment object List IntraFi Account Enrollments Enroll an account in the IntraFi deposit sweep network Get an IntraFi Account Enrollment Unenroll an account from IntraFi

IntraFi Balances

Overview The IntraFi Balance object Get IntraFi balance

IntraFi Exclusions

Overview The IntraFi Exclusion object List IntraFi Exclusions Create an IntraFi Exclusion Get an IntraFi Exclusion Archive an IntraFi Exclusion

Account Transfers

Copy for LLM

Account transfers move funds between your own accounts at Increase (accounting systems often refer to these as Book Transfers). Account Transfers are free and synchronous. Upon creation they create two Transactions, one negative on the originating account and one positive on the destination account (unless the transfer requires approval, in which case the Transactions will be created when the transfer is approved).

Events

Your application can listen to webhooks about this resource. The events about Account Transfers will have the categories "account_transfer.created" or "account_transfer.updated" .

The Account Transfer object

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

{
  "account_id": "account_in71c4amph0vgo2qllky",
  "amount": 100,
  "approval": {
    "approved_at": "2020-01-31T23:59:59Z",
    "approved_by": null
  },
  "cancellation": null,
  "created_at": "2020-01-31T23:59:59Z",
  "created_by": {
    "category": "user",
    "user": {
      "email": "user@example.com"
    }
  },
  "currency": "USD",
  "description": "Move money into savings",
  "destination_account_id": "account_uf16sut2ct5bevmq3eh",
  "destination_transaction_id": "transaction_j3itv8dtk5o8pw3p1xj4",
  "id": "account_transfer_7k9qe1ysdgqztnt63l7n",
  "idempotency_key": null,
  "pending_transaction_id": null,
  "status": "complete",
  "transaction_id": "transaction_uyrp7fld2ium70oa7oi",
  "type": "account_transfer"
}

Attributes

account_id

string

The Account from which the transfer originated.

More about Accounts.

amount

integer

The transfer amount in cents. This will always be positive and indicates the amount of money leaving the originating account.

approval

dictionary

Nullable

If your account requires approvals for transfers and the transfer was approved, this will contain details of the approval.

Child attributes

cancellation

dictionary

Nullable

If your account requires approvals for transfers and the transfer was not approved, this will contain details of the cancellation.

Child attributes

created_at

string

The ISO 8601 date and time at which the transfer was created.

created_by

dictionary

Nullable

What object created the transfer, either via the API or the dashboard.

Child attributes

currency

enum

The ISO 4217 code for the transfer’s currency.

Possible values

description

string

An internal-facing description for the transfer for display in the API and dashboard. This will also show in the description of the created Transactions.

destination_account_id

string

The destination Account’s identifier.

More about Accounts.

destination_transaction_id

string

Nullable

The identifier of the Transaction on the destination Account representing the received funds.

More about Transactions.

id

string

The Account Transfer’s identifier.

idempotency_key

string

Nullable

The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about idempotency.

pending_transaction_id

string

Nullable

The ID for the pending transaction representing the transfer. A pending transaction is created when the transfer requires approval by someone else in your organization.

More about Pending Transactions.

status

enum

The lifecycle status of the transfer.

Possible values

transaction_id

string

Nullable

The identifier of the Transaction on the originating account representing the transferred funds.

More about Transactions.

type

string

A constant representing the object’s type. For this resource it will always be account_transfer.

List Account Transfers

cURL TypeScript Python Ruby Go Java Kotlin PHP C#

1

2

3

curl \
  --url "${INCREASE_URL}/account_transfers?account_id=account_in71c4amph0vgo2qllky" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

1

2

3

4

5

6

7

8

9

10

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const accountTransfer of client.accountTransfers.list()) {
  console.log(accountTransfer.id);
}

1

2

3

4

5

6

7

8

9

import os
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
page = client.account_transfers.list()
page = page.data[0]
print(page.id)

1

2

3

4

5

6

7

8

9

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

page = increase.account_transfers.list

puts(page)

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

package main

import (
    "context"
    "fmt"
    "os"

"github.com/Increase/increase-go"
    "github.com/Increase/increase-go/option"
)

func main() {
    client := increase.NewClient(
        option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
    )
    page, err := client.AccountTransfers.List(context.TODO(), increase.AccountTransferListParams{})
    if err != nil {
        panic(err.Error())
    }
    fmt.Printf("%+v\n", page)
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.accounttransfers.AccountTransferListPage;
import com.increase.api.models.accounttransfers.AccountTransferListParams;

public final class Main {
    private Main() {}

public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

AccountTransferListPage page = client.accountTransfers().list();
    }
}

1

2

3

4

5

6

7

8

9

10

11

12

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.accounttransfers.AccountTransferListPage
import com.increase.api.models.accounttransfers.AccountTransferListParams

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

val page: AccountTransferListPage = client.accountTransfers().list()
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $page = $client->accountTransfers->list(
    accountID: 'account_id',
    createdAt: [\
      'after' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),\
      'before' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),\
      'onOrAfter' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),\
      'onOrBefore' => new \DateTimeImmutable('2019-12-27T18:11:19.117Z'),\
    ],
    cursor: 'cursor',
    idempotencyKey: 'x',
    limit: 1,
  );

var_dump($page);
} catch (APIException $e) {
  echo $e->getMessage();
}

1

2

3

4

5

6

7

8

9

10

11

12

13

using System;
using Increase.Api;
using Increase.Api.Models.AccountTransfers;

IncreaseClient client = new();

AccountTransferListParams parameters = new();

var page = await client.AccountTransfers.List(parameters);
await foreach (var item in page.Paginate())
{
    Console.WriteLine(item);
}

Returns a list response :

1

2

3

4

5

6

7

8

{
  "data": [\
    { /* Account Transfer object */ },\
    { /* Account Transfer object */ }\
    /* ... */\
  ],
  "next_cursor": "v57w5d",
}

Parameters

account_id

string

Filter Account Transfers to those that originated from the specified Account.

More about Accounts.

idempotency_key

string

Filter records to the one with the specified idempotency_key you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about idempotency.

Between 1 and 200 characters

More parameters

Expand all

cursor

string

limit

integer

created_at.after

string

created_at.before

string

created_at.on_or_after

string

created_at.on_or_before

string

Create an Account Transfer

cURL TypeScript Python Ruby Go Java Kotlin PHP C#

1

2

3

4

5

6

7

8

9

10

curl -X "POST" \
  --url "${INCREASE_URL}/account_transfers" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d $'{
    "account_id": "account_in71c4amph0vgo2qllky",
    "amount": 100,
    "description": "Creating liquidity",
    "destination_account_id": "account_uf16sut2ct5bevmq3eh"
  }'

1

2

3

4

5

6

7

8

9

10

11

12

13

14

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

const accountTransfer = await client.accountTransfers.create({
  account_id: 'account_in71c4amph0vgo2qllky',
  amount: 100,
  description: 'Creating liquidity',
  destination_account_id: 'account_uf16sut2ct5bevmq3eh',
});

console.log(accountTransfer.id);

1

2

3

4

5

6

7

8

9

10

11

12

13

import os
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
account_transfer = client.account_transfers.create(
    account_id="account_in71c4amph0vgo2qllky",
    amount=100,
    description="Creating liquidity",
    destination_account_id="account_uf16sut2ct5bevmq3eh",
)
print(account_transfer.id)

1

2

3

4

5

6

7

8

9

10

11

12

13

14

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

account_transfer = increase.account_transfers.create(
  account_id: "account_in71c4amph0vgo2qllky",
  amount: 100,
  description: "Creating liquidity",
  destination_account_id: "account_uf16sut2ct5bevmq3eh"
)

puts(account_transfer)

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

package main

import (
    "context"
    "fmt"
    "os"

"github.com/Increase/increase-go"
    "github.com/Increase/increase-go/option"
)

func main() {
    client := increase.NewClient(
        option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
    )
    accountTransfer, err := client.AccountTransfers.New(context.TODO(), increase.AccountTransferNewParams{
        AccountID:            increase.F("account_in71c4amph0vgo2qllky"),
        Amount:               increase.F(int64(100)),
        Description:          increase.F("Creating liquidity"),
        DestinationAccountID: increase.F("account_uf16sut2ct5bevmq3eh"),
    })
    if err != nil {
        panic(err.Error())
    }
    fmt.Printf("%+v\n", accountTransfer.ID)
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.accounttransfers.AccountTransfer;
import com.increase.api.models.accounttransfers.AccountTransferCreateParams;

public final class Main {
    private Main() {}

public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

AccountTransferCreateParams params = AccountTransferCreateParams.builder()
            .accountId("account_in71c4amph0vgo2qllky")
            .amount(100L)
            .description("Creating liquidity")
            .destinationAccountId("account_uf16sut2ct5bevmq3eh")
            .build();
        AccountTransfer accountTransfer = client.accountTransfers().create(params);
    }
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.accounttransfers.AccountTransfer
import com.increase.api.models.accounttransfers.AccountTransferCreateParams

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

val params: AccountTransferCreateParams = AccountTransferCreateParams.builder()
        .accountId("account_in71c4amph0vgo2qllky")
        .amount(100L)
        .description("Creating liquidity")
        .destinationAccountId("account_uf16sut2ct5bevmq3eh")
        .build()
    val accountTransfer: AccountTransfer = client.accountTransfers().create(params)
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $accountTransfer = $client->accountTransfers->create(
    accountID: 'account_in71c4amph0vgo2qllky',
    amount: 100,
    description: 'Creating liquidity',
    destinationAccountID: 'account_uf16sut2ct5bevmq3eh',
    requireApproval: true,
  );

var_dump($accountTransfer);
} catch (APIException $e) {
  echo $e->getMessage();
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

using System;
using Increase.Api;
using Increase.Api.Models.AccountTransfers;

IncreaseClient client = new();

AccountTransferCreateParams parameters = new()
{
    AccountID = "account_in71c4amph0vgo2qllky",
    Amount = 100,
    Description = "Creating liquidity",
    DestinationAccountID = "account_uf16sut2ct5bevmq3eh",
};

var accountTransfer = await client.AccountTransfers.Create(parameters);

Console.WriteLine(accountTransfer);

Parameters

account_id

string

Required

The identifier for the originating Account that will send the transfer.

More about Accounts.

amount

integer

Required

The transfer amount in the minor unit of the account currency. For dollars, for example, this is cents.

description

string

Required

An internal-facing description for the transfer for display in the API and dashboard. This will also show in the description of the created Transactions.

Between 1 and 200 characters

destination_account_id

string

Required

The identifier for the destination Account that will receive the transfer.

More about Accounts.

require_approval

boolean

Whether the transfer should require explicit approval via the dashboard or API. For more information, see Transfer Approvals.

Retrieve an Account Transfer

cURL TypeScript Python Ruby Go Java Kotlin PHP C#

1

2

3

curl \
  --url "${INCREASE_URL}/account_transfers/account_transfer_7k9qe1ysdgqztnt63l7n" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

1

2

3

4

5

6

7

8

9

10

11

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

const accountTransfer = await client.accountTransfers.retrieve(
  'account_transfer_7k9qe1ysdgqztnt63l7n',
);

console.log(accountTransfer.id);

1

2

3

4

5

6

7

8

9

10

import os
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
account_transfer = client.account_transfers.retrieve(
    "account_transfer_7k9qe1ysdgqztnt63l7n",
)
print(account_transfer.id)

1

2

3

4

5

6

7

8

9

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

account_transfer = increase.account_transfers.retrieve("account_transfer_7k9qe1ysdgqztnt63l7n")

puts(account_transfer)

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

package main

import (
    "context"
    "fmt"
    "os"

"github.com/Increase/increase-go"
    "github.com/Increase/increase-go/option"
)

func main() {
    client := increase.NewClient(
        option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
    )
    accountTransfer, err := client.AccountTransfers.Get(context.TODO(), "account_transfer_7k9qe1ysdgqztnt63l7n")
    if err != nil {
        panic(err.Error())
    }
    fmt.Printf("%+v\n", accountTransfer.ID)
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.accounttransfers.AccountTransfer;
import com.increase.api.models.accounttransfers.AccountTransferRetrieveParams;

public final class Main {
    private Main() {}

public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

AccountTransfer accountTransfer = client.accountTransfers().retrieve("account_transfer_7k9qe1ysdgqztnt63l7n");
    }
}

1

2

3

4

5

6

7

8

9

10

11

12

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.accounttransfers.AccountTransfer
import com.increase.api.models.accounttransfers.AccountTransferRetrieveParams

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

val accountTransfer: AccountTransfer = client.accountTransfers().retrieve("account_transfer_7k9qe1ysdgqztnt63l7n")
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $accountTransfer = $client->accountTransfers->retrieve(
    'account_transfer_7k9qe1ysdgqztnt63l7n'
  );

var_dump($accountTransfer);
} catch (APIException $e) {
  echo $e->getMessage();
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

using System;
using Increase.Api;
using Increase.Api.Models.AccountTransfers;

IncreaseClient client = new();

AccountTransferRetrieveParams parameters = new()
{
    AccountTransferID = "account_transfer_7k9qe1ysdgqztnt63l7n"
};

var accountTransfer = await client.AccountTransfers.Retrieve(parameters);

Console.WriteLine(accountTransfer);

Parameters

account_transfer_id

string

Required

The identifier of the Account Transfer.

More about Account Transfers.

Approve an Account Transfer

Approves an Account Transfer in status pending_approval.

cURL TypeScript Python Ruby Go Java Kotlin PHP C#

1

2

3

curl -X "POST" \
  --url "${INCREASE_URL}/account_transfers/account_transfer_7k9qe1ysdgqztnt63l7n/approve" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

1

2

3

4

5

6

7

8

9

10

11

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

const accountTransfer = await client.accountTransfers.approve(
  'account_transfer_7k9qe1ysdgqztnt63l7n',
);

console.log(accountTransfer.id);

1

2

3

4

5

6

7

8

9

10

import os
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
account_transfer = client.account_transfers.approve(
    "account_transfer_7k9qe1ysdgqztnt63l7n",
)
print(account_transfer.id)

1

2

3

4

5

6

7

8

9

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

account_transfer = increase.account_transfers.approve("account_transfer_7k9qe1ysdgqztnt63l7n")

puts(account_transfer)

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

package main

import (
    "context"
    "fmt"
    "os"

"github.com/Increase/increase-go"
    "github.com/Increase/increase-go/option"
)

func main() {
    client := increase.NewClient(
        option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
    )
    accountTransfer, err := client.AccountTransfers.Approve(context.TODO(), "account_transfer_7k9qe1ysdgqztnt63l7n")
    if err != nil {
        panic(err.Error())
    }
    fmt.Printf("%+v\n", accountTransfer.ID)
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.accounttransfers.AccountTransfer;
import com.increase.api.models.accounttransfers.AccountTransferApproveParams;

public final class Main {
    private Main() {}

public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

AccountTransfer accountTransfer = client.accountTransfers().approve("account_transfer_7k9qe1ysdgqztnt63l7n");
    }
}

1

2

3

4

5

6

7

8

9

10

11

12

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.accounttransfers.AccountTransfer
import com.increase.api.models.accounttransfers.AccountTransferApproveParams

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

val accountTransfer: AccountTransfer = client.accountTransfers().approve("account_transfer_7k9qe1ysdgqztnt63l7n")
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $accountTransfer = $client->accountTransfers->approve(
    'account_transfer_7k9qe1ysdgqztnt63l7n'
  );

var_dump($accountTransfer);
} catch (APIException $e) {
  echo $e->getMessage();
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

using System;
using Increase.Api;
using Increase.Api.Models.AccountTransfers;

IncreaseClient client = new();

AccountTransferApproveParams parameters = new()
{
    AccountTransferID = "account_transfer_7k9qe1ysdgqztnt63l7n"
};

var accountTransfer = await client.AccountTransfers.Approve(parameters);

Console.WriteLine(accountTransfer);

Parameters

account_transfer_id

string

Required

The identifier of the Account Transfer to approve.

More about Account Transfers.

Cancel an Account Transfer

Cancels an Account Transfer in status pending_approval.

cURL TypeScript Python Ruby Go Java Kotlin PHP C#

1

2

3

curl -X "POST" \
  --url "${INCREASE_URL}/account_transfers/account_transfer_7k9qe1ysdgqztnt63l7n/cancel" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"

1

2

3

4

5

6

7

8

9

10

11

import Increase from 'increase';

const client = new Increase({
  apiKey: process.env['INCREASE_API_KEY'], // This is the default and can be omitted
});

const accountTransfer = await client.accountTransfers.cancel(
  'account_transfer_7k9qe1ysdgqztnt63l7n',
);

console.log(accountTransfer.id);

1

2

3

4

5

6

7

8

9

10

import os
from increase import Increase

client = Increase(
    api_key=os.environ.get("INCREASE_API_KEY"),  # This is the default and can be omitted
)
account_transfer = client.account_transfers.cancel(
    "account_transfer_7k9qe1ysdgqztnt63l7n",
)
print(account_transfer.id)

1

2

3

4

5

6

7

8

9

require "increase"

increase = Increase::Client.new(
  api_key: ENV["INCREASE_API_KEY"] # This is the default and can be omitted
)

account_transfer = increase.account_transfers.cancel("account_transfer_7k9qe1ysdgqztnt63l7n")

puts(account_transfer)

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

package main

import (
    "context"
    "fmt"
    "os"

"github.com/Increase/increase-go"
    "github.com/Increase/increase-go/option"
)

func main() {
    client := increase.NewClient(
        option.WithAPIKey(os.Getenv("INCREASE_API_KEY")), // This is the default and can be omitted
    )
    accountTransfer, err := client.AccountTransfers.Cancel(context.TODO(), "account_transfer_7k9qe1ysdgqztnt63l7n")
    if err != nil {
        panic(err.Error())
    }
    fmt.Printf("%+v\n", accountTransfer.ID)
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

package com.increase.api.example;

import com.increase.api.client.IncreaseClient;
import com.increase.api.client.okhttp.IncreaseOkHttpClient;
import com.increase.api.models.accounttransfers.AccountTransfer;
import com.increase.api.models.accounttransfers.AccountTransferCancelParams;

public final class Main {
    private Main() {}

public static void main(String[] args) {
        IncreaseClient client = IncreaseOkHttpClient.fromEnv();

AccountTransfer accountTransfer = client.accountTransfers().cancel("account_transfer_7k9qe1ysdgqztnt63l7n");
    }
}

1

2

3

4

5

6

7

8

9

10

11

12

package com.increase.api.example

import com.increase.api.client.IncreaseClient
import com.increase.api.client.okhttp.IncreaseOkHttpClient
import com.increase.api.models.accounttransfers.AccountTransfer
import com.increase.api.models.accounttransfers.AccountTransferCancelParams

fun main() {
    val client: IncreaseClient = IncreaseOkHttpClient.fromEnv()

val accountTransfer: AccountTransfer = client.accountTransfers().cancel("account_transfer_7k9qe1ysdgqztnt63l7n")
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Increase\Client;
use Increase\Core\Exceptions\APIException;

$client = new Client(apiKey: getenv('INCREASE_API_KEY'));

try {
  $accountTransfer = $client->accountTransfers->cancel(
    'account_transfer_7k9qe1ysdgqztnt63l7n'
  );

var_dump($accountTransfer);
} catch (APIException $e) {
  echo $e->getMessage();
}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

using System;
using Increase.Api;
using Increase.Api.Models.AccountTransfers;

IncreaseClient client = new();

AccountTransferCancelParams parameters = new()
{
    AccountTransferID = "account_transfer_7k9qe1ysdgqztnt63l7n"
};

var accountTransfer = await client.AccountTransfers.Cancel(parameters);

Console.WriteLine(accountTransfer);

Parameters

account_transfer_id

string

Required

The identifier of the pending Account Transfer to cancel.

More about Account Transfers.