Court eFile API Quickstart

1. View list of APIs

You can request APIs hosted on postman by emailing efile@uslegalpro.com

2. Request client token

Request client token (your_client_token) by emailing efile@uslegalpro.com

3. Create an eFiling account

Register for an eFiling account at US Legal PRO

4. Authenticate and get access token

End point: https://api-stage.uslegalpro.com/v2/{{state}}/user/authenticate

Replace {{state}} with tx, il, ca, in, and md

Method: POST

Header: { clienttoken: your_client_token }

Example request payload:

{
    "data": {
        "username": "{efiling_account_email}",
        "password": "{password}"
    }
}

Example response payload:

{
  "message_code": 0,
  "item": {
    "auth_token": "fe2c40a7-68dc-476c-acf8-b850fb72e7c0/XPI0001/992af94b-fff2-4e06-a087-34dfc0e3e1542"
  }
}

5. Search for a case

End point: https://api-stage.uslegalpro.com/v2/{{state}}/search_case?jurisdiction={{location_code}}&case_number={{case_number}}

Replace {{state}} with tx, il, ca, in or md and replace {{location_code}} from step #1 and case_number with your case number

Method: GET

Header: { authtoken: auth_token }

Example response payload:

{
  "message_code": 0,
  "count": 1,
  "items": [
    {
      "jurisdiction_display": "Kankakee County",
      "case_category": "6189",
      "jurisdiction": "kankakee",
      "case_title": "John Vs Jane",
      "case_type_display": "Abandoned Mobile Home",
      "link": {
        "case_detail": {
          "method": "GET",
          "link": "https://api-stage.uslegalpro.com/v2/il/case/f593df4e-ad16-4031-9ce3-05973f47fa2d",
          "header": {
            "clienttoken": "ULPSTAG"
          }
        }
      },
      "case_type": "146049",
      "case_number": "7864",
      "case_category_display": "Chancery",
      "case_tracking_id": "f593df4e-ad16-4031-9ce3-05973f47fa2d"
    }
  ]
}

6. Call eFile API

End point: https://api-stage.uslegalpro.com/v2/{{state}}/efile

Replace {{state}} with tx, il, ca, in, or md

Method: POST

Header: { authtoken: auth_token }

Example request payload:

{
  "data": {
    "reference_id": "786422",
    "case_tracking_id": "f593df4e-ad16-4031-9ce3-05973f47fa2d",
    "payment_account_id": "9847526c-9d6c-4de2-80d8-6353435395d0",
    "filing_type": "EFile",
    "filing_party_id": "f284d521-f883-4ef6-85e4-42a7a4b4c142",
    "filings": [
      {
        "code": "209120",
        "doc_type": "5766",
        "description": "Answer/Response",
        "file": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/answer.pdf",
        "file_name": "Answer.pdf",
        "attachments": [
          {
            "file": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/attachment.pdf",
            "file_name": "Attachment.pdf",
            "doc_type": "5766"
          }
        ]
      }
    ]
  }
}

Example response payload:

{
{
  "message_code": 0,
  "item": {
    "filings": [
      {
        "code": "209120",
        "id": "8cce16ab-3814-4b28-90be-ba951adbf001",
        "status": "submitting"
      }
    ],
    "id": "278602",
    "case_tracking_id": "f593df4e-ad16-4031-9ce3-05973f47fa2d"
  }
}