List ACH Transfers

Changed on
get/ach_transfers

Request

  • Base URL
    https://api.increase.com
  • URL
    https://api.increase.com/ach_transfers
  • Auth
    HTTP bearer

Query parameters

cursorstring

Return the page of entries after this one.

limitinteger

Limit the size of the list that is returned. The default (and maximum) is 100 objects.

account_idstring

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

external_account_idstring

Filter ACH Transfers to those made to the specified External Account.

idempotency_keystring

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.

status.instring[]

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.

created_at.afterstring date-time

Return results after this ISO 8601 timestamp.

created_at.beforestring date-time

Return results before this ISO 8601 timestamp.

created_at.on_or_afterstring date-time

Return results on or after this ISO 8601 timestamp.

created_at.on_or_beforestring date-time

Return results on or before this ISO 8601 timestamp.

Response

ACH Transfer List

next_cursorstring nullable required

A pointer to a place in the list. Pass this as the cursor parameter to retrieve the next page of results. If there are no more results, the value will be null.

Example response

{
  "data": [
    {
      "account_id": "account_in71c4amph0vgo2qllky",
      "account_number": "987654321",
      "acknowledgement": {
        "acknowledged_at": "2020-01-31T14:15:00Z"
      },
      "addenda": null,
      "amount": 100,
      "approval": {
        "approved_at": "2020-01-31T14:05:00Z",
        "approved_by": null
      },
      "cancellation": null,
      "company_descriptive_date": null,
      "company_discretionary_data": null,
      "company_entry_description": null,
      "company_id": "1234987601",
      "company_name": "National Phonograph Company",
      "created_at": "2020-01-31T14:00:00Z",
      "created_by": {
        "category": "user",
        "user": {
          "email": "user@example.com"
        }
      },
      "currency": "USD",
      "destination_account_holder": "business",
      "external_account_id": "external_account_ukk55lr923a3ac0pp7iv",
      "funding": "checking",
      "id": "ach_transfer_uoxatyh3lt5evrsdvo7q",
      "idempotency_key": null,
      "inbound_funds_hold": null,
      "individual_id": null,
      "individual_name": "Ian Crease",
      "network": "ach",
      "notifications_of_change": [],
      "pending_transaction_id": null,
      "preferred_effective_date": {
        "date": null,
        "settlement_schedule": "same_day"
      },
      "return": {
        "addenda_information": null,
        "created_at": "2020-02-03T11:00:00Z",
        "raw_return_reason_code": "R01",
        "return_reason_code": "insufficient_fund",
        "trace_number": "111122223292834",
        "transaction_id": "transaction_a4fhzo4hjxckcn1b49px",
        "transfer_id": "ach_transfer_uoxatyh3lt5evrsdvo7q"
      },
      "routing_number": "101050001",
      "settlement": {
        "settled_at": "2020-01-31T18:00:00Z"
      },
      "standard_entry_class_code": "corporate_credit_or_debit",
      "statement_descriptor": "Statement descriptor",
      "status": "returned",
      "submission": {
        "administrative_returns_expected_by": "2020-02-04T11:00:00Z",
        "effective_date": "2020-01-31",
        "expected_funds_settlement_at": "2020-01-31T18:00:00Z",
        "expected_settlement_schedule": "same_day",
        "submitted_at": "2020-01-31T14:10:00Z",
        "trace_number": "058349238292834"
      },
      "transaction_id": "transaction_uyrp7fld2ium70oa7oi",
      "type": "ach_transfer"
    }
  ],
  "next_cursor": "v57w5d"
}

Changes

  • df2b1ead4c49Revision changes
    • breaking

      for the query request parameter limit, default value 100 was added

  • 64a92a8cc343Revision changes
    • breaking

      removed the required property //// from the response with the status

    • warning

      added the new loan enum value to the // response property for the response status

    • info

      added subschema #8 subschema #10 to the /// response property anyOf list for the response status

    • info

      added subschema #8 subschema #10 to the /// response property anyOf list for the response status

    • info

      removed subschema #8 subschema #10 from the /// response property anyOf list for the response status

    • info

      removed subschema #8 subschema #10 from the /// response property anyOf list for the response status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status