OpenAPI Specification
openapi: 3.1.0
info:
title: Lex Machina Alerts ITC Investigations API
version: '20260324'
description: Alerts.
servers:
- url: https://api.lexmachina.com
description: Lex Machina production API
tags:
- name: ITC Investigations
description: ITC Investigations.
paths:
/itc-investigations/{itc_investigation_id}:
get:
tags:
- ITC Investigations
summary: Get Itc Investigation
description: 'Gets data for a single US ITC investigation.
- **itc_investigation_id**: the ITC investigation number
- **docket_retrieval**: docket retreival mode
The investigation number format should exclude the leading "337-TA-"'
operationId: get_itc_investigation
security:
- JwtAccessBearer: []
parameters:
- name: itc_investigation_id
in: path
required: true
schema:
type: string
title: Itc Investigation Id
- name: document_retrieval
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: '''all'' to retrieve all documents for the investigation, if not provided documents will not be returned.'
title: Document Retrieval
description: '''all'' to retrieve all documents for the investigation, if not provided documents will not be returned.'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ITCInvestigationData'
examples:
single itc investigation:
summary: single itc investigation
value:
itcInvestigationId: '998'
investigationNumber: 337-TA-998
title: Certain Hybrid Electric Vehicles Components Thereof; Inv. No. 337-TA-998
investigationTypes:
- Patent
status: Terminated
dates:
notice: '2016-05-23'
terminated: '2017-02-01'
administrativeLawJudges:
- name: Thomas Pender
dispositions:
- Settlement
parties:
- name: Volkswagen Group of America, Inc.
role: respondent
- name: Volkswagen AG
role: respondent
- name: Porsche Cars North America, Inc.
role: respondent
- name: Dr. Ing. h.c. F. Porsche AG
role: respondent
- name: Audi of America, LLC
role: respondent
- name: Audi AG
role: respondent
- name: Paice LLC
role: complainant
- name: Abell Foundation, Inc.
role: complainant
- name: Dr. Ing. H.C. F. Porsche AG
role: respondent
patents:
- number: '7104347'
title: Hybrid vehicles
- number: '7237634'
title: Hybrid vehicles
- number: '8214097'
title: Hybrid vehicles
itcDocumentList:
entries: []
retrieved: none
count: 199
'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:
DocketEntriesIncludedInOutput:
type: string
enum:
- all
- none
title: DocketEntriesIncludedInOutput
ITCDocumentEntityData:
properties:
name:
type: string
title: Name
additionalProperties: false
type: object
required:
- name
title: ITCDocumentEntityData
ITCParty:
properties:
name:
type: string
title: Name
role:
type: string
title: Role
additionalProperties: false
type: object
required:
- name
- role
title: ITCParty
ITCDocumentList:
properties:
entries:
items:
$ref: '#/components/schemas/ITCDocument'
type: array
title: Entries
retrieved:
$ref: '#/components/schemas/DocketEntriesIncludedInOutput'
count:
type: integer
title: Count
additionalProperties: false
type: object
required:
- entries
- retrieved
- count
title: ITCDocumentList
ITCInvestigationDates:
properties:
notice:
anyOf:
- type: string
format: date
- type: 'null'
title: Notice
terminated:
anyOf:
- type: string
format: date
- type: 'null'
title: Terminated
additionalProperties: false
type: object
required:
- notice
- terminated
title: ITCInvestigationDates
ITCInvestigationStatus:
type: string
enum:
- Active
- Terminated
- Completed
- Pending before the ALJ
- Pending before the Commission
title: ITCInvestigationStatus
Patent:
properties:
number:
type: string
title: Number
title:
anyOf:
- type: string
- type: 'null'
title: Title
additionalProperties: false
type: object
required:
- number
title: Patent
AdministrativeLawJudge:
properties:
name:
type: string
title: Name
additionalProperties: false
type: object
required:
- name
title: AdministrativeLawJudge
ITCDocument:
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
additionalProperties: false
type: object
required:
- usitcDocumentId
- date
- title
- type
- filedBy
- firm
- onBehalfOf
title: ITCDocument
ITCInvestigationData:
properties:
itcInvestigationId:
type: string
title: Itcinvestigationid
investigationNumber:
type: string
title: Investigationnumber
title:
type: string
title: Title
investigationTypes:
items:
$ref: '#/components/schemas/ITCInvestigationType'
type: array
title: Investigationtypes
status:
anyOf:
- $ref: '#/components/schemas/ITCInvestigationStatus'
- type: 'null'
dates:
$ref: '#/components/schemas/ITCInvestigationDates'
administrativeLawJudges:
items:
$ref: '#/components/schemas/AdministrativeLawJudge'
type: array
title: Administrativelawjudges
dispositions:
items:
type: string
type: array
title: Dispositions
parties:
items:
$ref: '#/components/schemas/ITCParty'
type: array
title: Parties
patents:
items:
$ref: '#/components/schemas/Patent'
type: array
title: Patents
itcDocumentList:
$ref: '#/components/schemas/ITCDocumentList'
additionalProperties: false
type: object
required:
- itcInvestigationId
- investigationNumber
- title
- investigationTypes
- status
- dates
- administrativeLawJudges
- dispositions
- parties
- patents
- itcDocumentList
title: ITCInvestigationData
description: A single US ITC investigation and relevant metadata.
ITCInvestigationType:
type: string
enum:
- Patent
- Trademark
- Copyright
title: ITCInvestigationType
securitySchemes:
JwtAccessBearer:
type: http
scheme: bearer