---
updatedAt: 2026-09-28T18:10:27.000Z
agentTools:
  projectIndex: https://docs.helix.q2.com/llms.txt
---

# Set transaction available date

Modify the `availableDate` for an ACH transaction forward or backward within the configurable maximum allowed hold days from transaction creation. The new `availableDate` is set to midnight on the provided date in the bank's timezone. Maximum allowed hold days represents business days.

<Callout icon="🚧" theme="warn">
  <strong style={{ display: "block" }}>Warning</strong>
  Use of this endpoint requires approval from Q2 and your bank of record.
</Callout>

#### Error Codes

<details>
  <summary>Click to expand</summary>

| Code    | Message (en-US)                                       | Notes                                            |
| :------ | :---------------------------------------------------- | :----------------------------------------------- |
| 1-60000 | Any "Common Error Code" may occur.                    | See [Common Error Codes](https://docs.helix.q2.com/reference/common-error-codes) |
| 60001   | Customer id {0} is invalid.                           |                                                  |
| 60002   | Customer id {0} is inactive.                          |                                                  |
| 60003   | Customer id {0} is not in verified status.            |                                                  |
| 60004   | Customer id {0} is locked.                            |                                                  |
| 60005   | Customer id {0} is marked as deceased.                |                                                  |
| 63502   | Customer does not have read access to account id {0}. |                                                  |
| 160300  | Available Date is required.                           |                                                  |
| 160301  | Transaction Id is required.                           |                                                  |
| 160302  | Customer Id is required.                              |                                                  |
| 160303  | Invalid Transaction Id.                               |                                                  |
| 160304  | Invalid transaction type.                             |                                                  |
| 160305  | Transaction is already available.                     |                                                  |
| 160306  | Available Date is invalid.                            |                                                  |
| 160307  | Available Date exceeds maximum allowed hold days.     |                                                  |
| 160308  | availableDate must occur after settledDate            |                                                  |

</details>

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Helix API",
    "version": "3.0.0",
    "description": "Helix Public API (no customer KYC/IDV). **This spec covers all of Helix 3.x and is subject to change at any time.**"
  },
  "servers": [
    {
      "url": "https://sandbox-api.helix.q2.com",
      "description": "Sandbox server"
    },
    {
      "url": "https://api.helix.q2.com",
      "description": "Production server"
    }
  ],
  "tags": [
    {
      "name": "Card",
      "description": "Endpoints for the card object"
    },
    {
      "name": "Transaction",
      "description": "Endpoints for the transaction object"
    }
  ],
  "security": [
    {
      "basicAuth": []
    }
  ],
  "paths": {
    "/card/lock": {
      "post": {
        "tags": [
          "Card"
        ],
        "summary": "Lock a card",
        "description": "Lock a card. Most locks can be reversed by calling [/card/unlock](https://docs.helix.q2.com/reference/cardunlock). Please check the [/card/unlock](https://docs.helix.q2.com/reference/cardunlock) documentation to see which lock scenarios can be subsequently unlocked. Will apply a `lockTypeCode` of `CST` on success and all card-based transactions will fail.",
        "externalDocs": {
          "url": "https://docs.helix.q2.com/reference/cardlock"
        },
        "operationId": "cardLock",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "customerId",
                  "cardId",
                  "lockReasonTypeCode"
                ],
                "properties": {
                  "customerId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "cardId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "lockReasonTypeCode": {
                    "type": "string",
                    "enum": [
                      "UNK",
                      "FRD",
                      "DMG",
                      "TMP"
                    ],
                    "description": "- `UNK`: Unknown\n- `FRD`: Fraud\n- `DMG`: Physical Damage\n- `TMP`: Temporary\n"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "An <a href=\"https://docs.helix.q2.com/reference/response-format\" target=\"_blank\">envelope</a> whose data node is a <a href=\"https://docs.helix.q2.com/docs/card\" target=\"_blank\">card</a> object",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CardObject200Response"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "$ref": "#/components/schemas/HelixId"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "example": "b75a96f8-2fbc-4b14-9ba4-7b06aa431c9d"
                    },
                    "status": {
                      "type": "integer",
                      "enum": [
                        400
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "integer",
                            "enum": [
                              50401
                            ]
                          },
                          "message": {
                            "type": "string",
                            "example": "User is not authorized"
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "enum": [
                        "00000000-0000-0000-0000-000000000000"
                      ]
                    },
                    "status": {
                      "type": "integer",
                      "enum": [
                        401
                      ]
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "integer",
                            "enum": [
                              50404
                            ]
                          },
                          "message": {
                            "type": "string",
                            "example": "The requested resource 'https://sandbox-api.helix.q2.com/customer/updat/805592' was not found"
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "example": "b75a96f8-2fbc-4b14-9ba4-7b06aa431c9d"
                    },
                    "status": {
                      "type": "integer",
                      "enum": [
                        404
                      ]
                    }
                  }
                }
              }
            }
          },
          "405": {
            "description": "HTTP Method Not Allowed",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "integer",
                            "enum": [
                              50405
                            ]
                          },
                          "message": {
                            "type": "string",
                            "example": "The HTTP method 'POST' for requested resource 'https://sandbox-api.helix.q2.com/customer/get/805594' is not allowed."
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "enum": [
                        "00000000-0000-0000-0000-000000000000"
                      ]
                    },
                    "status": {
                      "type": "integer",
                      "enum": [
                        405
                      ]
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate Limit Exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "integer",
                            "enum": [
                              50429
                            ]
                          },
                          "message": {
                            "type": "string",
                            "example": "Rate limit exceeded"
                          }
                        }
                      }
                    },
                    "requestId": {
                      "type": "string",
                      "enum": [
                        "00000000-0000-0000-0000-000000000000"
                      ]
                    },
                    "status": {
                      "type": "integer",
                      "enum": [
                        429
                      ]
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/transaction/setAvailableDate": {
      "post": {
        "tags": [
          "Transaction"
        ],
        "summary": "Set transaction available date",
        "description": "Modify the `availableDate` for an ACH transaction forward or backward within the configurable maximum allowed hold days from transaction creation. The new `availableDate` is set to midnight on the provided date in the bank's timezone. Maximum allowed hold days represents business days.",
        "externalDocs": {
          "url": "https://docs.helix.q2.com/reference/transactionsetavailabledate"
        },
        "operationId": "transactionSetAvailableDate",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "customerId",
                  "transactionId",
                  "availableDate"
                ],
                "properties": {
                  "customerId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "transactionId": {
                    "$ref": "#/components/schemas/AccountClose200Response/allOf/1/properties/data/properties/transactionId"
                  },
                  "availableDate": {
                    "type": "string",
                    "format": "date",
                    "description": "Format is YYYY-MM-DD"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "An <a href=\"https://docs.helix.q2.com/reference/response-format\" target=\"_blank\">envelope</a> whose data node is a <a href=\"https://docs.helix.q2.com/docs/transaction\" target=\"_blank\">transaction</a> object",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransactionObject200Response"
                }
              }
            }
          },
          "400": {
            "$ref": "#/paths/~1card~1lock/post/responses/400"
          },
          "401": {
            "$ref": "#/paths/~1card~1lock/post/responses/401"
          },
          "404": {
            "$ref": "#/paths/~1card~1lock/post/responses/404"
          },
          "405": {
            "$ref": "#/paths/~1card~1lock/post/responses/405"
          },
          "429": {
            "$ref": "#/paths/~1card~1lock/post/responses/429"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AccountClose200Response": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CardArray200Response/allOf/0"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "properties": {
                  "customerId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "accountId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "closeToAccountId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "transactionId": {
                    "type": "integer",
                    "format": "int64",
                    "minimum": 1
                  },
                  "transactionTag": {
                    "$ref": "#/components/schemas/TagProperty"
                  },
                  "closingBalanceAmount": {
                    "type": "number",
                    "format": "decimal"
                  },
                  "interestPaidAmount": {
                    "type": "number",
                    "format": "decimal"
                  },
                  "totalClosingAmount": {
                    "type": "number",
                    "format": "decimal"
                  },
                  "isClosedToExternalAccount": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        ]
      },
      "CardArray200Response": {
        "allOf": [
          {
            "type": "object",
            "properties": {
              "errors": {
                "type": "array",
                "items": {},
                "example": []
              },
              "requestId": {
                "type": "string",
                "example": "1249a3bf-aca1-40dd-9fba-2a3193550c39"
              },
              "status": {
                "type": "integer",
                "enum": [
                  200
                ]
              },
              "throttle": {
                "type": "object",
                "properties": {
                  "periodEndsAt": {
                    "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                  },
                  "periodLengthInSeconds": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "periodRequestLimit": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "requestsRemainingInPeriod": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "warningThreshold": {
                    "type": "number",
                    "format": "decimal",
                    "example": 0.2
                  }
                }
              }
            }
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/CardObject200Response/allOf/1/properties/data"
                }
              }
            }
          }
        ]
      },
      "CustomerSetLastContact200Response": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CardArray200Response/allOf/0"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "customerId": {
                      "$ref": "#/components/schemas/HelixId"
                    },
                    "dormancyStatus": {
                      "type": "string",
                      "enum": [
                        "Active",
                        "Inactive",
                        "Dormant"
                      ]
                    },
                    "lastContactDate": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2021-01-07T19:00:59.761-06:00"
                    },
                    "lastContactType": {
                      "$ref": "#/components/schemas/LastContactType"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "TransactionObject200Response": {
        "allOf": [
          {
            "$ref": "#/components/schemas/CardArray200Response/allOf/0"
          },
          {
            "type": "object",
            "properties": {
              "data": {
                "type": "object",
                "properties": {
                  "accountId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "amount": {
                    "type": "number",
                    "format": "decimal"
                  },
                  "availableDate": {
                    "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                  },
                  "cardId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "cardMerchantInfo": {
                    "type": "object",
                    "properties": {
                      "merchantCity": {
                        "type": "string",
                        "maxLength": 13
                      },
                      "merchantCountryCode": {
                        "type": "string",
                        "maxLength": 2
                      },
                      "merchantGroupcode": {
                        "type": "string",
                        "maxLength": 6
                      },
                      "merchantId": {
                        "type": "string",
                        "maxLength": 15
                      },
                      "merchantLocation": {
                        "type": "string",
                        "maxLength": 23
                      },
                      "merchantStateCode": {
                        "type": "string",
                        "maxLength": 2
                      },
                      "merchantZipCode": {
                        "type": "string",
                        "maxLength": 9
                      }
                    }
                  },
                  "check": {
                    "type": "object",
                    "properties": {
                      "checkAmount": {
                        "type": "number",
                        "format": "decimal"
                      },
                      "checkImages": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "downloadUrl": {
                              "type": "string"
                            },
                            "imageType": {
                              "type": "string",
                              "enum": [
                                "CheckFront",
                                "CheckBack",
                                "ReturnCheckFront",
                                "ReturnCheckBack"
                              ]
                            }
                          }
                        }
                      },
                      "checkNumber": {
                        "$ref": "#/components/schemas/AccountClose200Response/allOf/1/properties/data/properties/transactionId"
                      },
                      "holdCode": {
                        "type": "string"
                      },
                      "holdCodeDescription": {
                        "type": "string"
                      },
                      "payerAccountNumberMasked": {
                        "type": "string"
                      },
                      "payerInstitutionDescription": {
                        "type": "string"
                      },
                      "payerRoutingNumber": {
                        "type": "string"
                      },
                      "returnReason": {
                        "type": "string"
                      },
                      "returnReasonCode": {
                        "type": "string"
                      }
                    }
                  },
                  "createdDate": {
                    "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                  },
                  "customerId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "customField1": {
                    "type": "string"
                  },
                  "depositAvailability": {
                    "type": "object",
                    "properties": {
                      "availabilityAmounts": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "availableDate": {
                              "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                            },
                            "effectiveAvailableDate": {
                              "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                            },
                            "isReleased": {
                              "type": "boolean"
                            },
                            "overrideAvailableDate": {
                              "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                            },
                            "releaseAmount": {
                              "type": "number",
                              "format": "decimal"
                            },
                            "releasedDate": {
                              "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                            },
                            "remainingAmount": {
                              "type": "number",
                              "format": "decimal"
                            }
                          }
                        }
                      },
                      "availabilityCode": {
                        "type": "string"
                      },
                      "totalReleasedAmount": {
                        "type": "number",
                        "format": "decimal"
                      },
                      "totalRemainingAmount": {
                        "type": "number",
                        "format": "decimal"
                      }
                    }
                  },
                  "description": {
                    "type": "string"
                  },
                  "feeCode": {
                    "type": "string",
                    "enum": [
                      "ACH",
                      "DAF",
                      "IAF",
                      "ICF",
                      "NSF",
                      "RGD",
                      "RTN"
                    ]
                  },
                  "feeDescription": {
                    "type": "string"
                  },
                  "friendlyDescription": {
                    "type": "string"
                  },
                  "institutionName": {
                    "type": "string"
                  },
                  "isCredit": {
                    "type": "boolean"
                  },
                  "isEarlyDirectDeposit": {
                    "type": "boolean"
                  },
                  "isSameDaySettle": {
                    "type": "boolean"
                  },
                  "masterId": {
                    "$ref": "#/components/schemas/AccountClose200Response/allOf/1/properties/data/properties/transactionId"
                  },
                  "nachaDescription": {
                    "type": "string",
                    "deprecated": true
                  },
                  "nachaInfo": {
                    "type": "object",
                    "properties": {
                      "companyDiscretionaryData": {
                        "type": "string"
                      },
                      "companyEntryDescription": {
                        "type": "string"
                      },
                      "companyIdentification": {
                        "type": "string"
                      },
                      "companyName": {
                        "type": "string"
                      },
                      "isEarlyDeposit": {
                        "type": "boolean"
                      },
                      "nachaSettledDate": {
                        "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                      },
                      "standardEntryClassCode": {
                        "type": "string"
                      }
                    }
                  },
                  "purposeCode": {
                    "$ref": "#/components/schemas/PurposeCode"
                  },
                  "requestingCustomerId": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "returnCode": {
                    "type": "string"
                  },
                  "runningAccountBalance": {
                    "type": "number",
                    "format": "decimal"
                  },
                  "settledDate": {
                    "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                  },
                  "statementDate": {
                    "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "Initiated",
                      "Pending",
                      "Settled",
                      "Voided"
                    ]
                  },
                  "subType": {
                    "type": "string"
                  },
                  "subTypeCode": {
                    "type": "string"
                  },
                  "tag": {
                    "$ref": "#/components/schemas/TagProperty"
                  },
                  "transactionCount": {
                    "$ref": "#/components/schemas/HelixId"
                  },
                  "transactionId": {
                    "$ref": "#/components/schemas/AccountClose200Response/allOf/1/properties/data/properties/transactionId"
                  },
                  "type": {
                    "type": "string"
                  },
                  "typeCode": {
                    "type": "string"
                  },
                  "voidedDate": {
                    "$ref": "#/components/schemas/CustomerSetLastContact200Response/allOf/1/properties/data/items/properties/lastContactDate"
                  }
                }
              }
            }
          }
        ]
      },
      "HelixId": {
        "type": "integer",
        "format": "int32",
        "minimum": 1
      },
      "TagProperty": {
        "type": "string",
        "maxLength": 50
      },
      "PurposeCode": {
        "type": "string",
        "maxLength": 10,
        "pattern": "^[0-9][A-Z][a-z]$"
      }
    },
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "x-samples-languages": [
    "curl",
    "node",
    "python",
    "csharp",
    "ruby",
    "go",
    "java",
    "kotlin",
    "php"
  ]
}
```