OpenAPI Specification
openapi: 3.1.0
info:
title: Lex Machina Alerts Dockets API
version: '20260324'
description: Alerts.
servers:
- url: https://api.lexmachina.com
description: Lex Machina production API
tags:
- name: Dockets
description: Docket data.
paths:
/docket-entries/{docket_entry_id}:
get:
tags:
- Dockets
summary: Get District Docket Entry
description: 'Gets data for a single docket entry.
- **docket_entry_id**: the Lex Machina docketEntryId.
Data returned for a docket will vary in format based on context, only the ids and urls for the relevant data will included.'
operationId: get_district_docket_entry
security:
- JwtAccessBearer: []
parameters:
- name: docket_entry_id
in: path
required: true
schema:
type: integer
title: Docket Entry Id
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DocketEntryResult'
examples:
three district query results:
summary: three district query results
value:
filedOn: '2024-08-20'
tags:
- Order
text: 'COURT ORDER denying Motion for permission to proceed filed by Petitioner Mr. Rodgy Lee Nesby [ 2 ]. [24-90020] (CAS) [Entered: 08/20/2024 10:14 AM]'
number: 15
docketEntryId: 1280368587
courtType: FederalAppeals
appealsCaseId: 2034417512
appealsCaseUrl: https://api.lexmachina.com/appeals-cases/2034417512
'401':
description: Invalid or expired token
content:
application/json:
examples:
Expired token:
summary: Expired token
value:
detail: 'Token time expired: Signature has expired.'
Invalid token:
summary: Invalid token
value:
detail: Invalid token
'404':
description: Not found
content:
application/json:
examples:
Not found:
summary: Not found
value:
summary: Unknown id
detail: Not Found
'422':
description: Error - 422
content:
application/json:
examples:
Validation error:
summary: Validation error
value:
summary: Invalid input
detail:
- type: parsing
loc:
- path
- query
- body
msg: invalid input
input: '-1'
/itc-document-entries/{usitc_document_id}:
get:
tags:
- Dockets
summary: Get Itc Document Entry
description: 'Gets data for a single US ITC document.
- **usitc_document_id**: The document id.'
operationId: get_itc_document_entry
security:
- JwtAccessBearer: []
parameters:
- name: usitc_document_id
in: path
required: true
schema:
type: integer
title: Usitc Document Id
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ITCDocumentData'
examples:
Document Entry:
summary: Document Entry
value:
usitcDocumentId: 812722
date: '2024-01-26'
title: Granting Meenaxi Enterprise Inc.'s Motion to Stay Procedural Schedule
type: Order
filedBy:
- name: Bryan F. Moore
firm:
- name: USITC
onBehalfOf:
- name: Administrative Law Judge
investigationNumber: '1232'
'404':
description: Not found
content:
application/json:
examples:
Document Entry Not Found:
summary: Document Entry Not Found
value:
detail: document_id not found
'401':
description: Invalid or expired token
content:
application/json:
examples:
Expired token:
summary: Expired token
value:
detail: 'Token time expired: Signature has expired.'
Invalid token:
summary: Invalid token
value:
detail: Invalid token
'422':
description: Error - 422
content:
application/json:
examples:
Validation error:
summary: Validation error
value:
summary: Invalid input
detail:
- type: parsing
loc:
- path
- query
- body
msg: invalid input
input: '-1'
/state-docket-entries/{state_docket_entry_id}:
get:
tags:
- Dockets
summary: Get State Docket Entry
description: 'Gets data for a single docket entry.
- **state_docket_entry_id**: the Lex Machina stateDocketEntryId.'
operationId: get_state_docket_entry
security:
- JwtAccessBearer: []
parameters:
- name: state_docket_entry_id
in: path
required: true
schema:
type: integer
title: State Docket Entry Id
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/StateDocketEntryResult'
examples:
state case complaint:
summary: state case complaint
value:
filedOn: '2016-07-25'
tags:
- Complaint
text: SUMMONS + COMPLAINT
stateDocketEntryId: 1263090641
courtType: State
stateCaseId: 2033923164
stateCaseUrl: https://api.lexmachina.com/state-cases/2033923164
court: Westchester County Supreme Court
state: New York
'401':
description: Invalid or expired token
content:
application/json:
examples:
Expired token:
summary: Expired token
value:
detail: 'Token time expired: Signature has expired.'
Invalid token:
summary: Invalid token
value:
detail: Invalid token
'404':
description: Not found
content:
application/json:
examples:
Not found:
summary: Not found
value:
summary: Unknown id
detail: Not Found
'422':
description: Error - 422
content:
application/json:
examples:
Validation error:
summary: Validation error
value:
summary: Invalid input
detail:
- type: parsing
loc:
- path
- query
- body
msg: invalid input
input: '-1'
components:
schemas:
ITCDocumentEntityData:
properties:
name:
type: string
title: Name
additionalProperties: false
type: object
required:
- name
title: ITCDocumentEntityData
CourtType:
type: string
enum:
- FederalDistrict
- State
- FederalAppeals
- FederalBankruptcy
- PTAB
- ITC
title: CourtType
ITCDocumentData:
properties:
usitcDocumentId:
type: integer
title: Usitcdocumentid
date:
type: string
format: date
title: Date
title:
anyOf:
- type: string
- type: 'null'
title: Title
type:
type: string
title: Type
filedBy:
items:
$ref: '#/components/schemas/ITCDocumentEntityData'
type: array
title: Filedby
firm:
items:
$ref: '#/components/schemas/ITCDocumentEntityData'
type: array
title: Firm
onBehalfOf:
items:
$ref: '#/components/schemas/ITCDocumentEntityData'
type: array
title: Onbehalfof
investigationNumber:
type: string
title: Investigationnumber
additionalProperties: false
type: object
required:
- usitcDocumentId
- date
- title
- type
- filedBy
- firm
- onBehalfOf
- investigationNumber
title: ITCDocumentData
StateDocketEntryResult:
properties:
filedOn:
anyOf:
- type: string
format: date
- type: 'null'
title: Filedon
tags:
items:
type: string
type: array
title: Tags
text:
anyOf:
- type: string
- type: 'null'
title: Text
stateDocketEntryId:
type: integer
title: Statedocketentryid
courtType:
$ref: '#/components/schemas/CourtType'
stateCaseId:
type: integer
title: Statecaseid
stateCaseUrl:
type: string
title: Statecaseurl
court:
type: string
title: Court
state:
type: string
title: State
additionalProperties: false
type: object
required:
- filedOn
- tags
- text
- stateDocketEntryId
- courtType
- stateCaseId
- stateCaseUrl
- court
- state
title: StateDocketEntryResult
DocketEntryResult:
properties:
filedOn:
anyOf:
- type: string
format: date
- type: 'null'
title: Filedon
tags:
items:
type: string
type: array
title: Tags
text:
anyOf:
- type: string
- type: 'null'
title: Text
number:
anyOf:
- type: integer
- type: 'null'
title: Number
docketEntryId:
type: integer
title: Docketentryid
courtType:
$ref: '#/components/schemas/CourtType'
bankruptcyCaseId:
anyOf:
- type: integer
- type: 'null'
title: Bankruptcycaseid
appealsCaseId:
anyOf:
- type: integer
- type: 'null'
title: Appealscaseid
districtCaseId:
anyOf:
- type: integer
- type: 'null'
title: Districtcaseid
districtCaseUrl:
anyOf:
- type: string
- type: 'null'
title: Districtcaseurl
appealsCaseUrl:
anyOf:
- type: string
- type: 'null'
title: Appealscaseurl
bankruptcyCaseUrl:
anyOf:
- type: string
- type: 'null'
title: Bankruptcycaseurl
additionalProperties: false
type: object
required:
- filedOn
- tags
- text
- number
- docketEntryId
- courtType
title: DocketEntryResult
description: 'The caseId and caseUrl fields will only be populated for the case type of the docket entry.
For example only a district case docket entry will have a districtCaseId and districtCaseURL.'
securitySchemes:
JwtAccessBearer:
type: http
scheme: bearer