{ "openapi": "3.0.1", "info": { "title": "CourtListener Adversary Proceedings Scraper - Bankruptcy", "description": "Scrape bankruptcy adversary proceedings from CourtListener RECAP by nature of suit, court, party and date, with judges and counsel. Export to CSV, JSON, Excel or XML.", "version": "0.2", "x-build-id": "n8boISavbvwhOrhh3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~courtlistener-adversary-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-courtlistener-adversary-scraper", "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/parseforge~courtlistener-adversary-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-courtlistener-adversary-scraper", "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/parseforge~courtlistener-adversary-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-courtlistener-adversary-scraper", "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": { "natureOfSuitCategories": { "title": "Type of adversary action", "uniqueItems": true, "type": "array", "description": "The kind of lawsuit to collect, using the Form B1040 nature-of-suit groups every adversary complaint is filed under. Each group expands to its codes and is searched in turn. Leave empty to screen the whole bankruptcy feed instead, which is slower because CourtListener can no longer filter server side.", "items": { "type": "string", "enum": [ "recovery", "lien", "sale", "discharge", "dischargeability", "injunctive", "subordination", "declaratory", "other" ], "enumTitles": [ "Recovery of money or property (11, 12, 13, 14)", "Lien validity, priority or extent (21)", "Sale of estate property (31)", "Objection to discharge or confirmation (41, 51)", "Dischargeability of a debt (61, 62, 63, 64, 65, 66, 67, 68)", "Injunctive relief (71, 72)", "Subordination of a claim (81)", "Declaratory judgment (91)", "Other adversary action (02)" ] } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000. Split evenly across the selected nature-of-suit codes. Leave empty on a paid plan for 100 rows." }, "natureOfSuitCodes": { "title": "Exact nature-of-suit codes", "uniqueItems": true, "type": "array", "description": "Pick individual Form B1040 codes instead of whole groups, for example 12 for a preference action or 68 for willful and malicious injury. Combines with the groups above.", "items": { "type": "string", "enum": [ "11", "12", "13", "14", "21", "31", "41", "51", "61", "62", "63", "64", "65", "66", "67", "68", "71", "72", "81", "91", "02" ], "enumTitles": [ "11 - Recovery of money/property - 542 turnover of property", "12 - Recovery of money/property - 547 preference", "13 - Recovery of money/property - 548 fraudulent transfer", "14 - Recovery of money/property - other", "21 - Validity, priority or extent of lien or other interest in property", "31 - Approval of sale of property of estate and of a co-owner - 363(h)", "41 - Objection / revocation of discharge - 727(c),(d),(e)", "51 - Revocation of confirmation", "61 - Dischargeability - 523(a)(5), domestic support", "62 - Dischargeability - 523(a)(2), false pretenses, false representation, actual fraud", "63 - Dischargeability - 523(a)(8), student loan", "64 - Dischargeability - 523(a)(15), divorce/sep property settlement/decree", "65 - Dischargeability - other", "66 - Dischargeability - 523(a)(1),(14),(14A) priority tax claims", "67 - Dischargeability - 523(a)(4), fraud as fiduciary, embezzlement, larceny", "68 - Dischargeability - 523(a)(6), willful and malicious injury", "71 - Injunctive relief - reinstatement of stay", "72 - Injunctive relief - other", "81 - Subordination of claim or interest", "91 - Declaratory judgment", "02 - Other (e.g. other actions that would have been brought in state court if unrelated to bankruptcy)" ] } }, "courts": { "title": "Bankruptcy courts", "uniqueItems": true, "type": "array", "description": "Restrict the search to one or more of the 94 United States bankruptcy courts. Leave empty to search all of them.", "items": { "type": "string", "enum": [ "akb", "almb", "alnb", "alsb", "arb", "areb", "arwb", "cacb", "caeb", "canb", "casb", "cob", "ctb", "dcb", "deb", "flmb", "flnb", "flsb", "gamb", "ganb", "gasb", "gub", "hib", "ianb", "iasb", "idb", "ilcb", "ilnb", "ilsb", "innb", "insb", "ksb", "kyeb", "kywb", "laeb", "lamb", "lawb", "mab", "mdb", "meb", "mieb", "miwb", "mnb", "moeb", "mowb", "msnb", "mssb", "mtb", "nceb", "ncmb", "ncwb", "ndb", "nebraskab", "nhb", "njb", "nmb", "nmib", "nvb", "nyeb", "nynb", "nysb", "nywb", "ohnb", "ohsb", "okeb", "oknb", "okwb", "orb", "paeb", "pamb", "pawb", "prb", "rib", "scb", "sdb", "tneb", "tnmb", "tnwb", "txeb", "txnb", "txsb", "txwb", "utb", "vaeb", "vawb", "vib", "vtb", "waeb", "wawb", "wieb", "wiwb", "wvnb", "wvsb", "wyb" ], "enumTitles": [ "D. Alaska (akb)", "M.D. Alabama (almb)", "N.D. Alabama (alnb)", "S.D. Alabama (alsb)", "D. Arizona (arb)", "E.D. Arkansas (areb)", "W.D. Arkansas (arwb)", "C.D. California (cacb)", "E.D. California (caeb)", "N.D. California (canb)", "S.D. California (casb)", "D. Colorado (cob)", "D. Connecticut (ctb)", "District of Columbia (dcb)", "D. Delaware (deb)", "M.D. Florida (flmb)", "N.D. Florida (flnb)", "S.D. Florida (flsb)", "M.D. Georgia (gamb)", "N.D. Georgia (ganb)", "S.D. Georgia (gasb)", "D. Guam (gub)", "D. Hawaii (hib)", "N.D. Iowa (ianb)", "S.D. Iowa (iasb)", "D. Idaho (idb)", "C.D. Illinois (ilcb)", "N.D. Illinois (ilnb)", "S.D. Illinois (ilsb)", "N.D. Indiana (innb)", "S.D. Indiana (insb)", "D. Kansas (ksb)", "E.D. Kentucky (kyeb)", "W.D. Kentucky (kywb)", "E.D. Louisiana (laeb)", "M.D. Louisiana (lamb)", "W.D. Louisiana (lawb)", "D. Massachusetts (mab)", "D. Maryland (mdb)", "D. Maine (meb)", "E.D. Michigan (mieb)", "W.D. Michigan (miwb)", "D. Minnesota (mnb)", "E.D. Missouri (moeb)", "W.D. Missouri (mowb)", "N.D. Mississippi (msnb)", "S.D. Mississippi (mssb)", "D. Montana (mtb)", "E.D. North Carolina (nceb)", "M.D. North Carolina (ncmb)", "W.D. North Carolina (ncwb)", "D. North Dakota (ndb)", "D. Nebraska (nebraskab)", "D. New Hampshire (nhb)", "D. New Jersey (njb)", "D. New Mexico (nmb)", "Northern Mariana Islands (nmib)", "D. Nevada (nvb)", "E.D. New York (nyeb)", "N.D. New York (nynb)", "S.D. New York (nysb)", "W.D. New York (nywb)", "N.D. Ohio (ohnb)", "S.D. Ohio (ohsb)", "E.D. Oklahoma (okeb)", "N.D. Oklahoma (oknb)", "W.D. Oklahoma (okwb)", "D. Oregon (orb)", "E.D. Pennsylvania (paeb)", "M.D. Pennsylvania (pamb)", "W.D. Pennsylvania (pawb)", "D. Puerto Rico (prb)", "D. Rhode Island (rib)", "D. South Carolina (scb)", "D. South Dakota (sdb)", "E.D. Tennessee (tneb)", "M.D. Tennessee (tnmb)", "W.D. Tennessee (tnwb)", "E.D. Texas (txeb)", "N.D. Texas (txnb)", "S.D. Texas (txsb)", "W.D. Texas (txwb)", "D. Utah (utb)", "E.D. Virginia (vaeb)", "W.D. Virginia (vawb)", "D. Virgin Islands (vib)", "D. Vermont (vtb)", "E.D. Washington (waeb)", "W.D. Washington (wawb)", "E.D. Wisconsin (wieb)", "W.D. Wisconsin (wiwb)", "N.D. West Virginia (wvnb)", "S.D. West Virginia (wvsb)", "D. Wyoming (wyb)" ] } }, "query": { "title": "Search query", "type": "string", "description": "Full-text query across the case caption, parties and filing text. Supports quoted phrases and AND/OR/NOT. Leave empty to browse with the filters alone." }, "caseName": { "title": "Case name", "type": "string", "description": "Match words in the adversary caption, for example \"trustee\" or a debtor surname." }, "docketNumber": { "title": "Adversary docket number", "type": "string", "description": "Exact adversary docket number, for example 26-01087 or 2:26-ap-01234." }, "partyName": { "title": "Party name", "type": "string", "description": "Name of a plaintiff, defendant or trustee in the proceeding, for example \"Wells Fargo\"." }, "filedAfter": { "title": "Filed on or after", "type": "string", "description": "Earliest filing date of the adversary complaint, as MM/DD/YYYY or YYYY-MM-DD." }, "filedBefore": { "title": "Filed on or before", "type": "string", "description": "Latest filing date of the adversary complaint, as MM/DD/YYYY or YYYY-MM-DD." }, "pendingOnly": { "title": "Only pending proceedings", "type": "boolean", "description": "Drop proceedings that already have a termination date, leaving only live litigation.", "default": false }, "availableOnly": { "title": "Only proceedings with free PDFs", "type": "boolean", "description": "Keep only proceedings whose filings are already in the free RECAP archive rather than paywalled behind PACER.", "default": false }, "entryDescription": { "title": "Docket entry text", "type": "string", "description": "Match words in the docket entry description, for example complaint, summons or default judgment." }, "documentNumber": { "title": "Document number", "type": "string", "description": "Filter to a specific document number within the adversary docket, for example 1 for the complaint." }, "includeTimeline": { "title": "Include the full docket timeline", "type": "boolean", "description": "Look up every docket entry for each proceeding, not just the ones that matched the query. Adds the timeline and timelineEntryCount columns and costs at least one extra request per proceeding.", "default": false }, "timelineLimit": { "title": "Timeline entries per proceeding", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many docket entries to attach when the timeline is on. Older entries come first.", "default": 20 }, "orderBy": { "title": "Sort order", "enum": [ "dateFiled desc", "dateFiled asc", "score desc", "entry_date_filed desc", "entry_date_filed asc" ], "type": "string", "description": "How to order results. Relevance only means anything when a search query is set.", "default": "dateFiled desc" }, "courtListenerKey": { "title": "CourtListener API key (optional)", "type": "string", "description": "A free CourtListener API key (Profile > API on courtlistener.com) lifts the anonymous throttle and makes long runs faster. Leave empty to run anonymously." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Off by default: the CourtListener API is open. Turn it on for long anonymous runs so each request gets a fresh exit IP and its own throttle allowance. Not used when an API key is supplied.", "default": { "useApifyProxy": false } } } }, "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 } } }, "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 } } } } } } } } } }