You may update any hearing that is eligible for changes by submitting a Comma-Separated Values (CSV) file with the file name and fields explained below.

Excel files (XLS, XLSX, XLSB) files can be used in place of CSV files. We caution the use of these because they often have hidden formatting or formulas that can cause issues. The CSV avoids that by moving everything to raw text.

Import

The file name must start with UPDATE_ in order to signal the system that this is an update request. A suggested file name might be UPDATE_YYMMDDHHMMSS.csv, where YYMMDDHHMMSS is a timestamp that you create.

Fields

Column Name	Required	Type	Length	Notes

Column Name	Required	Type	Length	Notes
locator	Yes*	String	6	When the hearing is created, we assign a six-character locator to every hearing to uniquely identify it in our system. You can use the fileNumber if you don't know the locator. Leave the locator field empty in this case.
fileNumber	Yes*	String	-	If you don't know the locator, you can use the file number that you scheduled the hearing with. We will find the next hearing with this file number in the future and use that one. If you provide the locator, you do not need to provide the fileNumber as we will defer the lookup to the locator.
*Please note: You are required to provide either the locator or the file number. Providing both is ideal, but, at the very least, you are must provide one or the other.
instructions	No	String	2048	The existing instructions will be replaced entirely by the data provided unless the column "append" is set to true.
comments	No	String	2048	The existing comments will be replaced entirely by the data provided unless the column "append" is set to true.
append	No	Boolean		Defaults to false if not present. This value specifies the mode for updates to instructions and comments. If true, the new value will be appended. If false, the new value will be overwritten. The setting works for both fields in the row. If you wish to append on comments but overwrite on instructions or vice versa, you will need to create two rows for that hearing and specify the values separately.
dateServed	No	Date		Formatted as "yyyy-MM-dd" or "M/d/yyyy"
balance	No	Decimal		The total balance of what the defendant owes your client, including principal, interest, costs, fees, etc.
interest	No	Decimal		The amount of interest incurred.
principal	No	Decimal		Principal balance of costs owed.
attorneyCosts	No	Decimal		The attorney fees being asked for.
courtCosts	No	Decimal		The total of the court costs owed.
miscCosts	No	Decimal		Any additional costs that need to be communicated.
isTelephonic	No	Boolean		Use "TRUE" to indicate the hearing is remote/telephonic. The hearing can't be updated to telephonic if the hearing is already covered.
url	No	String		The url for telephonic/remote hearings.
telephonicMethod	No	String		The remote method, i.e. Zoom, CourtCall, etc.
coverageInstructions	No	String		Telephonic/remote details, i.e. meeting ID, etc.
telephonicPhone	No	String		Phone number for telephonic hearings.

Sample

Download a sample file here.

Transfer

You can use one of the following methods to transfer the file to Docketly.

Batch Upload

Visit https://docketly.com/hearing/upload to send us the file.

Secure File Transfer Protocol (SFTP)

This file may only be submitted via Secure File Transport Protocol (SFTP). It should be placed in the "incoming" directory.

Client Handbook

EDI - Hearing Update