paint-brush
Law Practice Management Software: Introducing The Top 4 Law APIsby@incora
119 reads

Law Practice Management Software: Introducing The Top 4 Law APIs

by Incora AgencySeptember 5th, 2021
Read on Terminal Reader
Read this story w/o Javascript
tldt arrow

Too Long; Didn't Read

A modern law firm needs dependable software to manage the numerous aspects of its operations. LPMS is the favored solution for business and government law firms, top finance companies, medical services institutes, insurance providers, and colleges across the world to become more efficient and managed. The majority will complement existing software or have an Open API that will allow you to integrate them on your own, like Rocket Matter, Clio, ActionStep, and PracticePanther. In the article, we provided a detailed explanation of how to integrate these APIs into your software.

Companies Mentioned

Mention Thumbnail
Mention Thumbnail
featured image - Law Practice Management Software: Introducing The Top 4 Law APIs
Incora Agency HackerNoon profile picture


A modern law firm needs dependable software to manage the numerous aspects of its operations. To that end, Law Practice Management Software (LPMS) is the favored solution for business and government law firms, top finance companies, medical services institutes, insurance providers, and colleges across the world to become more efficient and managed.


Legal management covers a variety of the practice duties required to run a law firm. At the very least, LPMS will take care of matter management, client management, and task management. To deepen this system’s functionality, organizations may also incorporate features such as a client portal, trust accounting, and document assembling.


Getting your bearings in the legal system can be challenging. Legislations are complicated, can be interpreted in various ways, use their own jargon, and are frequently updated. Legal search engines, law journals and catalogs, law practice software, litigation evidence tools, security, and compliance are just a few of the tools accessible to legislators and litigators to streamline the legal system. LPMS, in essence, connects multiple separate functions of legal practice. They are capable of performing some or even all of these functions in a single system. The majority will complement the existing software or have an Open API that will allow you to integrate them independently.


Building legal solutions and enhancing legal applications with necessary tools and data requires an API integration. We've highlighted the most popular Law APIs in the directory and described how to implement them in detail. All of these third-party integrations have a similar API interface. In addition, each service supports OAuth2 authorization for API access.

PracticePanther

PracticePanther is one of the legal solutions that can be integrated into LPMS. Developers can use APITrack to integrate PracticePanther with other applications or services, create custom reports and dashboards, automate workflows and processes, and customize PracticePanther for their law practice. Accounts, bank accounts, call logs, custom fields, emails, expenses, invoices, goods, payments, and relationships are all part of the operations.

Credentials

To obtain a Client id and Client Secret, you need to create an account at the PracticePanther website. Then go to the Settings page and request API access:

Then you will be able to create an app:

and OAuth 2.0 credentials will be generated:

Please note: PracticePanther supports only https redirect URLs. So, for local testing, you will need to set up ngrok or something similar.


Authorization

Once you get OAuth 2.0 credentials, you can send a request to get access and refresh tokens. You need to build a URL to redirect the user to the following URL. Then you will be rerouted to your redirect URL with the authorization code. Since you received the code, you need to exchange it to access and refresh tokens by performing a POST request to https://app.practicepanther.com/oauth/token


However, the PracticePanther API has a few access issues. First, the API has Cloudflare anti-DDOS protection. So, common requests from the server will return the HTML page with Cloudflare anti-DDOS check content. Anyway, the request can be sent from the browser, but other domains are blocked by CORS policy, and it looks like the request can be sent only from the PracticePanther domain.


The solution is to use a proxy server like CORS Anywhere or any other similar. It allows sending requests from the browser or the server. If you choose to apply requests from the server, you need to include the Origin header manually. You can use it and the npm package or deploy it somewhere. So, the request should look like this:

 import * as qs from 'qs';
   import axios from 'axios';
 
 
   const code = body.code;
   const authPayload = {
     grant_type: 'code',
     code,
     client_id: 'YOUR_CLIENT_ID',
     client_secret: 'YOUR_CLIENT_SECRET',
     redirect_uri: 'YOUR_REDIRECT_URI',
   };
   const proxyServerUrl = 'YOUR_PROXY_SERVER_URL';
   const baseUrl = `${proxyServerUrl}/https://app.practicepanther.com`;
   const authHeaders = {
     headers: {
       Origin: 'YOUR_ORIGIN', // it can be your frontend base URL
       'Content-Type': 'application/x-www-form-urlencoded',
     },
   };
 
 
   const response = await axios.post(`${baseUrl}/OAuth/Token`, qs.stringify(authPayload), authHeaders);

Please note, the payload should be sent as x-www-form-urlencoded.


The response will be in the format:

{
    "access_token": "SOME_TOKEN",
    "token_type": "bearer",
    "expires_in": 86399,
    "refresh_token": "SOME_TOKEN"
    }

The access token will expire in one day. So, to refresh it, you need to send the same request but payload:

const authPayload = {
     grant_type: 'refresh_token',
     refresh_token: 'YOUR_REFRESH_TOKEN',
     client_id: 'YOUR_CLIENT_ID',
     client_secret: 'YOUR_CLIENT_SECRET',
   };

Perform API calls

To perform an API call, you always need to include a proxy server in the URL. So, your base URL should look like this:

const baseUrl = `${proxyServerUrl}/https://app.practicepanther.com`;


Also, Origin should be included in headers. So, here is the example of the headers for each request:

const requestHeaders = {
  Authorization: `Bearer YOUR_ACCESS_TOKEN`,
  Origin: 'YOUR_ORIGIN',
};


To find API documentation, guides, sample code, SDKs, and libraries, visit the Platform’s documentation page.

API issues

The key entities in this API are Contacts, Matters, Time entries, and Expenses. Regarding Contacts, there is a read-only API, and for CRUD operations can be used Accounts endpoints. Also, there is an issue with the Expenses endpoint. If the user just created an account and didn’t visit the Expenses page, the API will throw 500 errors. But once a user visits the Expenses page, the endpoint will return a proper list of Expenses. So, if you want to get a list of Expenses, even if the user didn’t visit the page, you can send a GET request to the endpoint.

Rocket Matter

Rocket Matter is a legal practice management system (LPMS) that allows users to effortlessly design workflows and navigate between various stages of a case and set up automated online payments, financing options, including everlasting contracts, and instantly generate actionable statistical data reports. Thus, you get the whole spectrum of API Integration tools by applying Rocket Matter to your application.

Credentials

To obtain OAuth 2.0 credentials, you need to contact support.

Authorization

When you receive OAuth 2.0 credentials on Rocket Matter, you can obtain access and refresh tokens. First, you need to build a URL to redirect the user to the following URL. Then you will be rerouted to your redirect URL with the Code and Install.


Using code and install, you can send a GrantToken request to receive access and refresh tokens:


Each Rocket Matter user has its own subdomain, so YOUR_DOMAIN should look like this:

  • <YOUR_SUBDOMAIN>.rocketmatter.net


You need to send a request to get YOUR_DOMAIN by YOUR_INSTALL:

 import axios from 'axios';
   
 
   const getDomainURL = 'https://rocketmatter.net/router/Router.svc/json/GetDomainForInstall';
   const { data } = await axios.post(getDomainURL, { InstallName: '<YOUR_INSTALL>' });
   const domain = String.raw`${data}`.replace(/"/g, '').trim();


When you get all the needed data to build the API base URL, you can perform a POST request to GrantToken.

  • <https://<YOUR_DOMAIN>/<YOUR_INSTALL>/API_V2/Authentication.svc/json/GrantToken>


To refresh the token you need to perform a POST request to

  • <https://<DOMAIN>/<INSTALL>/API_V2/Authentication.svc/json/RefreshToken>
  const code = body.code;
   const authPayload = {
     grant_type: 'code',
     client_id: '<YOUR_CLIENT_ID>',
     client_secret: '<YOUR_CLIENT_SECRET>',
     code,
   };
 
   const url = 'https://<YOUR_DOMAIN>/<YOUR_INSTALL>/API_V2/Authentication.svc/json/GrantToken
';
   const tokens = await axios.post(url, authPayload);

with refresh token in the body:

{
"refresh_token": "<YOUR_REFRESH_TOKEN>"
}

Perform API calls

To perform an API call you just need to put access token in Authorization header:

const requestHeaders = {
  Authorization: '<YOUR_ACCESS_TOKEN>',
};


The API documentation can be found here: https://developer.rocketmatter.com

Please note: Rocket Matter entities have integer ids which are unique only inside install. So, if you need to store data from different users, the unique key should be installed and id, not only id.


ActionStep

ActionStep offers tools for Legal Management. To boost automation, the ActionStep APITrack allows developers to incorporate legal practice workflow elements to describe the steps, tasks, and timing of any procedure. In addition, its API Integration tools allow you to access documents and management features via a programmatic interface.

Credentials

To obtain OAuth 2.0 credentials, you need to contact support.

Authorization

As in previous integrations, since you received OAuth 2.0 credentials, you can obtain access and refresh tokens. You need to build a URL to redirect the user to the following URL:


Then you will be rerouted to your redirect URL with the code:

  • https://YOUR_REDIRECT_URI?code=THE_AUTHORIZATION_CODE


Using code, you can send an authorization request to receive access and refresh tokens:


Like for PracticePanther, the Content-Type for this request should be application/x-www-form-urlencoded

const code = body.code;
   const authPayload = {
     grant_type: 'code',
     client_id: '<YOUR_CLIENT_ID>',
     client_secret: '<YOUR_CLIENT_SECRET>',
     redirect_uri: '<YOUR_REDIRECT_URI>',
     code,
   };
 
   const headers = {
     'Content-Type': 'application/x-www-form-urlencoded',
   };
 
 
   const url = 'https://go.actionstep.com/api/oauth/token';
   const tokens = await axios.post(url, qs.stringify(authPayload), { headers });
;

To refresh a token, you need to perform the same invocation but include it in the request.

Perform API calls

To perform an API call you need to put access token in Authorization Header as well as set Content-Type and also accept headers to application/vnd.api+json:

const requestHeaders = {
  'Content-Type': 'application/vnd.api+json',
  Accept: 'application/vnd.api+json',
  Authorization: 'Bearer <YOUR_ACCESS_TOKEN>',
}; 


Also, the base URL for API calls is different from the base URL for authentications: https://us-east-1.actionstep.com/api/res. A list of all requestable resources can be found here.


Clio

Clio is an LPMS that allows API integration, and its legal solutions are designed for small to mid-sized law firms. The Clio APITrack gives users access to the system’s functionality and data kept in the firm’s Clio instance. API integration helps implement methods for handling activities, bills, contacts, matters, tasks, and users.

Credentials

To obtain OAuth 2.0 credentials, you need to create an account at Clio and navigate to the Settings page.


Then, by clicking ‘Add’ and filling in all the required information, you will receive your App Key and App Secret.


Authorization

The authorization process is very similar to the previous integrations, only with different URLs. So, the first URL to which the user will be redirected should be:


And after the user is redirected to the REDIRECT_URI, the code should be sent to

with Content-Type application /x-www-form-urlencoded. You can also renew the token by performing the same request with the refresh token included.


Perform API calls

To perform an API call, you need to put the access token in the Authorization header:

const requestHeaders = {
  Authorization: 'Bearer <YOUR_ACCESS_TOKEN>',
};


The API documentation can be found here: https://app.clio.com/api/v4/documentation


Also, unlike other mentioned services, Clio supports bulk action, which is useful when you need to transfer large portions of data to/from Clio.


To Wrap Up


API integration into the Legal Management enables legal firms to directly enter fresh leads generated by automated searches into their LPMS, store docket entries and documents, receive automated alerts about new filings or case updates, and many more. There are various advantages to using API Integration tools, but two, in particular, are relevant to the traditional legal firm model: decreased expenses and increased production. To put it another way, lawyers save time, money, and valuable human resources by automating previously time-consuming operations.


Here we described which steps to take when applying LPMS API Integration for Clio, PracticePanther, Rocket Matter, and Actionstep if you decided to execute management systems to your legal practice. There are various other APIs in the legal industry that contribute value. Now it is easier to check all these platforms and choose one to simplify your legal department.


Originally posted on Incora blog: https://incorainc.com/api-integration-into-the-legal-management/