PlainSite API

Programmatic access to the PlainSite legal database — court cases, attorneys, judges, entities, patents, and more.

Get your API token

REST API access requires a PlainSite Pro subscription. Sign in to generate and manage your token.

Get API Token ›
Data Quality Notice: PlainSite is not an official U.S. Government entity. Data is compiled from government sources and may be corrected or normalized. Information may not exactly match official records. Spotted an error? Let us know.

API Methods

Every method is a single HTTP request to api.js. Pass your token, the method name, and that method’s parameters as query-string arguments. Responses are JSON.

https://www.plainsite.org/api/api.js?token=<yourtoken>&method=<methodName>&<params>

Generate a token on the API Token page (requires a PlainSite Pro subscription) and pass it as the token parameter on every request.

Search & Discovery

search Universal Search

The same search that powers the search box on plainsite.org. Matches across entity names, case titles, attorneys, judges, courts and tags — best for open-ended keywords or when you don't yet know a specific entity or case. (To search inside the text of filed documents and opinions, use searchFullText instead.) For a known citation use searchCitations; for a known name use searchEntities. The state field reports how the query was interpreted (e.g. "entity", "citation", "title").

query requiredSearch query string.
limitMaximum results (default 25, max 100).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=search&query=Theranos Response
{
  "query": "Theranos",
  "state": "entity",
  "count": 2,
  "results": [
    {
      "type": "entity",
      "id": "5qt7",
      "title": "Theranos, Inc.",
      "url": "https://www.plainsite.org/profiles/theranos-inc/"
    },
    {
      "type": "docket",
      "id": "8mp4",
      "title": "SEC v. Elizabeth Holmes",
      "court": "N.D. Cal.",
      "filed": "2018-06-15"
    }
  ]
}
searchCitations Resolve Legal Citation

Resolve a legal citation string to its PlainSite page. Accepts standard reporter format — volume, reporter abbreviation, and page — e.g. "410 U.S. 113", "856 F.2d 184". Pincites are supported.

citation requiredCitation string, e.g. "410 U.S. 113".
limitMaximum results (default 10, max 50).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=searchCitations&citation=410+U.S.+113 Response
{
  "citation": "410 U.S. 113",
  "found": true,
  "type": "opinion",
  "url": "https://www.plainsite.org/opinions/1jx2/roe-v-wade/",
  "isPincite": false,
  "caseTitle": "Roe v. Wade",
  "caseNumber": "70-18",
  "leadAuthor": "Blackmun",
  "pages": 66,
  "format": "PDF"
}
searchEntities Search Entities

First step for any person or company query. Searches legal entities by name. Individuals are stored as "Lastname, Firstname" (e.g. "Musk, Elon"). Returns an entityId for use with getEntityProfile and getDocketsByEntity.

name requiredCompany or individual name.
limitMaximum results (default 25, max 100).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=searchEntities&name=Tesla Response
[
  {
    "entityid": "5qt7",
    "organization": "Tesla, Inc.",
    "type": "Corporation",
    "symbol": "TSLA",
    "industry": "Auto Manufacturers",
    "status": "Active",
    "url": "https://www.plainsite.org/profiles/tesla-inc-tsla/"
  },
  {
    "entityid": "7mr3",
    "organization": "Tesla Capital LLC",
    "type": "LLC",
    "symbol": null,
    "status": "Active",
    "url": "https://www.plainsite.org/profiles/tesla-capital-llc/"
  }
]
searchCourts Search Courts

Find U.S. courts by state, keyword, or exact ID.

idEncoded court ID.
stateTwo-character state code, e.g. "CA".
descriptionKeyword to match against court name.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=searchCourts&state=CA Response
{
  "results": [
    {
      "courtId": "3bx1",
      "name": "U.S. District Court, Central District of California",
      "state": "CA",
      "level": "Federal District"
    },
    {
      "courtId": "4mz8",
      "name": "U.S. District Court, Northern District of California",
      "state": "CA",
      "level": "Federal District"
    }
  ]
}
searchJudges Search Judges

Find judges by name, home court, or exact ID.

idEncoded judge ID.
courtIdEncoded court ID.
firstNameJudge first name (exact match).
lastNameJudge last name (exact match).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=searchJudges&lastName=Koh Response
{
  "results": [
    {
      "judgeId": "2np5",
      "name": "Lucy H. Koh",
      "court": "U.S. Court of Appeals for the Ninth Circuit",
      "type": "Circuit"
    }
  ]
}
searchAgents Search Attorneys

Find attorneys by name, firm, or entity ID.

idEncoded attorney ID.
entityIdEncoded entity ID — lists attorneys for that firm.
nameAttorney name keyword.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=searchAgents&name=Quinn+Emanuel Response
{
  "results": [
    {
      "attorneyId": "6wr2",
      "name": "Quinn Emanuel Urquhart & Sullivan",
      "type": "Firm",
      "url": "/attorneys/quinn-emanuel-urquhart-sullivan/"
    }
  ]
}
searchCorpora Search Bodies of Law

Find bodies of law (corpora) by keyword or exact ID. Returns a corpusId for use with getStatutes.

idEncoded corpus ID.
descriptionKeyword, e.g. "Alabama" or "Federal".
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=searchCorpora&description=Federal+Rules Response
{
  "results": [
    { "corpusId": "1", "description": "Federal Rules of Civil Procedure" },
    { "corpusId": "2", "description": "Federal Rules of Evidence" }
  ]
}
searchFullText Full-Text Document Search

Search the text of filed court documents and opinions via Elasticsearch. When docketId is provided, restricts the search to that single case.

query requiredSearch query (boolean operators supported).
docketIdEncoded docket ID — restrict to one case.
linktablesContent types: "docketentries", "docketentryattachments", "docketopinions".
dateFromOnly documents on/after this date (YYYY-MM-DD).
dateToOnly documents on/before this date (YYYY-MM-DD).
pageResult page (default 1).
limitResults per page (default 10, max 50).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=searchFullText&query=preliminary+injunction&dateFrom=2024-01-01 Response
{
  "results": [
    {
      "entryId": "9kp3",
      "docketId": "4tr6",
      "title": "Order Granting Preliminary Injunction",
      "date": "2024-03-15",
      "snippet": "...the Court finds that plaintiff has demonstrated a likelihood of success..."
    }
  ],
  "total": 312,
  "page": 1
}

Court Cases

searchDockets Search Dockets

Retrieve docket data by ID. Use when you already have a docket, case, court, or judge ID. Do not use the title parameter to look up cases by party name — use searchEntities + getDocketsByEntity for that.

idEncoded docket ID.
caseIdEncoded case ID.
courtIdEncoded court ID.
judgeIdEncoded judge ID.
titlePartial case title keyword (slow — use only for known partial titles).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=searchDockets&id=4tr6 Response
{
  "docketId": "4tr6",
  "title": "Doe v. Smith Corp.",
  "court": "U.S. District Court, S.D.N.Y.",
  "number": "1:24-cv-01234",
  "status": "Open",
  "filed": "2024-02-01",
  "url": "/courts/s-d-n-y/doe-v-smith-corp/4tr6/"
}
exportCase Export Case as JSON

Export a complete docket as structured JSON optimized for AI analysis. Includes parties with attorney/firm representation and all docket entries grouped into motion threads. Set includeText: true to include full OCR-cleaned document text.

docketId requiredEncoded docket ID.
includeTextInclude full document text (default false).
entryIdsArray of entry IDs — export only specific threads.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=exportCase&docketId=4tr6 Response
{
  "docketId": "4tr6",
  "title": "Doe v. Smith Corp.",
  "parties": [
    {
      "name": "Jane Doe",
      "role": "Plaintiff",
      "attorneys": ["Smith, John — Jones Day"]
    }
  ],
  "threads": [
    {
      "title": "Motion to Dismiss",
      "entries": [
        { "date": "2024-03-10", "text": "MOTION to Dismiss for failure to state a claim..." }
      ]
    }
  ]
}
getCase Get Case

Retrieve a legal case by ID. A case groups related dockets that span multiple courts.

id requiredEncoded case ID.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getCase&id=88x2 Response
{
  "caseId": "88x2",
  "title": "In re: XYZ Litigation",
  "dockets": [
    { "docketId": "4tr6", "court": "S.D.N.Y.", "number": "1:24-cv-01234" },
    { "docketId": "5kp1", "court": "D. Del.", "number": "1:24-cv-00891" }
  ]
}
getDocketsByEntity Get Dockets by Entity

Find court cases involving a specific legal entity. Requires an entityId — use searchEntities first if you only have a name.

entityIdEncoded entity ID (from searchEntities).
courtIdEncoded court ID — restrict to one court.
filedAfterCases filed on/after this date (YYYY-MM-DD).
filedBeforeCases filed on/before this date (YYYY-MM-DD).
terminatedtrue = closed only; false = active only; omit = all.
limitMaximum results (default 25, max 100).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getDocketsByEntity&entityId=5qt7&filedAfter=2022-01-01 Response
{
  "results": [
    {
      "docketId": "7mx1",
      "title": "Tesla, Inc. v. Rivian Automotive, Inc.",
      "court": "D. Del.",
      "number": "1:22-cv-00045",
      "filed": "2022-01-14",
      "url": "/courts/d-del/tesla-v-rivian/7mx1/"
    }
  ],
  "total": 143
}

Profiles

getEntityProfile Get Entity Profile

Full entity profile: court activity breakdown, recent dockets, editorial tags, top counsel, and (for law firms) attorney roster.

entityId requiredEncoded entity ID (from searchEntities).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getEntityProfile&entityId=5qt7 Response
{
  "entityId": "5qt7",
  "name": "Tesla, Inc.",
  "symbol": "TSLA",
  "recentDockets": [
    { "docketId": "7mx1", "title": "Tesla v. Rivian", "court": "D. Del.", "filed": "2022-01-14" }
  ],
  "topCounsel": [
    { "firm": "Gibson, Dunn & Crutcher", "caseCount": 14 }
  ],
  "tags": ["Electric Vehicles", "Autopilot", "Securities Fraud"]
}
getAttorneyProfile Get Attorney Profile

Full attorney profile: bar admissions, motion filing statistics, recent cases, top judges, and top clients.

attorneyId requiredEncoded attorney ID (from searchAgents).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getAttorneyProfile&attorneyId=6wr2 Response
{
  "attorneyId": "6wr2",
  "name": "John A. Smith",
  "firm": "Jones Day",
  "admissions": ["CA", "NY", "DC"],
  "motionStats": {
    "filed": 412,
    "granted": 187,
    "grantRate": "45%"
  },
  "topJudges": [
    { "name": "Koh, Lucy H.", "cases": 8 }
  ]
}
getCourtProfile Get Court Profile

Full court profile: sitting judges, popular dockets in the past 30 days, recently updated dockets, and top frequent filers.

courtId requiredEncoded court ID (from searchCourts).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getCourtProfile&courtId=3bx1 Response
{
  "courtId": "3bx1",
  "name": "U.S. District Court, Central District of California",
  "judges": [
    { "judgeId": "9pq2", "name": "Otis D. Wright II", "type": "District" }
  ],
  "popularDockets": [
    { "docketId": "2mk5", "title": "Perfect 10, Inc. v. Google LLC" }
  ]
}
getEntity Get Entity

Retrieve a legal entity record by its encoded ID.

id requiredEncoded entity ID.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getEntity&id=5qt7 Response
{
  "entityId": "5qt7",
  "name": "Tesla, Inc.",
  "type": "Corporation",
  "symbol": "TSLA",
  "cik": "1318605",
  "url": "/profiles/tesla-inc-tsla/"
}

Tags

Tags are PlainSite’s cross-reference system — each tag links related cases, entities, attorneys, judges, and statutes around a topic (e.g. “Tesla Autopilot”, “Bitcoin”).

getTagStats Get Tag Statistics

Statistics for a PlainSite editorial tag: total linked dockets, breakdown by entity and court level, sub-tags, and related tags.

tagTag name or partial name.
tagIdEncoded tag ID (for exact lookup).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getTagStats&tag=Autopilot Response
{
  "tagId": "3vz9",
  "name": "Tesla Autopilot",
  "docketCount": 47,
  "topEntities": [
    { "name": "Tesla, Inc.", "caseCount": 31 }
  ],
  "relatedTags": ["Electric Vehicles", "Product Liability"]
}
getDocketsByTag Get Dockets by Tag

Find court cases tagged with a specific topic.

tagTag name or partial name.
tagIdEncoded tag ID.
pagePage number (default 1).
limitResults per page (default 25, max 100).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getDocketsByTag&tag=Autopilot Response
{
  "results": [
    {
      "docketId": "7mx1",
      "title": "Huang v. Tesla, Inc.",
      "court": "N.D. Cal.",
      "filed": "2019-06-25"
    }
  ],
  "total": 47,
  "page": 1
}
getTagLinks Get Tag Links

Retrieve items of a specific content type linked to a tag. Supported types: entities, attorneys, judges, statutes, documents, docketentries, web.

tagIdEncoded tag ID.
tagTag name or partial name (resolved if tagId not supplied).
linktable requiredContent type — one of the types listed above.
pagePage number (default 1).
limitResults per page (default 25, max 100).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getTagLinks&tag=Autopilot&linktable=entities Response
{
  "results": [
    {
      "entityId": "5qt7",
      "name": "Tesla, Inc.",
      "type": "Corporation",
      "url": "/profiles/tesla-inc-tsla/"
    }
  ],
  "total": 3
}

Legal Texts

getOpinion Get Court Opinion

Retrieve a published court opinion by ID. Returns full metadata and complete opinion text.

opinionId requiredEncoded opinion ID.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getOpinion&opinionId=1jx2 Response
{
  "opinionId": "1jx2",
  "title": "Roe v. Wade",
  "court": "Supreme Court of the United States",
  "date": "1973-01-22",
  "citation": "410 U.S. 113",
  "text": "MR. JUSTICE BLACKMUN delivered the opinion of the Court..."
}
getStatutes Get Statutes

Retrieve statutes and regulations by corpus ID or exact statute ID. Use searchCorpora to find a corpusId.

idEncoded statute ID.
corpusIdEncoded corpus ID — returns up to 100 statutes.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getStatutes&corpusId=1 Response
{
  "corpus": "Federal Rules of Civil Procedure",
  "results": [
    { "statuteId": "101", "section": "Rule 1",       "title": "Scope and Purpose" },
    { "statuteId": "102", "section": "Rule 12(b)(6)", "title": "Failure to State a Claim" }
  ]
}

Intellectual Property

getPatentAssignment Get Patent Assignment

Look up USPTO patent assignments by patent number, application number, reel/frame reference, or internal ID.

idEncoded assignment ID.
patentNumberUSPTO patent number.
applicationNumberUSPTO application number.
reelUSPTO reel number.
frameUSPTO frame number (requires reel).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getPatentAssignment&reel=1000&frame=33 Response
{
  "assignmentId": "8np4",
  "reel": "1000",
  "frame": "033",
  "recorded": "1985-04-22",
  "assignor": "Inventor, Jane A.",
  "assignee": "Tech Corporation",
  "patents": [
    { "number": "US4567890", "title": "Method and Apparatus for Data Processing" }
  ]
}
getTrademarkAssignment Get Trademark Assignment

Look up USPTO trademark assignments by serial number, registration number, reel/frame, or internal ID.

idEncoded assignment ID.
serialNumberUSPTO trademark serial number.
registrationNumberUSPTO trademark registration number.
reelUSPTO reel number.
frameUSPTO frame number (requires reel).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getTrademarkAssignment&reel=374&frame=748 Response
{
  "assignmentId": "6tk2",
  "reel": "374",
  "frame": "748",
  "recorded": "2010-07-15",
  "assignor": "Original Brand Corp.",
  "assignee": "New Owner LLC",
  "marks": [
    {
      "serialNumber": "78123456",
      "registrationNumber": "3456789",
      "description": "BRANDNAME"
    }
  ]
}

Financial Data

searchBySymbol Search by Stock Ticker

Look up companies by stock ticker symbol, current or historical.

symbol requiredTicker symbol, e.g. "AAPL", "TSLA".
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=searchBySymbol&symbol=TSLA Response
{
  "entityId": "5qt7",
  "name": "Tesla, Inc.",
  "symbol": "TSLA",
  "cik": "1318605",
  "url": "/profiles/tesla-inc-tsla/"
}
getStockPrices Get Stock Prices

Historical OHLCV (open/high/low/close/volume) data. Pass a ticker symbol or an entity ID. Results are ordered newest-first.

symbolTicker symbol.
entityIdEncoded entity ID — symbol resolved automatically.
dateFromStart date (YYYY-MM-DD, inclusive).
dateToEnd date (YYYY-MM-DD, inclusive).
limitMaximum rows (default 90, max 1825).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getStockPrices&symbol=TSLA&dateFrom=2024-01-01&dateTo=2024-01-05 Response
{
  "symbol": "TSLA",
  "results": [
    { "date": "2024-01-05", "open": 218.80, "high": 221.37, "low": 214.18, "close": 220.11, "volume": 103241200 },
    { "date": "2024-01-04", "open": 211.33, "high": 217.50, "low": 210.47, "close": 214.36, "volume":  98432100 }
  ]
}
getInsiderTrades Get Insider Trades

Publicly disclosed insider trades from SEC Form 3, 4, and 5 filings.

entityIdEncoded entity ID of the insider.
symbolTicker symbol — returns all insiders who traded it.
actionFilter by trade action: "Buy", "Sell", "Split", "Reverse Split", "Expire".
dateFromOnly trades on/after this date (YYYY-MM-DD).
dateToOnly trades on/before this date (YYYY-MM-DD).
limitMaximum results (default 25, max 100).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getInsiderTrades&symbol=TSLA&dateFrom=2024-01-01 Response
{
  "results": [
    {
      "entityId": "9xk1",
      "name": "Musk, Elon",
      "action": "Sell",
      "quantity": 1000000,
      "price": 248.50,
      "date": "2024-01-12",
      "form": "4"
    }
  ],
  "total": 28
}
listSECFilings List SEC Filings

List SEC filings on record for a company or individual. Returns filing metadata. Use the returned filingId with getSECFiling to read the full content.

entityId requiredEncoded entity ID.
formTypeFilter by form type, e.g. "10-K", "10-Q", "8-K", "4", "DEF 14A".
filedAfterOnly filings on/after this date (YYYY-MM-DD).
filedBeforeOnly filings on/before this date (YYYY-MM-DD).
limitMaximum results (default 25, max 100).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=listSECFilings&entityId=5qt7&formType=10-K Response
{
  "results": [
    {
      "filingId": "3mr7",
      "formType": "10-K",
      "date": "2024-01-26",
      "description": "Annual report for fiscal year ended December 31, 2023",
      "url": "/markets/tesla-inc-tsla/form-10-k/3mr7/"
    }
  ],
  "total": 12
}
getSECFiling Get SEC Filing

Retrieve the full structured content of an SEC filing: header (company info, dates) and all documents in the submission. For large filings (10-K, 10-Q) only the header and document index are returned.

filingId requiredEncoded filing ID (from listSECFilings).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=getSECFiling&filingId=3mr7 Response
{
  "filingId": "3mr7",
  "formType": "10-K",
  "date": "2024-01-26",
  "company": "Tesla, Inc.",
  "cik": "1318605",
  "documents": [
    {
      "sequence": 1,
      "filename": "tsla-20231231.htm",
      "description": "10-K Annual Report"
    }
  ]
}

Account Actions

followItem Follow / Unfollow

Follow or unfollow a court case, entity, or tag. Requires a Pro or Pro Se subscription. Calling this a second time on an item you already follow unfollows it (toggle).

linktable requiredType of item: "dockets", "entities", or "tags".
itemId requiredEncoded item ID.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=followItem&linktable=dockets&itemId=4tr6 Response
{
  "following": true,
  "itemId": "4tr6",
  "linktable": "dockets"
}

Legacy REST Methods

These methods predate the unified API above and use a simpler raw-row format. They are preserved for backward compatibility. For new integrations, prefer the rich methods in the section above, which apply sanitization, ID encoding, URL generation, and Elasticsearch-powered search.

https://www.plainsite.org/api/api.xml?token=<yourtoken>&method=<method>&<params>

XML responses are only available via the legacy methods above. JSON is the default for all methods.

Methods

corpora Corpora: Bodies of Law

Returns one or all bodies of law in the database.

idReturns the corpus with this unique ID.
descriptionReturns corpora whose description matches the given string.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=corpora&description=Alabama Response
[
  { "id": "14", "description": "Alabama Code" },
  { "id": "15", "description": "Alabama Rules of Civil Procedure" }
]
statutes Statutes: Laws & Regulations

Returns statutes within a given corpus. Either id or corpusid is required.

idReturns the statute with this unique ID.
corpusidReturns statutes within the given corpus ID (up to 100).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=statutes&corpusid=1 Response
[
  { "id": "101", "corpusid": "1", "section": "Rule 1",  "title": "Scope and Purpose" },
  { "id": "102", "corpusid": "1", "section": "Rule 12", "title": "Defenses and Objections" }
]
courts Courts

Returns courts, optionally filtered by state or exact ID.

idReturns the court with this unique ID.
stateprovinceReturns courts in the given two-character state or province code.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=courts&stateprovince=OH Response
[
  { "id": "88", "description": "U.S. District Court, N.D. Ohio", "stateprovince": "OH", "level": "Federal District" },
  { "id": "89", "description": "U.S. District Court, S.D. Ohio", "stateprovince": "OH", "level": "Federal District" }
]
judges Judges

Returns judges. At least one parameter is strongly recommended; omitting all returns the full table.

idReturns the judge with this unique ID.
courtidReturns judges for the given court ID.
firstnameFirst name (exact match).
lastnameLast name (exact match).
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=judges&lastname=Johnson Response
[
  { "id": "1042", "firstname": "Mark", "lastname": "Johnson", "courtid": "88", "court": "N.D. Ohio" },
  { "id": "2817", "firstname": "Sarah", "lastname": "Johnson", "courtid": "14", "court": "S.D.N.Y." }
]
cases Cases

Returns a legal case record. A case groups related dockets across multiple courts. An id parameter is required.

id requiredReturns the case with this unique ID.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=cases&id=1234 Response
{
  "id": "1234",
  "title": "In re: Example Litigation",
  "dockets": [
    { "docketid": "55021", "courtid": "14", "number": "1:20-cv-09876" }
  ]
}
dockets Case Dockets

Returns dockets including their entries, attributes, links, opinions, and parties. At least one parameter is required.

idReturns the docket with this unique ID (all sub-data included).
caseidReturns dockets for the given case ID.
courtidReturns dockets for the given court ID.
judgeidReturns dockets for the given judge ID.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=dockets&judgeid=77 Response
[
  {
    "docketid": "55021",
    "title": "Smith v. Acme Corp.",
    "number": "1:21-cv-00441",
    "courtid": "14",
    "judgeid": "77",
    "filed": "2021-03-04",
    "status": "Closed"
  }
]
entities Legal Entities

Returns a legal entity (company or individual). An id parameter is required.

id requiredReturns the entity with this unique ID.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=entities&id=1 Response
{
  "id": "1",
  "organization": "Apple Inc.",
  "type": "Corporation",
  "symbol": "AAPL",
  "cik": "320193"
}
patentassignments Patent Assignments

Returns USPTO patent assignment records. At least one parameter is required.

idReturns the assignment with this unique ID.
patentnumberReturns assignments for the given patent number.
applicationnumberReturns assignments for the given application number.
reelReturns assignments for the given USPTO reel number.
frameRequires reel — returns the assignment for the given reel/frame pair.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=patentassignments&reel=1000&frame=33 Response
{
  "id": "482910",
  "reel": "1000",
  "frame": "033",
  "recorded": "1985-04-22",
  "assignor": "Inventor, Jane A.",
  "assignee": "Tech Corporation",
  "patentnumber": "US4567890"
}
trademarkassignments Trademark Assignments

Returns USPTO trademark assignment records. At least one parameter is required.

idReturns the assignment with this unique ID.
reelReturns assignments for the given USPTO reel number.
frameRequires reel — returns the assignment for the given reel/frame pair.
registrationnumberReturns assignments for the given registration number.
serialnumberReturns assignments for the given serial number.
Requesthttps://www.plainsite.org/api/api.js?token=<yourtoken>&method=trademarkassignments&reel=374&frame=748 Response
{
  "id": "109234",
  "reel": "374",
  "frame": "748",
  "recorded": "2010-07-15",
  "assignor": "Original Brand Corp.",
  "assignee": "New Owner LLC",
  "serialnumber": "78123456",
  "registrationnumber": "3456789"
}

Questions? help@plainsite.org

Non-Government Works Copyright © 2001-2026 Think Computer Corporation. All Rights Reserved.

About   Apps, Extensions & AI   System Status   Privacy   Security   Contact Us

ⓘ Information Facts

Sign In Sign Up
Issues Laws Cases News Firms Entities Pro
Sign In Sign Up