{ "openapi": "3.0.1", "info": { "title": "US Court Filing Alerts (CourtListener)", "description": "Search US court opinions and federal dockets, or watch dockets for new filings, using the CourtListener API. Needs your own free CourtListener token. Public court records, not legal advice. Pay per row.", "version": "0.0", "x-build-id": "bwhjaoj8bNCjcgUVW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/texxupport~court-filing-alerts-courtlistener/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-texxupport-court-filing-alerts-courtlistener", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/texxupport~court-filing-alerts-courtlistener/runs": { "post": { "operationId": "runs-sync-texxupport-court-filing-alerts-courtlistener", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/texxupport~court-filing-alerts-courtlistener/run-sync": { "post": { "operationId": "run-sync-texxupport-court-filing-alerts-courtlistener", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "courtListenerToken": { "title": "CourtListener API token", "type": "string", "description": "Required unless the Actor's owner has set one. Free: create a CourtListener account, open the API page of your profile and copy your token. Free accounts have small limits (a few requests a minute, tens an hour, about a hundred a day), so this Actor keeps its requests low." }, "mode": { "title": "What to do", "enum": [ "opinions", "dockets", "docket-entries" ], "type": "string", "description": "Opinions searches case law, including unpublished rulings unless you turn that off. Dockets searches federal case dockets, including bankruptcy courts. Docket entries watches the dockets you list for new filings.", "default": "opinions" }, "queries": { "title": "Search queries (opinions and dockets modes)", "type": "array", "description": "Each query is a separate search and uses at least one request. Quotes match phrases, and AND, OR and NOT work as on the CourtListener website.", "items": { "type": "string" } }, "courts": { "title": "Courts (optional)", "type": "array", "description": "CourtListener court codes such as scotus, ca9, cand or nysb (a bankruptcy court). Leave empty for all courts.", "items": { "type": "string" } }, "caseName": { "title": "Case name (optional)", "type": "string", "description": "Only cases whose name matches this text." }, "docketNumber": { "title": "Docket number (optional)", "type": "string", "description": "Only dockets with this docket number, for example 1:24-cv-01234." }, "includeUnpublished": { "title": "Include unpublished rulings", "type": "boolean", "description": "CourtListener leaves out unpublished and unknown-status opinions unless asked, which hides many trial-court rulings. Leave this on to include them. Opinions search only.", "default": true }, "docketIds": { "title": "Dockets to watch (docket-entries mode)", "type": "array", "description": "CourtListener docket numbers such as 4214664, or the address of a docket page on CourtListener. Find a docket's number with the dockets mode.", "items": { "type": "string" } }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 3650, "type": "integer", "description": "How far back to look, counted from the end date. Ignored when you fill in a start date.", "default": 7 }, "dateFrom": { "title": "Start date (optional)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "First filing date to include, written YYYY-MM-DD." }, "dateTo": { "title": "End date (optional)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Last filing date to include, written YYYY-MM-DD. Defaults to today (UTC)." }, "onlyNew": { "title": "Only results not delivered before", "type": "boolean", "description": "Turn this on and run the Actor on a schedule to get an alert-style feed. The Actor remembers what it delivered for each search or docket.", "default": true }, "maxResults": { "title": "Maximum rows", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many rows. You pay per row delivered, so this also caps your cost.", "default": 100 }, "maxRequests": { "title": "Maximum requests to CourtListener", "minimum": 1, "maximum": 100, "type": "integer", "description": "Safety limit per run. Each page of up to 20 results is one request, and every request counts against your free allowance. Raise it only if you need more pages.", "default": 5 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }