action increase_list_inbound_ach_transfer_returns {
  label: "List Inbound ACH Transfer Returns"
  provider: increase
  method: GET
  path: "/inbound_ach_transfer_returns"
  encoding: json
  input: {
    type: "object"
    properties: {
      cursor: {
        type: "string"
        description: "Return the page of entries after this one."
      }
      limit: {
        type: "integer"
        description: "Limit the size of the list that is returned. The default (and maximum) is 100 objects."
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "A list of Inbound ACH Transfer Return objects"
    required: ["data", "next_cursor"]
    properties: {
      data: {
        type: "array"
        description: "The contents of the list."
        items: {
          type: "object"
          description: "If unauthorized activity occurs via ACH, you can create an Inbound ACH Transfer Return and we'll reverse the transaction. You can create an Inbound ACH Transfer return the first two days after receiving an Inbound ACH Transfer."
          required: ["id", "inbound_ach_transfer_transaction_id", "transaction_id", "status", "reason", "submission", "type"]
          properties: {
            id: {
              type: "string"
              description: "The ID of the Inbound ACH Transfer Return."
            }
            inbound_ach_transfer_transaction_id: {
              type: "string"
              description: "The ID for the Transaction that is being returned."
            }
            reason: {
              type: "string"
              description: "The reason why this transfer will be returned. This is sent to the initiating bank."
              enum: ["authorization_revoked_by_customer", "payment_stopped", "customer_advised_unauthorized_improper_ineligible_or_incomplete", "representative_payee_deceased_or_unable_to_continue_in_that_capacity", "beneficiary_or_account_holder_deceased", "credit_entry_refused_by_receiver", "duplicate_entry", "corporate_customer_advised_not_authorized"]
            }
            status: {
              type: "string"
              description: "The lifecycle status of the transfer."
              enum: ["pending_submitting", "submitted"]
            }
            submission: {
              type: "object"
              description: "After the return is submitted to FedACH, this will contain supplemental details."
              required: ["trace_number", "submitted_at"]
              properties: {
                submitted_at: {
                  type: "string"
                  format: "date-time"
                  description: "When the ACH transfer return was sent to FedACH."
                }
                trace_number: {
                  type: "string"
                  description: "The trace number for the submission."
                }
              }
            }
            transaction_id: {
              type: "string"
              description: "The ID for the transaction refunding the transfer."
            }
            type: {
              type: "string"
              description: "A constant representing the object's type. For this resource it will always be `inbound_ach_transfer_return`."
              enum: ["inbound_ach_transfer_return"]
            }
          }
        }
      }
      next_cursor: {
        type: "string"
        description: "A pointer to a place in the list."
      }
    }
  }
}