API Documentation v3

Introduction

Welcome to the Assure API. Version 3 of the API focuses on the addition of case and case file options.


Timestamps returned by requests are in the 24 hour format and use the current Central timezone (UTC-6 during CST and UTC-5 during CDT).


Authorization

Our API makes use of OAuth 2 using client credentials. If you are interested in using this service, please contact us at api@myassureservices.com. We will need your account login email and a list of endpoints you would like to use.

Example Request

We recommend you use an established OAuth library to authenticate with our API. How ever it is quite simple even with out a library.

1. Make a POST request to https://app.myassureservices.com/oauth/access_token containing the following variables:

  • grant_type = client_credentials
  • client_id = <your client id>
  • client_secret = <your client secret>
2. You will get a response back containing information. If the request failed the reason why will be returned to you. If your credentials are correct you will get a response back containing the following:
  • access_token = <generated access token>
  • token_type = Bearer
  • expires_in = 3600
3. Now that you have an access_token you can make requests to the API. If you wanted to view details for a hearing you send a GET request to the /api/v3/hearing/{hearing id} API endpoint with the following header information:
  • Authorization: Bearer <generated access token>
4. Keep in mind that your access token is only valid for the number of seconds contained in the expires_in variable that is returned to you in your authentication request. Keeping track of when your access_token expires is where a library can come in handy. You can use the same access token for all request until it expires.

Parameter Type Information

boolean: A boolean value will be a 1 or 0. 1 = true, 0 = false. When sending us data you should use a 1 or a 0 to represent boolean values.

association: An association can be an array containing arrays with a data model fields or a single array containing all data model fields depending on the endpoint. An association may also be an empty value when no association is present.

empty values: A value of "null", "{}" or an empty string ("") should all be considered as no value present.


Endpoints

Attorneys

view

Show details related to an attorney in our system.

list

Returns an array containing available attorneys in our system.

Briefs

view

Show details related to a brief request in our system.

list

Returns an array containing available brief requests in our system.

CaseFiles

view

Show details for case files connected to a case. Returns a collection containing both the Exhibited and All version of case files if present.


Parameters

download-check

Send a request to check the ERE and download available case files. A case may only have one of each type of case file attached to it. If a case file is already attached you will get an error back, please use the update-check endpoint to check for updates. This API endpoint may have longer response times than usual. Sometimes one or more status reports will have to be downloaded to verify the claimant can be found on the ERE in order to automatically select the correct credentials to use. If you encounter request timeouts please increase your request timeout to 120 or more seconds for these API requests to allow for multiple status reports to be downloaded from the ERE when required.


Parameters

update-check

Send a request to trigger an update to check the ERE for any changes for a case file.


Parameters

download

Send a request to download a case file. A case file is available for download when the file_id field is set, you should use the view endpoint to check if a case file is available for download.


Parameters


Returns

When the method of download is set to base64 the data field of the response will contain the below fields.

Cases

create

Create a new case that is in the State Agency status. A credential ID is required to be able to pull case files.


Parameters

update

Update an existing case in our system.


Parameters

list

Returns an array containing available cases.


Filters

view

Show details for a case.

DocPreHearingChecklists

view

Show details related to a pre-hearing checklist in our system.

DocTypes

view

Show details related to a doc type in our system.

list

Returns an array containing available document types in our system.

EreFiles

create

Uploads a file to our system, attaches it to a case and puts it in the queue to be uploaded to the ERE. Sending a file with this API endpoint does not guarantee the file will be uploaded to the ERE. You must subscribe to our webhooks or check the file with the view endpoint to see the current status of the file. Most files will be uploaded within a few minutes. When a ERE file has a tracking_number and a status of 4 it can be considered successfully uploaded to the ERE.

File Restrictions:

  • 200MB file size limit.
  • Only wpd, doc, docx, jpg, bmp, txt, rtf, xls, xlsx, pdf, tiff, and tif file formats are accepted.


Parameters

view

Show details for an ERE File.

Files

create

Uploads a file to our system and attaches it to a hearing. 200MB file size limit. Only .pdf, .doc, .docx, .png, .tiff, and .txt files are accepted.


Parameters

HearingNotes

create

Create a new note attached to a hearing. This endpoint is intended for general notes on a hearing, if you are making a hearing note containing a request to make changes to a hearing please use the hearing update endpoint with the "note" and "initials" fields to add your note to a hearing in order for hearing schedulers to review your request. If you add a note requesting changes to a hearing with this endpoint it will not notify hearing schedulers and your request may not be seen.


Parameters

list

Returns an array of HearingNote models attached to the provided hearing ID. Hearing notes are sorted by created at in descending order.


Parameters


Filters

Hearings

create

Adds a new hearing to our system.


Parameters

update

Update an existing hearing in our system.


Parameters

view

Show details related to a hearing in our system.

list

Returns an array containing available hearings in our system.


Filters

assign

Make a request to assign an attorney to a hearing. You can get a current list of your available attorneys by using the attorney list endpoint. If there is already an assigned attorney then the current assigned attorney will be removed and the new one provided will be assigned.


Parameters

unassign

Make a request to unassign an attorney from a hearing.


Parameters

Judges

view

Show details related to a judge in our system.

list

Returns an array containing available judges in our system.

Locations

view

Show details related to a location in our system.

list

Returns an array containing available locations in our system.

Data Models

Basic Response

The basic format of a JSON reponse returned by the API. Except when downloading files, all requests returned are in this format with a Content-Type header of "application/json". Successful requests to download files send only file data in the request with a Content-Type header (and other file specific headers) based on the file data. The data field contains the data specific to the request, such as the returned model or an array of models.

Parameters

Attorney

Base model of an attorney.

Parameters

Brief

Base model of a brief.

Parameters

Case

Base model of a case.

Parameters

CaseFile

Base model of a case file. Case files are generated PDF files created from files on the ERE. A CaseFile model holds information used for generating the PDFs and tracking progress, it is not an indication of an actual downloadable file existing. If there is an actual file available for this case file it is linked by the file_id field. Also known as ERE Case Files.

Parameters

DocPreHearingChecklist

Base model of a pre-hearing checklist.

Parameters

DocType

Base model of a document type used by File.

Parameters

EreFile

Base model of an ERE file. ERE files hold information about a real file uploaded to the ERE through Assure. ERE files are linked to real files by the file_id field.

Parameters

File

Base model of a file.

Parameters

Hearing

Base model of a hearing.

Parameters

HearingNote

Base model of a hearing note.

Parameters

Judge

Base model of a hearing judge.

Parameters

Location

Base model of a hearing location.

Parameters