The Increase API is organized around REST. It has predictable resource-oriented URLs, accepts and returns JSON-encoded payloads, and uses standard HTTP response codes, authentication, and verbs.
While we're continually adding new features to the API, we're committed to doing so in a way that doesn't break existing integrations. You can read more in our versioning and backwards compatibility guide.
The API accepts Bearer Authentication. When you sign up for an Increase account, we make you a pair of API keys: one for production and one for our sandbox environment in which no real money moves. You can create and revoke API keys from the dashboard and should securely store them using a secret management system.
Production API requests should be to https://api.increase.com
and sandbox requests should be to https://sandbox.increase.com
. We'll put these into environment variables to make our code examples easier to follow.
This reference also exists in OpenAPI 3 format. This spec is in beta and subject to change. If you find it useful, or have feedback, let us know!
If you're interested in building an application that connects to other Increase users' data, you can build an OAuth application. Learn more about this in our OAuth guide.
When making a POST
request to the API, use a Content-Type
of application/json
and specify parameters via JSON in the request body:
When making a GET
request to the API, you should specify parameters in the query string of the URL. Join nested parameters, such as timestamp-based filters, with a .
– for example, created_at.before
:
All responses from the API will have a Content-Type
of application/json
.
List endpoints return a wrapper object with the data and a cursor. The API will return the next page of results if you submit the next_cursor
as a query parameter with the name cursor
. Any filter parameters passed to the original list request must be included if next_cursor
is specified. The maximum (and default) page size is 100 objects. You can adjust it using the limit
parameter.
The API uses standard HTTP response codes to indicate the success or failure of requests. Codes in the 2xx range indicate success; codes in the 4xx and 5xx range indicate errors. Error objects conform to RFC 7807 and can be distinguished by their type
attribute. Errors will always have the same shape.
Additional information about this particular error.
The HTTP status code of the error is also included in the response body for easier debugging.
A human-readable string explaining the type of error.
The type of error that occurred. This is a machine-readable enum.
The API supports idempotency for safely retrying requests without accidentally performing the same operation twice. This is useful when an API call is disrupted in transit and you do not receive a response. For example, if a request to create an ACH Transfer does not respond due to a network connection error, you can retry the request with the same idempotency key to guarantee that no more than one transfer is created.
To perform an idempotent request, provide an additional, unique Idempotency-Key
request header per intended request.
POST
endpoints also allow passing idempotency_key
as a JSON parameter.
Read more about Increase's idempotency keys.
Accounts are your bank accounts with Increase. They store money, receive transfers, and send payments. They earn interest and have depository insurance.
The bank the Account is with.
The ISO 8601 time at which the Account was created.
The identifier for the Entity the Account belongs to.
The identifier of an Entity that, while not owning the Account, is associated with its activity.
The Account identifier.
The identifier of the Program determining the compliance and commercial terms of this Account.
The interest accrued but not yet paid, expressed as a string containing a floating-point value.
The latest ISO 8601 date on which interest was accrued.
The Interest Rate currently being earned on the account, as a string containing a decimal number. For example, a 1% interest rate would be represented as "0.01".
The name you choose for the Account.
The status of the Account.
A constant representing the object's type. For this resource it will always be account
.
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.
The identifier for the Entity that will own the Account.
The identifier for the Program that this Account falls under. Required if you operate more than one Program.
The identifier of an Entity that, while not owning the Account, is associated with its activity. Its relationship to your group must be informational
.
The name you choose for the Account.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Accounts for those belonging to the specified Entity.
Filter Accounts for those belonging to the specified Entity as informational.
Filter Accounts for those with the specified status.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
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.
The identifier of the Account to update.
The new name of the Account.
The identifier of the Account to retrieve.
The identifier of the Account to retrieve.
The moment to query the balance at. If not set, returns the current balances.
The identifier of the Account to close. The account must have a zero balance.
Each account can have multiple account and routing numbers. We recommend that you use a set per vendor. This is similar to how you use different passwords for different websites. Account numbers can also be used to seamlessly reconcile inbound payments. Generating a unique account number per vendor ensures you always know the originator of an incoming payment.
The identifier for the account this Account Number belongs to.
The account number.
The Account Number identifier.
The ISO 8601 time at which the Account Number was created.
The name you choose for the Account Number.
The American Bankers' Association (ABA) Routing Transit Number (RTN).
This indicates if payments can be made to the Account Number.
Properties related to how this Account Number handles inbound ACH transfers.
Properties related to how this Account Number should handle inbound check withdrawals.
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.
A constant representing the object's type. For this resource it will always be account_number
.
The Account the Account Number should belong to.
The name you choose for the Account Number.
Options related to how this Account Number should handle inbound ACH transfers.
Options related to how this Account Number should handle inbound check withdrawals.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
The status to retrieve Account Numbers for.
The ACH Debit status to retrieve Account Numbers for.
Filter Account Numbers to those belonging to the specified Account.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
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.
The identifier of the Account Number.
The name you choose for the Account Number.
This indicates if transfers can be made to the Account Number.
Options related to how this Account Number handles inbound ACH transfers.
Options related to how this Account Number should handle inbound check withdrawals.
The identifier of the Account Number to retrieve.
Transactions are the immutable additions and removals of money from your bank account. They're the equivalent of line items on your bank statement.
The identifier for the Account the Transaction belongs to.
The Transaction amount in the minor unit of its currency. For dollars, for example, this is cents.
The ISO 4217 code for the Transaction's currency. This will match the currency on the Transaction's Account.
The ISO 8601 date on which the Transaction occurred.
An informational message describing this transaction. Use the fields in source
to get more detailed information. This field appears as the line-item on the statement.
The Transaction identifier.
The identifier for the route this Transaction came through. Routes are things like cards and ACH details.
The type of the route this Transaction came through.
This is an object giving more details on the network-level event that caused the Transaction. Note that for backwards compatibility reasons, additional undocumented keys may appear in this object. These should be treated as deprecated and will be removed in the future.
A constant representing the object's type. For this resource it will always be transaction
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Transactions for those belonging to the specified Account.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
Return results whose value is in the provided list. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
Filter Transactions for those belonging to the specified route. This could be a Card ID or an Account Number ID.
The identifier of the Transaction to retrieve.
Pending Transactions are potential future additions and removals of money from your bank account.
The identifier for the account this Pending Transaction belongs to.
The Pending Transaction amount in the minor unit of its currency. For dollars, for example, this is cents.
The ISO 4217 code for the Pending Transaction's currency. This will match the currency on the Pending Transaction's Account.
The ISO 8601 date on which the Pending Transaction was completed.
The ISO 8601 date on which the Pending Transaction occurred.
For a Pending Transaction related to a transfer, this is the description you provide. For a Pending Transaction related to a payment, this is the description the vendor provides.
The Pending Transaction identifier.
The identifier for the route this Pending Transaction came through. Routes are things like cards and ACH details.
The type of the route this Pending Transaction came through.
This is an object giving more details on the network-level event that caused the Pending Transaction. For example, for a card transaction this lists the merchant's industry and location.
Whether the Pending Transaction has been confirmed and has an associated Transaction.
A constant representing the object's type. For this resource it will always be pending_transaction
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter pending transactions to those belonging to the specified Account.
Filter pending transactions to those belonging to the specified Route.
Filter pending transactions to those caused by the specified source.
Return results whose value is in the provided list. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
Filter Pending Transactions for those with the specified status. By default only Pending Transactions in with status pending
will be returned. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Pending Transaction.
Declined Transactions are refused additions and removals of money from your bank account. For example, Declined Transactions are caused when your Account has an insufficient balance or your Limits are triggered.
The identifier for the Account the Declined Transaction belongs to.
The Declined Transaction amount in the minor unit of its currency. For dollars, for example, this is cents.
The ISO 4217 code for the Declined Transaction's currency. This will match the currency on the Declined Transaction's Account.
The ISO 8601 date on which the Transaction occurred.
This is the description the vendor provides.
The Declined Transaction identifier.
The identifier for the route this Declined Transaction came through. Routes are things like cards and ACH details.
The type of the route this Declined Transaction came through.
This is an object giving more details on the network-level event that caused the Declined Transaction. For example, for a card transaction this lists the merchant's industry and location. Note that for backwards compatibility reasons, additional undocumented keys may appear in this object. These should be treated as deprecated and will be removed in the future.
A constant representing the object's type. For this resource it will always be declined_transaction
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Declined Transactions to ones belonging to the specified Account.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
Filter Declined Transactions to those belonging to the specified route.
Return results whose value is in the provided list. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
The identifier of the Declined Transaction.
Account transfers move funds between your own accounts at Increase.
The account transfer's identifier.
The transfer amount in the minor unit of the destination account currency. For dollars, for example, this is cents.
The Account to which the transfer belongs.
The destination account's identifier.
The ID for the transaction receiving the transfer.
The ISO 8601 date and time at which the transfer was created.
The description that will show on the transactions.
The transfer's network.
The lifecycle status of the transfer.
The ID for the transaction funding the transfer.
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.
If your account requires approvals for transfers and the transfer was approved, this will contain details of the approval.
If your account requires approvals for transfers and the transfer was not approved, this will contain details of the cancellation.
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.
A constant representing the object's type. For this resource it will always be account_transfer
.
The identifier for the account that will send the transfer.
The transfer amount in the minor unit of the account currency. For dollars, for example, this is cents.
The description you choose to give the transfer.
The identifier for the account that will receive the transfer.
Whether the transfer requires explicit approval via the dashboard or API.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Account Transfers to those that originated from the specified Account.
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.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Account Transfer.
The identifier of the Account Transfer to approve.
The identifier of the pending Account Transfer to cancel.
ACH transfers move funds between your Increase account and any other account accessible by the Automated Clearing House (ACH).
The Account to which the transfer belongs.
The destination account number.
Additional information that will be sent to the recipient.
The transfer amount in USD cents. A positive amount indicates a credit transfer pushing funds to the receiving account. A negative amount indicates a debit transfer pulling funds from the receiving account.
The ISO 4217 code for the transfer's currency. For ACH transfers this is always equal to usd
.
If your account requires approvals for transfers and the transfer was approved, this will contain details of the approval.
If your account requires approvals for transfers and the transfer was not approved, this will contain details of the cancellation.
The ISO 8601 date and time at which the transfer was created.
The type of entity that owns the account to which the ACH Transfer is being sent.
The identifier of the External Account the transfer was made to, if any.
The ACH transfer's identifier.
The transfer's network.
If the receiving bank accepts the transfer but notifies that future transfers should use different details, this will contain those details.
If your transfer is returned, this will contain details of the return.
The American Bankers' Association (ABA) Routing Transit Number (RTN).
The descriptor that will show on the recipient's bank statement.
The lifecycle status of the transfer.
After the transfer is submitted to FedACH, this will contain supplemental details. Increase batches transfers and submits a file to the Federal Reserve roughly every 30 minutes. The Federal Reserve processes ACH transfers during weekdays according to their posted schedule.
After the transfer is acknowledged by FedACH, this will contain supplemental details. The Federal Reserve sends an acknowledgement message for each file that Increase submits.
The ID for the transaction funding the transfer.
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.
The description of the date of the transfer.
The data you chose to associate with the transfer.
The description of the transfer you set to be shown to the recipient.
The name by which the recipient knows you.
The type of the account to which the transfer will be sent.
Your identifier for the transfer recipient.
The name of the transfer recipient. This value is information and not verified by the recipient's bank.
The transfer effective date in ISO 8601 format.
The Standard Entry Class (SEC) code to use for the transfer.
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.
A constant representing the object's type. For this resource it will always be ach_transfer
.
The Increase identifier for the account that will send the transfer.
The account number for the destination account.
Additional information that will be sent to the recipient. This is included in the transfer data sent to the receiving bank.
The transfer amount in cents. A positive amount originates a credit transfer pushing funds to the receiving account. A negative amount originates a debit transfer pulling funds from the receiving account.
The description of the date of the transfer, usually in the format YYMMDD
. This is included in the transfer data sent to the receiving bank.
The data you choose to associate with the transfer. This is included in the transfer data sent to the receiving bank.
A description of the transfer. This is included in the transfer data sent to the receiving bank.
The name by which the recipient knows you. This is included in the transfer data sent to the receiving bank.
The type of entity that owns the account to which the ACH Transfer is being sent.
The transfer effective date in ISO 8601 format.
The ID of an External Account to initiate a transfer to. If this parameter is provided, account_number
, routing_number
, and funding
must be absent.
The type of the account to which the transfer will be sent.
Your identifier for the transfer recipient.
The name of the transfer recipient. This value is informational and not verified by the recipient's bank.
Whether the transfer requires explicit approval via the dashboard or API.
The American Bankers' Association (ABA) Routing Transit Number (RTN) for the destination account.
The Standard Entry Class (SEC) code to use for the transfer.
A description you choose to give the transfer. This will be saved with the transfer details, displayed in the dashboard, and returned by the API. If individual_name
and company_name
are not explicitly set by this API, the statement_descriptor
will be sent in those fields to the receiving bank to help the customer recognize the transfer. You are highly encouraged to pass individual_name
and company_name
instead of relying on this fallback.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter ACH Transfers to those that originated from the specified Account.
Filter ACH Transfers to those made to the specified External Account.
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.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the ACH Transfer.
Approves an ACH Transfer in a pending_approval state.
The identifier of the ACH Transfer to approve.
Cancels an ACH Transfer in a pending_approval state.
The identifier of the pending ACH Transfer to cancel.
ACH Prenotifications are one way you can verify account and routing numbers by Automated Clearing House (ACH).
The ACH Prenotification's identifier.
The destination account number.
Additional information for the recipient.
The description of the date of the notification.
Optional data associated with the notification.
The description of the notification.
The name by which you know the company.
If the notification is for a future credit or debit.
The effective date in ISO 8601 format.
The American Bankers' Association (ABA) Routing Transit Number (RTN).
If your prenotification is returned, this will contain details of the return.
If the receiving bank notifies that future transfers should use different details, this will contain those details.
The ISO 8601 date and time at which the prenotification was created.
The lifecycle status of the ACH Prenotification.
A constant representing the object's type. For this resource it will always be ach_prenotification
.
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.
The Increase identifier for the account that will send the transfer.
The account number for the destination account.
Additional information that will be sent to the recipient.
The description of the date of the transfer.
The data you choose to associate with the transfer.
The description of the transfer you wish to be shown to the recipient.
The name by which the recipient knows you.
Whether the Prenotification is for a future debit or credit.
The transfer effective date in ISO 8601 format.
Your identifier for the transfer recipient.
The name of the transfer recipient. This value is information and not verified by the recipient's bank.
The American Bankers' Association (ABA) Routing Transit Number (RTN) for the destination account.
The Standard Entry Class (SEC) code to use for the ACH Prenotification.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
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.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the ACH Prenotification to retrieve.
An Inbound ACH Transfer is an ACH transfer initiated outside of Increase to your account.
The inbound ACH transfer's identifier.
The transfer amount in USD cents.
The Account to which the transfer belongs.
The identifier of the Account Number to which this transfer was sent.
The direction of the transfer.
The status of the transfer.
The name of the company that initiated the transfer.
The descriptive date of the transfer.
The additional information included with the transfer.
The description of the transfer.
The id of the company that initiated the transfer.
The American Banking Association (ABA) routing number of the bank originating the transfer.
The id of the receiver of the transfer.
The name of the receiver of the transfer.
The trace number of the transfer.
The time at which the transfer will be automatically resolved.
Additional information sent from the originator.
If your transfer is accepted, this will contain details of the acceptance.
If your transfer is declined, this will contain details of the decline.
If your transfer is returned, this will contain details of the return.
If you initiate a notification of change in response to the transfer, this will contain its details.
A constant representing the object's type. For this resource it will always be inbound_ach_transfer
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Inbound ACH Tranfers to ones belonging to the specified Account.
Filter Inbound ACH Tranfers to ones belonging to the specified Account Number.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
Filter Inbound ACH Transfers to those with the specified status.
The identifier of the Inbound ACH Transfer to get details for.
The identifier of the Inbound ACH Transfer to decline.
The identifier of the Inbound ACH Transfer to return to the originating financial institution.
The reason why this transfer will be returned. The most usual return codes are payment_stopped
for debits and credit_entry_refused_by_receiver
for credits.
The identifier of the Inbound ACH Transfer for which to create a notification of change.
The updated account number to send in the notification of change.
The updated routing number to send in the notification of change.
Wire transfers move funds between your Increase account and any other account accessible by Fedwire.
The wire transfer's identifier.
The message that will show on the recipient's bank statement.
The transfer amount in USD cents.
The ISO 4217 code for the transfer's currency. For wire transfers this is always equal to usd
.
The destination account number.
The beneficiary's name.
The beneficiary's address line 1.
The beneficiary's address line 2.
The beneficiary's address line 3.
The originator's name.
The originator's address line 1.
The originator's address line 2.
The originator's address line 3.
The Account to which the transfer belongs.
The identifier of the External Account the transfer was made to, if any.
The American Bankers' Association (ABA) Routing Transit Number (RTN).
If your account requires approvals for transfers and the transfer was approved, this will contain details of the approval.
If your account requires approvals for transfers and the transfer was not approved, this will contain details of the cancellation.
If your transfer is reversed, this will contain details of the reversal.
The ISO 8601 date and time at which the transfer was created.
The transfer's network.
The lifecycle status of the transfer.
After the transfer is submitted to Fedwire, this will contain supplemental details.
The ID for the transaction funding the transfer.
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.
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.
A constant representing the object's type. For this resource it will always be wire_transfer
.
The identifier for the account that will send the transfer.
The account number for the destination account.
The American Bankers' Association (ABA) Routing Transit Number (RTN) for the destination account.
The ID of an External Account to initiate a transfer to. If this parameter is provided, account_number
and routing_number
must be absent.
The transfer amount in cents.
The message that will show on the recipient's bank statement.
The beneficiary's name.
The beneficiary's address line 1.
The beneficiary's address line 2.
The beneficiary's address line 3.
The originator's name. This is only necessary if you're transferring from a commingled account. Otherwise, we'll use the associated entity's details.
The originator's address line 1. This is only necessary if you're transferring from a commingled account. Otherwise, we'll use the associated entity's details.
The originator's address line 2. This is only necessary if you're transferring from a commingled account. Otherwise, we'll use the associated entity's details.
The originator's address line 3. This is only necessary if you're transferring from a commingled account. Otherwise, we'll use the associated entity's details.
Whether the transfer requires explicit approval via the dashboard or API.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Wire Transfers to those belonging to the specified Account.
Filter Wire Transfers to those made to the specified External Account.
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.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Wire Transfer.
The identifier of the Wire Transfer to approve.
The identifier of the pending Wire Transfer to cancel.
An Inbound Wire Transfer is a wire transfer initiated outside of Increase to your account.
The inbound wire transfer's identifier.
The amount in USD cents.
The Account to which the transfer belongs.
The identifier of the Account Number to which this transfer was sent.
The status of the transfer.
A free-form address field set by the sender.
A free-form address field set by the sender.
A free-form address field set by the sender.
A name set by the sender.
A free-form reference string set by the sender, to help identify the transfer.
An Increase-constructed description of the transfer.
A unique identifier available to the originating and receiving banks, commonly abbreviated as IMAD. It is created when the wire is submitted to the Fedwire service and is helpful when debugging wires with the originating bank.
The address of the wire originator, set by the sending bank.
The address of the wire originator, set by the sending bank.
The address of the wire originator, set by the sending bank.
The originator of the wire, set by the sending bank.
The American Banking Association (ABA) routing number of the bank originating the transfer.
A free-form message set by the wire originator.
A free-form message set by the wire originator.
A free-form message set by the wire originator.
A free-form message set by the wire originator.
An Increase-created concatenation of the Originator-to-Beneficiary lines.
A constant representing the object's type. For this resource it will always be inbound_wire_transfer
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Inbound Wire Tranfers to ones belonging to the specified Account.
Filter Inbound Wire Tranfers to ones belonging to the specified Account Number.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
Filter Inbound Wire Transfers to those with the specified status.
The identifier of the Inbound Wire Transfer to get details for.
Wire drawdown requests enable you to request that someone else send you a wire. This feature is in beta; reach out to support@increase.com to learn more.
A constant representing the object's type. For this resource it will always be wire_drawdown_request
.
The Wire drawdown request identifier.
The Account Number to which the recipient of this request is being requested to send funds.
The drawdown request's recipient's account number.
The drawdown request's recipient's routing number.
The amount being requested in cents.
The ISO 4217 code for the amount being requested. Will always be "USD".
The message the recipient will see as part of the drawdown request.
The drawdown request's recipient's name.
Line 1 of the drawdown request's recipient's address.
Line 2 of the drawdown request's recipient's address.
Line 3 of the drawdown request's recipient's address.
The originator's name.
The originator's address line 1.
The originator's address line 2.
The originator's address line 3.
After the drawdown request is submitted to Fedwire, this will contain supplemental details.
If the recipient fulfills the drawdown request by sending funds, then this will be the identifier of the corresponding Transaction.
The lifecycle status of the drawdown request.
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.
The Account Number to which the recipient should send funds.
The amount requested from the recipient, in cents.
A message the recipient will see as part of the request.
The drawdown request's recipient's account number.
The drawdown request's recipient's routing number.
The drawdown request's recipient's name.
Line 1 of the drawdown request's recipient's address.
Line 2 of the drawdown request's recipient's address.
Line 3 of the drawdown request's recipient's address.
The drawdown request originator's name. This is only necessary if you're requesting a payment to a commingled account. Otherwise, we'll use the associated entity's details.
The drawdown request originator's address line 1. This is only necessary if you're requesting a payment to a commingled account. Otherwise, we'll use the associated entity's details.
The drawdown request originator's address line 2. This is only necessary if you're requesting a payment to a commingled account. Otherwise, we'll use the associated entity's details.
The drawdown request originator's address line 3. This is only necessary if you're requesting a payment to a commingled account. Otherwise, we'll use the associated entity's details.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Wire Drawdown Requests for those with the specified status.
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.
The identifier of the Wire Drawdown Request to retrieve.
Inbound wire drawdown requests are requests from someone else to send them a wire. This feature is in beta; reach out to support@increase.com to learn more.
A constant representing the object's type. For this resource it will always be inbound_wire_drawdown_request
.
The Wire drawdown request identifier.
The ISO 8601 date and time at which the inbound wire drawdown requested was created.
The Account Number from which the recipient of this request is being requested to send funds.
The drawdown request's originator's account number.
The drawdown request's originator's routing number.
The drawdown request's beneficiary's account number.
The drawdown request's beneficiary's routing number.
The amount being requested in cents.
The ISO 4217 code for the amount being requested. Will always be "USD".
A message from the drawdown request's originator.
Line 1 of the information conveyed from the originator of the message to the beneficiary.
Line 2 of the information conveyed from the originator of the message to the beneficiary.
Line 3 of the information conveyed from the originator of the message to the beneficiary.
Line 4 of the information conveyed from the originator of the message to the beneficiary.
The drawdown request's originator's name.
Line 1 of the drawdown request's originator's address.
Line 2 of the drawdown request's originator's address.
Line 3 of the drawdown request's originator's address.
The drawdown request's beneficiary's name.
Line 1 of the drawdown request's beneficiary's address.
Line 2 of the drawdown request's beneficiary's address.
Line 3 of the drawdown request's beneficiary's address.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
The identifier of the Inbound Wire Drawdown Request to retrieve.
Check Transfers move funds from your Increase account by mailing a physical check.
The identifier of the Account from which funds will be transferred.
The identifier of the Account Number from which to send the transfer and print on the check.
The account number printed on the check.
The routing number printed on the check.
The check number printed on the check.
Whether Increase will print and mail the check or if you will do it yourself.
Details relating to the physical check that Increase will print and mail. Will be present if and only if fulfillment_method
is equal to physical_check
.
Details relating to the custom fulfillment you will perform. Will be present if and only if fulfillment_method
is equal to third_party
.
The transfer amount in USD cents.
The ISO 8601 date and time at which the transfer was created.
If your account requires approvals for transfers and the transfer was approved, this will contain details of the approval.
If your account requires approvals for transfers and the transfer was not approved, this will contain details of the cancellation.
The Check transfer's identifier.
If the check has been mailed by Increase, this will contain details of the shipment.
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.
The lifecycle status of the transfer.
After the transfer is submitted, this will contain supplemental details.
After a stop-payment is requested on the check, this will contain supplemental details.
If the Check Transfer was successfully deposited, this will contain the identifier of the Inbound Check Deposit object with details of the deposit.
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.
A constant representing the object's type. For this resource it will always be check_transfer
.
The identifier for the account that will send the transfer.
The identifier of the Account Number from which to send the transfer and print on the check.
Whether Increase will print and mail the check or if you will do it yourself.
Details relating to the physical check that Increase will print and mail. This is required if fulfillment_method
is equal to physical_check
. It must not be included if any other fulfillment_method
is provided.
Details relating to the custom fulfillment you will perform. This is required if fulfillment_method
is equal to third_party
. It must not be included if any other fulfillment_method
is provided.
The transfer amount in cents.
Whether the transfer requires explicit approval via the dashboard or API.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Check Transfers to those that originated from the specified Account.
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.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Check Transfer.
The identifier of the Check Transfer to approve.
The identifier of the pending Check Transfer to cancel.
The identifier of the Check Transfer.
The reason why this transfer should be stopped.
Inbound Check Deposits are records of third-parties attempting to deposit checks against your account.
The deposit's identifier.
The deposited amount in the minor unit of the destination account currency. For dollars, for example, this is cents.
The ISO 8601 date and time at which the deposit was attempted.
The status of the Inbound Check Deposit.
The Account the check is being deposited against.
The Account Number the check is being deposited against.
If this deposit is for an existing Check Transfer, the identifier of that Check Transfer.
The ID for the File containing the image of the front of the check.
The ID for the File containing the image of the back of the check.
If the deposit attempt has been accepted, the identifier of the Transaction object created as a result of the successful deposit.
If the deposit attempt has been rejected, the identifier of the Declined Transaction object created as a result of the failed deposit.
If the Inbound Check Deposit was accepted, the ISO 8601 date and time at which this took place.
If the Inbound Check Deposit was declined, the ISO 8601 date and time at which this took place.
The American Bankers' Association (ABA) Routing Transit Number (RTN) for the bank depositing this check. In some rare cases, this is not transmitted via Check21 and the value will be null.
The check number printed on the check being deposited.
A constant representing the object's type. For this resource it will always be inbound_check_deposit
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Inbound Check Deposits to those belonging to the specified Account.
Filter Inbound Check Deposits to those belonging to the specified Check Transfer.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Inbound Check Deposit to get details for.
The identifier of the Inbound Check Deposit to decline.
Real-Time Payments transfers move funds, within seconds, between your Increase account and any other account on the Real-Time Payments network.
A constant representing the object's type. For this resource it will always be real_time_payments_transfer
.
The Real-Time Payments Transfer's identifier.
If your account requires approvals for transfers and the transfer was approved, this will contain details of the approval.
If your account requires approvals for transfers and the transfer was not approved, this will contain details of the cancellation.
The lifecycle status of the transfer.
The ISO 8601 date and time at which the transfer was created.
The Account from which the transfer was sent.
The identifier of the External Account the transfer was made to, if any.
The Account Number the recipient will see as having sent the transfer.
The name of the party on whose behalf the creditor is receiving the payment.
The name of the the party on whose behalf the debtor is instructing the payment.
The name of the transfer's sender. If not provided, the account's entity name will be used.
The name of the transfer's recipient as provided by the sender.
Unstructured information that will show on the recipient's bank statement.
The transfer amount in USD cents.
The ISO 4217 code for the transfer's currency. For real-time payments transfers this is always equal to USD
.
The destination account number.
The destination American Bankers' Association (ABA) Routing Transit Number (RTN).
The Transaction funding the transfer once it is complete.
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.
After the transfer is submitted to Real-Time Payments, this will contain supplemental details.
If the transfer is rejected by Real-Time Payments or the destination financial institution, this will contain supplemental details.
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.
The identifier of the Account Number from which to send the transfer.
The destination account number.
The destination American Bankers' Association (ABA) Routing Transit Number (RTN).
The ID of an External Account to initiate a transfer to. If this parameter is provided, destination_account_number
and destination_routing_number
must be absent.
The transfer amount in USD cents. For Real-Time Payments transfers, must be positive.
The name of the the party on whose behalf the debtor is instructing the payment.
The name of the party on whose behalf the creditor is receiving the payment.
The name of the transfer's sender. If not provided, the account's entity name will be used.
The name of the transfer's recipient.
Unstructured information that will show on the recipient's bank statement.
Whether the transfer requires explicit approval via the dashboard or API.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Real-Time Payments Transfers to those belonging to the specified Account.
Filter Real-Time Payments Transfers to those made to the specified External Account.
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.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Real-Time Payments Transfer.
Check Deposits allow you to deposit images of paper checks into your account.
The deposit's identifier.
The deposited amount in the minor unit of the destination account currency. For dollars, for example, this is cents.
The ISO 8601 date and time at which the transfer was created.
The status of the Check Deposit.
The Account the check was deposited into.
The ID for the File containing the image of the front of the check.
The ID for the File containing the image of the back of the check.
The ID for the Transaction created by the deposit.
If your deposit is successfully parsed and accepted by Increase, this will contain details of the parsed check.
After the check is parsed, it is submitted to the Check21 network for processing. This will contain details of the submission.
If your deposit is rejected by Increase, this will contain details as to why it was rejected.
If your deposit is returned, this will contain details as to why it was returned.
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.
A constant representing the object's type. For this resource it will always be check_deposit
.
The identifier for the Account to deposit the check in.
The deposit amount in the minor unit of the account currency. For dollars, for example, this is cents.
The currency to use for the deposit.
The File containing the check's front image.
The File containing the check's back image.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Check Deposits to those belonging to the specified Account.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
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.
The identifier of the Check Deposit to retrieve.
Cards are commercial credit cards. They'll immediately work for online purchases after you create them. All cards maintain a credit limit of 100% of the Account’s available balance at the time of transaction. Funds are deducted from the Account upon transaction settlement.
The card identifier.
The identifier for the account this card belongs to.
The identifier for the entity associated with this card.
The ISO 8601 date and time at which the Card was created.
The card's description for display purposes.
The last 4 digits of the Card's Primary Account Number.
The month the card expires in M format (e.g., August is 8).
The year the card expires in YYYY format (e.g., 2025).
This indicates if payments can be made with the card.
The Card's billing address.
The contact information used in the two-factor steps for digital wallet card creation. At least one field must be present to complete the digital wallet steps.
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.
A constant representing the object's type. For this resource it will always be card
.
The Account the card should belong to.
The Entity the card belongs to. You only need to supply this in rare situations when the card is not for the Account holder.
The description you choose to give the card.
The card's billing address.
The contact information used in the two-factor steps for digital wallet card creation. To add the card to a digital wallet, you may supply an email or phone number with this request. Otherwise, subscribe and then action a Real Time Decision with the category digital_wallet_token_requested
or digital_wallet_authentication_requested
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Cards to ones belonging to the specified Account.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
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.
The identifier of the Card to retrieve details for.
The card identifier.
The description you choose to give the card.
The status to update the Card with.
The Entity the card belongs to. You only need to supply this in rare situations when the card is not for the Account holder.
The card's updated billing address.
The contact information used in the two-factor steps for digital wallet card creation. At least one field must be present to complete the digital wallet steps.
The identifier of the Card.
Card Payments group together interactions related to a single card payment, such as an authorization and its corresponding settlement.
The Card Payment identifier.
The ISO 8601 time at which the Card Payment was created.
The identifier for the Account the Transaction belongs to.
The Card identifier for this payment.
The interactions related to this card payment.
The summarized state of this card payment.
A constant representing the object's type. For this resource it will always be card_payment
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Card Payments to ones belonging to the specified Account.
Filter Card Payments to ones belonging to the specified Card.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Card Payment.
Additional information about a card purchase (e.g., settlement or refund), such as level 3 line item data.
The Card Purchase Supplement identifier.
The ID of the transaction.
The ID of the Card Payment this transaction belongs to.
Invoice-level information about the payment.
Line item information, such as individual products purchased.
A constant representing the object's type. For this resource it will always be card_purchase_supplement
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Card Purchase Supplements to ones belonging to the specified Card Payment.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Card Purchase Supplement.
If unauthorized activity occurs on a card, you can create a Card Dispute and we'll return the funds if appropriate.
The Card Dispute identifier.
Why you disputed the Transaction in question.
The results of the Dispute investigation.
The ISO 8601 date and time at which the Card Dispute was created.
The identifier of the Transaction that was disputed.
If the Card Dispute's status is accepted
, this will contain details of the successful dispute.
If the Card Dispute's status is rejected
, this will contain details of the unsuccessful dispute.
A constant representing the object's type. For this resource it will always be card_dispute
.
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.
The Transaction you wish to dispute. This Transaction must have a source_type
of card_settlement
.
Why you are disputing this Transaction.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
Filter Card Disputes for those with the specified status or statuses. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
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.
The identifier of the Card Dispute.
Custom physical Visa cards that are shipped to your customers. The artwork is configurable by a connected Card Profile. The same Card can be used for multiple Physical Cards. Printing cards incurs a fee. Please contact support@increase.com for pricing!
The physical card identifier.
The identifier for the Card this Physical Card represents.
The Physical Card Profile used for this Physical Card.
The ISO 8601 date and time at which the Physical Card was created.
The status of the Physical Card.
Details about the cardholder, as it appears on the printed card.
The details used to ship this physical card.
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.
A constant representing the object's type. For this resource it will always be physical_card
.
The underlying card representing this physical card.
The physical card profile to use for this physical card. The latest default physical card profile will be used if not provided.
Details about the cardholder, as it will appear on the physical card.
The details used to ship this physical card.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Physical Cards to ones belonging to the specified Card.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
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.
The Physical Card identifier.
The status to update the Physical Card to.
The identifier of the Physical Card.
This contains artwork and metadata relating to a Card's appearance in digital wallet apps like Apple Pay and Google Pay. For more information, see our guide on digital card artwork.
The Card Profile identifier.
The ISO 8601 date and time at which the Card Dispute was created.
The status of the Card Profile.
A description you can use to identify the Card Profile.
Whether this Digital Card Profile is the default for all cards in its Increase group.
The Card's text color, specified as an RGB triple.
A user-facing description for whoever is issuing the card.
A user-facing description for the card itself.
A website the user can visit to view and receive support for their card.
An email address the user can contact to receive support for their card.
A phone number the user can contact to receive support for their card.
The identifier of the File containing the card's front image.
The identifier of the File containing the card's icon image.
A constant representing the object's type. For this resource it will always be digital_card_profile
.
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.
A description you can use to identify the Card Profile.
The Card's text color, specified as an RGB triple. The default is white.
A user-facing description for whoever is issuing the card.
A user-facing description for the card itself.
A website the user can visit to view and receive support for their card.
An email address the user can contact to receive support for their card.
A phone number the user can contact to receive support for their card.
The identifier of the File containing the card's front image.
The identifier of the File containing the card's icon image.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Digital Card Profiles for those with the specified digital wallet status or statuses. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
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.
The identifier of the Digital Card Profile.
The identifier of the Digital Card Profile to archive.
The identifier of the Digital Card Profile to clone.
A description you can use to identify the Card Profile.
The Card's text color, specified as an RGB triple. The default is white.
A user-facing description for whoever is issuing the card.
A user-facing description for the card itself.
A website the user can visit to view and receive support for their card.
An email address the user can contact to receive support for their card.
A phone number the user can contact to receive support for their card.
The identifier of the File containing the card's front image.
The identifier of the File containing the card's icon image.
This contains artwork and metadata relating to a Physical Card's appearance. For more information, see our guide on physical card artwork.
The Card Profile identifier.
The ISO 8601 date and time at which the Card Dispute was created.
The status of the Physical Card Profile.
A description you can use to identify the Physical Card Profile.
Whether this Physical Card Profile is the default for all cards in its Increase group.
The creator of this Physical Card Profile.
A phone number the user can contact to receive support for their card.
The identifier of the File containing the physical card's front image.
The identifier of the File containing the physical card's back image.
The identifier of the File containing the physical card's carrier image.
A constant representing the object's type. For this resource it will always be physical_card_profile
.
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.
A description you can use to identify the Card Profile.
A phone number the user can contact to receive support for their card.
The identifier of the File containing the physical card's front image.
The identifier of the File containing the physical card's carrier image.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Physical Card Profiles for those with the specified statuses. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
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.
The identifier of the Card Profile.
The identifier of the Physical Card Profile to archive.
The identifier of the Physical Card Profile to clone.
A description you can use to identify the Card Profile.
A phone number the user can contact to receive support for their card.
The identifier of the File containing the physical card's front image.
The identifier of the File containing the physical card's carrier image.
Text printed on the front of the card. Reach out to support@increase.com for more information.
A Digital Wallet Token is created when a user adds a Card to their Apple Pay or Google Pay app. The Digital Wallet Token can be used for purchases just like a Card.
The Digital Wallet Token identifier.
The identifier for the Card this Digital Wallet Token belongs to.
The ISO 8601 date and time at which the Card was created.
This indicates if payments can be made with the Digital Wallet Token.
The digital wallet app being used.
A constant representing the object's type. For this resource it will always be digital_wallet_token
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Digital Wallet Tokens to ones belonging to the specified Card.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Digital Wallet Token.
Entities are the legal entities that own accounts. They can be people, corporations, partnerships, or trusts.
The entity's identifier.
The entity's legal structure.
Details of the corporation entity. Will be present if structure
is equal to corporation
.
Details of the natural person entity. Will be present if structure
is equal to natural_person
.
Details of the joint entity. Will be present if structure
is equal to joint
.
Details of the trust entity. Will be present if structure
is equal to trust
.
A constant representing the object's type. For this resource it will always be entity
.
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.
The entity's description for display purposes.
The status of the entity.
The ISO 8601 time at which the Entity's details were most recently confirmed.
The ISO 8601 time at which the Entity was created.
Additional documentation associated with the entity. This is limited to the first 10 documents for an entity. If an entity has more than 10 documents, use the GET /entity_supplemental_documents list endpoint to retrieve them.
The type of Entity to create.
Details of the corporation entity to create. Required if structure
is equal to corporation
.
Details of the natural person entity to create. Required if structure
is equal to natural_person
. Natural people entities should be submitted with social_security_number
or individual_taxpayer_identification_number
identification methods.
Details of the joint entity to create. Required if structure
is equal to joint
.
Details of the trust entity to create. Required if structure
is equal to trust
.
The description you choose to give the entity.
Additional documentation associated with the entity.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Entities for those with the specified status or statuses. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
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.
The identifier of the Entity to retrieve.
The identifier of the Entity to archive.
The entity's physical address. Mail receiving locations like PO Boxes and PMB's are disallowed.
The identifier of the Entity to archive. Any accounts associated with an entity must be closed before the entity can be archived.
The identifier of the Entity to retrieve.
The identifying details of anyone controlling or owning 25% or more of the corporation.
The individual's physical address. Mail receiving locations like PO Boxes and PMB's are disallowed.
The identifier of the Entity to associate with the new Beneficial Owner.
The identifying details of anyone controlling or owning 25% or more of the corporation.
The identifier of the Entity to retrieve.
The identifying details of anyone controlling or owning 25% or more of the corporation.
The identifier of the Entity to update. This endpoint only accepts corporation
entities.
The North American Industry Classification System (NAICS) code for the corporation's primary line of business. This is a number, like 5132
for Software Publishers
. A full list of classification codes is available here.
Depending on your program, you may be required to re-confirm an Entity's details on a recurring basis. After making any required updates, call this endpoint to record that your user confirmed their details.
The identifier of the Entity to confirm the details of.
When your user confirmed the Entity's details. If not provided, the current time will be used.
Supplemental Documents are uploaded files connected to an Entity during onboarding.
The File containing the document.
The ISO 8601 time at which the Supplemental Document was created.
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.
A constant representing the object's type. For this resource it will always be entity_supplemental_document
.
The identifier of the Entity to associate with the supplemental document.
The identifier of the File containing the document.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
The identifier of the Entity to list supplemental documents for.
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.
Programs determine the compliance and commercial terms of Accounts. By default, you have a Commercial Banking program for managing your own funds. If you are lending or managing funds on behalf of your customers, or otherwise engaged in regulated activity, we will work together to create additional Programs for you.
The name of the Program.
The ISO 8601 time at which the Program was created.
The ISO 8601 time at which the Program was last updated.
The Program identifier.
The Program billing account.
A constant representing the object's type. For this resource it will always be program
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
The identifier of the Program to retrieve.
A request for proof of authorization for one or more ACH debit transfers.
The Proof of Authorization Request identifier.
The time the Proof of Authorization Request was created.
The time the Proof of Authorization Request was last updated.
The time the Proof of Authorization Request is due.
The ACH Transfers associated with the request.
A constant representing the object's type. For this resource it will always be proof_of_authorization_request
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Proof of Authorization Request.
Information submitted in response to a proof of authorization request. Per Nacha's guidance on proof of authorization, the originator must ensure that the authorization complies with applicable legal requirements, is readily identifiable as an authorization, and has clear and readily understandable terms.
The Proof of Authorization Request Submission identifier.
The time the Proof of Authorization Request Submission was created.
The time the Proof of Authorization Request Submission was last updated.
Name of the authorizer.
Email of the authorizer.
Company of the authorizer.
IP address of the authorizer.
Time of authorization.
Terms of authorization.
ID of the proof of authorization request.
Status of the proof of authorization request submission.
Whether account ownership was validated with microdeposit.
Whether account ownership was validated with an account statement.
Whether account ownership was validated via credential (for instance, Plaid).
Whether the customer has been offboarded.
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.
A constant representing the object's type. For this resource it will always be proof_of_authorization_request_submission
.
ID of the proof of authorization request.
Email of the authorizer.
Name of the authorizer.
IP address of the authorizer.
Company of the authorizer.
Whether the customer has been offboarded or suspended.
Whether the account ownership was validated with a microdeposit.
Whether the account ownership was validated with an account statement.
Whether the account ownership was validated via credential (e.g. Plaid).
Terms of authorization.
Time of authorization.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
ID of the proof of authorization request.
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.
The identifier of the Proof of Authorization Request Submission.
Events are records of things that happened to objects at Increase. Events are accessible via the List Events endpoint and can be delivered to your application via webhooks. For more information, see our webhooks guide.
The identifier of the object that generated this Event.
The type of the object that generated this Event.
The category of the Event. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully.
The time the Event was created.
The Event identifier.
A constant representing the object's type. For this resource it will always be event
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
Filter Events for those with the specified category or categories. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
Filter Events to those belonging to the object with the provided identifier.
The identifier of the Event.
Webhooks are event notifications we send to you by HTTPS POST requests. Event Subscriptions are how you configure your application to listen for them. You can create an Event Subscription through your developer dashboard or the API. For more information, see our webhooks guide.
The event subscription identifier.
The time the event subscription was created.
This indicates if we'll send notifications to this subscription.
If specified, this subscription will only receive webhooks for Events with the specified category
.
If specified, this subscription will only receive webhooks for Events associated with this OAuth Connection.
The webhook url where we'll send notifications.
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.
A constant representing the object's type. For this resource it will always be event_subscription
.
The URL you'd like us to send webhooks to.
The key that will be used to sign webhooks. If no value is passed, a random string will be used as default.
If specified, this subscription will only receive webhooks for Events with the specified category
.
If specified, this subscription will only receive webhooks for Events associated with the specified OAuth Connection.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
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.
The identifier of the Event Subscription.
The status to update the Event Subscription with.
The identifier of the Event Subscription.
Real Time Decisions are created when your application needs to take action in real-time to some event such as a card authorization. For more information, see our Real-Time Decisions guide.
The Real-Time Decision identifier.
The ISO 8601 date and time at which the Real-Time Decision was created.
The ISO 8601 date and time at which your application can no longer respond to the Real-Time Decision.
The status of the Real-Time Decision.
The category of the Real-Time Decision.
Fields related to a card authorization.
Fields related to a digital wallet token provisioning attempt.
Fields related to a digital wallet authentication attempt.
A constant representing the object's type. For this resource it will always be real_time_decision
.
The identifier of the Real-Time Decision.
If the Real-Time Decision relates to a card authorization attempt, this object contains your response to the authorization.
If the Real-Time Decision relates to a digital wallet token provisioning attempt, this object contains your response to the attempt.
If the Real-Time Decision relates to a digital wallet authentication attempt, this object contains your response to the authentication.
The identifier of the Real-Time Decision.
Routing numbers are used to identify your bank in a financial transaction.
The name of the financial institution belonging to a routing number.
The nine digit routing number identifier.
A constant representing the object's type. For this resource it will always be routing_number
.
This routing number's support for ACH Transfers.
This routing number's support for Real-Time Payments Transfers.
This routing number's support for Wire Transfers.
You can use this API to confirm if a routing number is valid, such as when a user is providing you with bank account details. Since routing numbers uniquely identify a bank, this will always return 0 or 1 entry. In Sandbox, the only valid routing number for this method is 110000000.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter financial institutions by routing number.
External Accounts represent accounts at financial institutions other than Increase. You can use this API to store their details for reuse.
The External Account's identifier.
The ISO 8601 date and time at which the External Account was created.
The External Account's description for display purposes.
The External Account's status.
The American Bankers' Association (ABA) Routing Transit Number (RTN).
The destination account number.
The type of the account to which the transfer will be sent.
The type of entity that owns the External Account.
If you have verified ownership of the External Account.
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.
A constant representing the object's type. For this resource it will always be external_account
.
The American Bankers' Association (ABA) Routing Transit Number (RTN) for the destination account.
The account number for the destination account.
The type of the destination account. Defaults to checking
.
The type of entity that owns the External Account.
The name you choose for the Account.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter External Accounts for those with the specified status or statuses. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
Filter External Accounts to those with the specified Routing Number.
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.
The external account identifier.
The description you choose to give the external account.
The type of entity that owns the External Account.
The status of the External Account.
The funding type of the External Account.
The identifier of the External Account.
Account Statements are generated monthly for every active Account. You can access the statement's data via the API or retrieve a PDF with its details via its associated File.
The Account Statement identifier.
The identifier for the Account this Account Statement belongs to.
The ISO 8601 time at which the Account Statement was created.
The identifier of the File containing a PDF of the statement.
The ISO 8601 time representing the start of the period the Account Statement covers.
The ISO 8601 time representing the end of the period the Account Statement covers.
The Account's balance at the start of its statement period.
The Account's balance at the start of its statement period.
A constant representing the object's type. For this resource it will always be account_statement
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Account Statements to those belonging to the specified Account.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Account Statement to retrieve.
Files are objects that represent a file hosted on Increase's servers. The file may have been uploaded by you (for example, when uploading a check image) or it may have been created by Increase (for example, an autogenerated statement PDF).
The time the File was created.
The File's identifier.
What the File will be used for. We may add additional possible values for this enum over time; your application should be able to handle such additions gracefully.
A description of the File.
Whether the File was generated by Increase or by you and sent to Increase.
The MIME type of the file.
The filename that was provided upon upload or generated by Increase.
A URL from where the File can be downloaded at this point in time. The location of this URL may change over time.
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.
A constant representing the object's type. For this resource it will always be file
.
To upload a file to Increase, you'll need to send a request of Content-Type multipart/form-data
. The request should contain the file you would like to upload, as well as the parameters for creating a file.
The file contents. This should follow the specifications of RFC 7578 which defines file transfers for the multipart/form-data protocol.
The description you choose to give the File.
What the File will be used for in Increase's systems.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
Filter Files for those with the specified purpose or purposes. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
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.
The identifier of the File.
Increase generates certain documents / forms automatically for your application; they can be listed here. Currently the only supported document type is IRS Form 1099-INT.
The Document identifier.
The type of document.
The ISO 8601 time at which the Document was created.
The identifier of the Entity the document was generated for.
The identifier of the File containing the Document's contents.
A constant representing the object's type. For this resource it will always be document
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Documents to ones belonging to the specified Entity.
Filter Documents for those with the specified category or categories. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
The identifier of the Document to retrieve.
Exports are batch summaries of your Increase data. You can make them from the API or dashboard. Since they can take a while, they are generated asynchronously. We send a webhook when they are ready. For more information, please read our Exports documentation.
The Export identifier.
The time the Export was created.
The category of the Export. We may add additional possible values for this enum over time; your application should be able to handle that gracefully.
The status of the Export.
The File containing the contents of the Export. This will be present when the Export's status transitions to complete
.
A URL at which the Export's file can be downloaded. This will be present when the Export's status transitions to complete
.
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.
A constant representing the object's type. For this resource it will always be export
.
The type of Export to create.
Options for the created export. Required if category
is equal to transaction_csv
.
Options for the created export. Required if category
is equal to balance_csv
.
Options for the created export. Required if category
is equal to bookkeeping_account_balance_csv
.
Options for the created export. Required if category
is equal to account_statement_ofx
.
Options for the created export. Required if category
is equal to entity_csv
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
Filter Exports for those with the specified category or categories. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
Filter Exports for those with the specified status or statuses. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
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.
The identifier of the Export to retrieve.
Accounts are T-accounts. They can store accounting entries. Your compliance setup might require annotating money movements using this API. Learn more in our guide to Bookkeeping.
The account identifier.
The compliance category of the account.
The API Account associated with this bookkeeping account.
The Entity associated with this bookkeeping account.
The name you choose for the account.
A constant representing the object's type. For this resource it will always be bookkeeping_account
.
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.
The account compliance category.
The entity, if compliance_category
is customer_balance
.
The entity, if compliance_category
is commingled_cash
.
The name you choose for the account.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
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.
The bookkeeping account you would like to update.
The name you choose for the account.
The identifier of the Bookkeeping Account to retrieve.
The moment to query the balance at. If not set, returns the current balances.
Entry Sets are accounting entries that are transactionally applied. Your compliance setup might require annotating money movements using this API. Learn more in our guide to Bookkeeping.
The entry set identifier.
The transaction identifier, if any.
The timestamp of the entry set.
The entries.
When the entry set was created.
A constant representing the object's type. For this resource it will always be bookkeeping_entry_set
.
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.
The date of the transaction. Optional if transaction_id
is provided, in which case we use the date
of that transaction. Required otherwise.
The identifier of the Transaction related to this entry set, if any.
The bookkeeping entries.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter to the Bookkeeping Entry Set that maps to this Transaction.
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.
The identifier of the Bookkeeping Entry Set.
Entries are T-account entries recording debits and credits. Your compliance setup might require annotating money movements using this API. Learn more in our guide to Bookkeeping.
The identifier for the Account the Entry belongs to.
The Entry amount in the minor unit of its currency. For dollars, for example, this is cents.
The identifier for the Account the Entry belongs to.
The entry identifier.
When the entry set was created.
A constant representing the object's type. For this resource it will always be bookkeeping_entry
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
The identifier of the Bookkeeping Entry.
Groups represent organizations using Increase. You can retrieve information about your own organization via the API, or (more commonly) OAuth platforms can retrieve information about the organizations that have granted them access.
If the Group is activated or not.
If the Group is allowed to create ACH debits.
The ISO 8601 time at which the Group was created.
The Group identifier.
A constant representing the object's type. For this resource it will always be group
.
Returns details for the currently authenticated Group.
When a user authorizes your OAuth application, an OAuth Connection object is created. Learn more about OAuth here.
The OAuth Connection's identifier.
The ISO 8601 timestamp when the OAuth Connection was created.
The identifier of the Group that has authorized your OAuth application.
Whether the connection is active.
The ISO 8601 timestamp when the OAuth Connection was deleted.
A constant representing the object's type. For this resource it will always be oauth_connection
.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter to OAuth Connections by their status. By default, return only the active
ones. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
The identifier of the OAuth Connection.
A token that is returned to your application when a user completes the OAuth flow and may be used to authenticate requests. Learn more about OAuth here.
You may use this token in place of an API key to make OAuth requests on a user's behalf.
The type of OAuth token.
A constant representing the object's type. For this resource it will always be oauth_token
.
The public identifier for your application.
The secret that confirms you own the application. This is redundent given that the request is made with your API key but it's a required component of OAuth 2.0.
The credential you request in exchange for the code. In Production, this is always authorization_code
. In Sandbox, you can pass either enum value.
The authorization code generated by the user and given to you as a query parameter.
The production token you want to exchange for a sandbox token. This is only available in Sandbox. Set grant_type
to production_token
to use this parameter.
IntraFi is a network of financial institutions that allows Increase users to sweep funds to multiple banks, in addition to Increase's main bank partners. This enables accounts to become eligible for additional Federal Deposit Insurance Corporation (FDIC) insurance. An Intrafi Account Enrollment object represents the status of an account in the network. Sweeping an account to IntraFi doesn't affect funds availability.
The identifier of this enrollment at IntraFi.
The identifier of the Increase Account being swept into the network.
The status of the account in the network. An account takes about one business day to go from pending_enrolling
to enrolled
.
The identifier of the account in IntraFi's system. This identifier will be printed on any IntraFi statements or documents.
A constant representing the object's type. For this resource it will always be intrafi_account_enrollment
.
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.
The identifier for the account to be added to IntraFi.
The contact email for the account owner, to be shared with IntraFi.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter IntraFi Account Enrollments to the one belonging to an account.
Filter IntraFi Account Enrollments for those with the specified status or statuses. For GET requests, this should be encoded as a comma-delimited string, such as ?in=one,two,three
.
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.
The identifier of the IntraFi Account Enrollment to retrieve.
The Identifier of the IntraFi Account Enrollment to remove from IntraFi.
When using IntraFi, each account's balance over the standard FDIC insurance amount are swept to various other institutions. Funds are rebalanced across banks as needed once per business day.
The date this balance reflects.
The total balance, in minor units of currency
. Increase reports this balance to IntraFi daily.
Each entry represents a balance held at a different bank. IntraFi separates the total balance across many participating banks in the network.
A constant representing the object's type. For this resource it will always be intrafi_balance
.
The identifier of the Account to get balances for.
Certain institutions may be excluded per Entity when sweeping funds into the IntraFi network. This is useful when an Entity already has deposits at a particular bank, and does not want to sweep additional funds to it. It may take 5 business days for an exclusion to be processed.
The identifier of this exclusion request.
When this was exclusion was submitted to IntraFi by Increase.
When this was exclusion was confirmed by IntraFi.
The name of the excluded institution.
The Federal Deposit Insurance Corporation's certificate number for the institution.
The entity for which this institution is excluded.
The status of the exclusion request.
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.
A constant representing the object's type. For this resource it will always be intrafi_exclusion
.
The identifier of the Entity whose deposits will be excluded.
The name of the financial institution to be excluded.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter IntraFi Exclusions for those belonging to the specified Entity.
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.
The identifier of the IntraFi Exclusion to retrieve.
The identifier of the IntraFi Exclusion request to archive. It may take 5 business days for an exclusion removal to be processed. Removing an exclusion does not guarantee that funds will be swept to the previously-excluded bank.
When building your application, you can use these APIs to simulate external effects. They can be helpful to quickly test events that might take several hours in the real world (like receiving a wire or ACH). These APIs will only work in the sandbox. If you have a sandbox Event Subscription configured, calling these APIs will also result in the appropriate webhooks being sent to your endpoint.
If your account is configured to require approval for each transfer, this endpoint simulates the approval of an Account Transfer. You can also approve sandbox Account Transfers in the dashboard. This transfer must first have a status
of pending_approval
.
The identifier of the Account Transfer you wish to complete.
Simulates an inbound ACH transfer to your account. This imitates initiating a transfer to an Increase account from a different financial institution. The transfer may be either a credit or a debit depending on if the amount
is positive or negative. The result of calling this API will contain the created transfer. You can pass a resolve_at
parameter to allow for a window to action on the Inbound ACH Transfer. Alternatively, if you don't pass the resolve_at
parameter the result will contain either a Transaction or a Declined Transaction depending on whether or not the transfer is allowed.
The identifier of the Account Number the inbound ACH Transfer is for.
The transfer amount in cents. A positive amount originates a credit transfer pushing funds to the receiving account. A negative amount originates a debit transfer pulling funds from the receiving account.
The description of the date of the transfer.
Data associated with the transfer set by the sender.
The description of the transfer set by the sender.
The name of the sender.
The ID of the receiver of the transfer.
The name of the receiver of the transfer.
The sender's company ID.
The time at which the transfer should be resolved. If not provided will resolve immediately.
Simulates the submission of an ACH Transfer to the Federal Reserve. This transfer must first have a status
of pending_approval
or pending_submission
. In production, Increase submits ACH Transfers to the Federal Reserve three times per day on weekdays. Since sandbox ACH Transfers are not submitted to the Federal Reserve, this endpoint allows you to skip that delay and transition the ACH Transfer to a status of submitted
.
The identifier of the ACH Transfer you wish to submit.
Simulates the return of an ACH Transfer by the Federal Reserve due to an error condition. This will also create a Transaction to account for the returned funds. This transfer must first have a status
of submitted
.
The identifier of the ACH Transfer you wish to return.
The reason why the Federal Reserve or destination bank returned this transfer. Defaults to no_account
.
Simulates receiving a Notification of Change for an ACH Transfer.
The identifier of the ACH Transfer you wish to create a notification of change for.
The reason for the notification of change.
The corrected data for the notification of change (e.g., a new routing number).
Simulates the mailing of a Check Transfer, which happens once per weekday in production but can be sped up in sandbox. This transfer must first have a status
of pending_approval
or pending_submission
.
The identifier of the Check Transfer you wish to mail.
Simulates an Inbound Check Deposit against your account. This imitates someone depositing a check at their bank that was issued from your account. It may or may not be associated with a Check Transfer. Increase will evaluate the Check Deposit as we would in production and either create a Transaction or a Declined Transaction as a result. You can inspect the resulting Inbound Check Deposit object to see the result.
The identifier of the Account Number the Inbound Check Deposit will be against.
The check amount in cents.
The check number on the check to be deposited.
Simulates the submission of a Check Deposit to the Federal Reserve. This Check Deposit must first have a status
of pending
.
The identifier of the Check Deposit you wish to submit.
Simulates the rejection of a Check Deposit by Increase due to factors like poor image quality. This Check Deposit must first have a status
of pending
.
The identifier of the Check Deposit you wish to reject.
Simulates the return of a Check Deposit. This Check Deposit must first have a status
of submitted
.
The identifier of the Check Deposit you wish to return.
Simulates an inbound Wire Transfer to your account.
The identifier of the Account Number the inbound Wire Transfer is for.
The transfer amount in cents. Must be positive.
The sending bank will set beneficiary_address_line1 in production. You can simulate any value here.
The sending bank will set beneficiary_address_line2 in production. You can simulate any value here.
The sending bank will set beneficiary_address_line3 in production. You can simulate any value here.
The sending bank will set beneficiary_name in production. You can simulate any value here.
The sending bank will set beneficiary_reference in production. You can simulate any value here.
The sending bank will set originator_address_line1 in production. You can simulate any value here.
The sending bank will set originator_address_line2 in production. You can simulate any value here.
The sending bank will set originator_address_line3 in production. You can simulate any value here.
The sending bank will set originator_name in production. You can simulate any value here.
The sending bank will set originator_routing_number in production. You can simulate any value here.
The sending bank will set originator_to_beneficiary_information_line1 in production. You can simulate any value here.
The sending bank will set originator_to_beneficiary_information_line2 in production. You can simulate any value here.
The sending bank will set originator_to_beneficiary_information_line3 in production. You can simulate any value here.
The sending bank will set originator_to_beneficiary_information_line4 in production. You can simulate any value here.
Simulates the submission of a Wire Transfer to the Federal Reserve. This transfer must first have a status
of pending_approval
or pending_creating
.
The identifier of the Wire Transfer you wish to submit.
Simulates the reversal of a Wire Transfer by the Federal Reserve due to error conditions. This will also create a Transaction to account for the returned funds. This Wire Transfer must first have a status
of complete
.
The identifier of the Wire Transfer you wish to reverse.
Simulates receiving an Inbound Wire Drawdown Request.
The Account Number to which the recipient of this request is being requested to send funds from.
The drawdown request's originator's account number.
The drawdown request's originator's routing number.
The drawdown request's beneficiary's account number.
The drawdown request's beneficiary's routing number.
The amount being requested in cents.
The ISO 4217 code for the amount being requested. Will always be "USD".
A message from the drawdown request's originator.
Line 1 of the information conveyed from the originator of the message to the beneficiary.
Line 2 of the information conveyed from the originator of the message to the beneficiary.
Line 3 of the information conveyed from the originator of the message to the beneficiary.
Line 4 of the information conveyed from the originator of the message to the beneficiary.
The drawdown request's originator's name.
Line 1 of the drawdown request's originator's address.
Line 2 of the drawdown request's originator's address.
Line 3 of the drawdown request's originator's address.
The drawdown request's beneficiary's name.
Line 1 of the drawdown request's beneficiary's address.
Line 2 of the drawdown request's beneficiary's address.
Line 3 of the drawdown request's beneficiary's address.
Simulates an inbound Real-Time Payments transfer to your account. Real-Time Payments are a beta feature.
The identifier of the Account Number the inbound Real-Time Payments Transfer is for.
The transfer amount in USD cents. Must be positive.
The identifier of a pending Request for Payment that this transfer will fulfill.
The name provided by the sender of the transfer.
The account number of the account that sent the transfer.
The routing number of the account that sent the transfer.
Additional information included with the transfer.
This endpoint simulates immediately releasing an inbound funds hold, which might be created as a result of e.g., an ACH debit.
The inbound funds hold to release.
Simulates submission of a Real-Time Payments transfer and handling the response from the destination financial institution. This transfer must first have a status
of pending_submission
.
The identifier of the Real-Time Payments Transfer you wish to complete.
If set, the simulation will reject the transfer.
Simulates a purchase authorization on a Card. Depending on the balance available to the card and the amount
submitted, the authorization activity will result in a Pending Transaction of type card_authorization
or a Declined Transaction of type card_decline
. You can pass either a Card id or a Digital Wallet Token id to simulate the two different ways purchases can be made.
The authorization amount in cents.
The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with.
The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with.
The merchant descriptor of the merchant the card is transacting with.
The city the merchant resides in.
The country the merchant resides in.
The identifier of the Card to be authorized.
The identifier of the Physical Card to be authorized.
The identifier of the Digital Wallet Token to be authorized.
The identifier of the Event Subscription to use. If provided, will override the default real time event subscription. Because you can only create one real time decision event subscription, you can use this field to route events to any specified event subscription for testing purposes.
Simulates the settlement of an authorization by a card acquirer. After a card authorization is created, the merchant will eventually send a settlement. This simulates that event, which may occur many days after the purchase in production. The amount settled can be different from the amount originally authorized, for example, when adding a tip to a restaurant bill.
The identifier of the Card to create a settlement on.
The identifier of the Pending Transaction for the Card Authorization you wish to settle.
The amount to be settled. This defaults to the amount of the Pending Transaction being settled.
Simulates the reversal of an authorization by a card acquirer. An authorization can be partially reversed multiple times, up until the total authorized amount. Marks the pending transaction as complete if the authorization is fully reversed.
The identifier of the Card Payment to create a reversal on.
The amount of the reversal in minor units in the card authorization's currency. This defaults to the authorization amount.
Simulates the increment of an authorization by a card acquirer. An authorization can be incremented multiple times.
The identifier of the Card Payment to create a increment on.
The amount of the increment in minor units in the card authorization's currency.
The identifier of the Event Subscription to use. If provided, will override the default real time event subscription. Because you can only create one real time decision event subscription, you can use this field to route events to any specified event subscription for testing purposes.
Simulates expiring a card authorization immediately.
The identifier of the Card Payment to expire.
Simulates the fuel confirmation of an authorization by a card acquirer. This happens asynchronously right after a fuel pump transaction is completed. A fuel confirmation can only happen once per authorization.
The identifier of the Card Payment to create a fuel_confirmation on.
The amount of the fuel_confirmation in minor units in the card authorization's currency.
Simulates refunding a card transaction. The full value of the original sandbox transaction is refunded.
The identifier for the Transaction to refund. The Transaction's source must have a category of card_settlement.
After a Card Dispute is created in production, the dispute will be reviewed. Since no review happens in sandbox, this endpoint simulates moving a Card Dispute into a rejected or accepted state. A Card Dispute can only be actioned one time and must have a status of pending_reviewing
.
The dispute you would like to action.
The status to move the dispute to.
Why the dispute was rejected. Not required for accepting disputes.
Simulates a user attempting add a Card to a digital wallet such as Apple Pay.
The identifier of the Card to be authorized.
This endpoint allows you to simulate advancing the shipment status of a Physical Card, to simulate e.g., that a physical card was attempted shipped but then failed delivery.
The Physical Card you would like to action.
The shipment status to move the Physical Card to.
Simulates an interest payment to your account. In production, this happens automatically on the first of each month.
The identifier of the Account Number the Interest Payment is for.
The interest amount in cents. Must be positive.
The start of the interest period. If not provided, defaults to the current time.
The end of the interest period. If not provided, defaults to the current time.
Simulates an Account Statement being created for an account. In production, Account Statements are generated once per month.
The identifier of the Account the statement is for.
Simulates an tax document being created for an account.
The identifier of the Account the tax document is for.
Simulates a program being created in your group. By default, your group has one program called Commercial Banking. Note that when your group operates more than one program, program_id
is a required field when creating accounts.
The name of the program being added.
Real-Time Payments transfers move funds, within seconds, between your Increase account and any other account on the Real-Time Payments network. A request for payment is a request to the receiver to send funds to your account. The permitted uses of Requests For Payment are limited by the Real-Time Payments network to business-to-business payments and transfers between two accounts at different banks owned by the same individual. Please contact support@increase.com to enable this API for your team.
A constant representing the object's type. For this resource it will always be real_time_payments_request_for_payment
.
The Real-Time Payments Request for Payment's identifier.
The lifecycle status of the request for payment.
The ISO 8601 date and time at which the request for payment was created.
The Account Number in which a successful transfer will arrive.
The name of the recipient the sender is requesting a transfer from.
Unstructured information that will show on the recipient's bank statement.
The expiration time for this request, in UTC. The requestee will not be able to pay after this date.
The transfer amount in USD cents.
The ISO 4217 code for the transfer's currency. For real-time payments transfers this is always equal to USD
.
The account number the request is sent to.
The receiver's American Bankers' Association (ABA) Routing Transit Number (RTN).
The transaction that fulfilled this request.
After the request for payment is submitted to Real-Time Payments, this will contain supplemental details.
If the request for payment is rejected by Real-Time Payments or the destination financial institution, this will contain supplemental details.
If the request for payment is refused by the destination financial institution or the receiving customer, this will contain supplemental details.
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.
The identifier of the Account Number where the funds will land.
The account number the funds will be requested from.
The requestee's American Bankers' Association (ABA) Routing Transit Number (RTN).
The requested amount in USD cents. Must be positive.
Details of the person being requested to pay.
Unstructured information that will show on the requestee's bank statement.
The expiration time for this request, in UTC. The requestee will not be able to pay after this date.
Return the page of entries after this one.
Limit the size of the list that is returned. The default (and maximum) is 100 objects.
Filter Real-Time Payments Request for Payments to those destined to the specified Account.
Return results after this ISO 8601 timestamp.
Return results before this ISO 8601 timestamp.
Return results on or after this ISO 8601 timestamp.
Return results on or before this ISO 8601 timestamp.
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.
The identifier of the Real-Time Payments Request for Payment.