{ "openapi": "3.0.1", "info": { "title": "CourtListener Bankruptcy Scraper - Dockets by Chapter", "description": "Scrape US bankruptcy dockets from CourtListener's RECAP archive by chapter, court, debtor, trustee and date, with judges and filings. Export to CSV, JSON, Excel or XML.", "version": "0.1", "x-build-id": "onTOcwkCY39EEoZKt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~courtlistener-bankruptcy-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-courtlistener-bankruptcy-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-bankruptcy-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-courtlistener-bankruptcy-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-bankruptcy-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-courtlistener-bankruptcy-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": { "dataset": { "title": "What to return", "enum": [ "cases", "dockets" ], "type": "string", "description": "Cases returns one row per bankruptcy petition with the filings that matched your query attached. Dockets is the same case row without the document list, which is faster when you only need case metadata.", "default": "cases" }, "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. Leave empty on a paid plan for 100 rows." }, "chapters": { "title": "Chapter", "uniqueItems": true, "type": "array", "description": "Which chapters of the US Bankruptcy Code to return. Leave empty to take every chapter. Chapter 11 is corporate reorganization, chapter 7 is liquidation, chapter 13 is an individual repayment plan.", "items": { "type": "string", "enum": [ "7", "9", "11", "12", "13", "15" ], "enumTitles": [ "Chapter 7 - Liquidation", "Chapter 9 - Municipality", "Chapter 11 - Reorganization", "Chapter 12 - Family farmer or fisherman", "Chapter 13 - Individual repayment plan", "Chapter 15 - Cross-border insolvency" ] } }, "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 at once.", "items": { "type": "string", "enum": [ "almb", "alnb", "alsb", "akb", "arb", "areb", "arwb", "cacb", "caeb", "canb", "casb", "cob", "ctb", "deb", "dcb", "flmb", "flnb", "flsb", "gamb", "ganb", "gasb", "hib", "idb", "ilcb", "ilnb", "ilsb", "innb", "insb", "ianb", "iasb", "ksb", "kyeb", "kywb", "laeb", "lamb", "lawb", "meb", "mdb", "mab", "mieb", "miwb", "mnb", "msnb", "mssb", "moeb", "mowb", "mtb", "nebraskab", "nvb", "nhb", "njb", "nmb", "nyeb", "nynb", "nysb", "nywb", "nceb", "ncmb", "ncwb", "ndb", "ohnb", "ohsb", "okeb", "oknb", "okwb", "orb", "paeb", "pamb", "pawb", "rib", "scb", "sdb", "tneb", "tnmb", "tnwb", "txeb", "txnb", "txsb", "txwb", "utb", "vtb", "vaeb", "vawb", "waeb", "wawb", "wvnb", "wvsb", "wieb", "wiwb", "wyb", "gub", "nmib", "prb", "vib" ], "enumTitles": [ "M.D. Alabama (almb)", "N.D. Alabama (alnb)", "S.D. Alabama (alsb)", "D. Alaska (akb)", "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)", "D. Delaware (deb)", "District of Columbia (dcb)", "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. Hawaii (hib)", "D. Idaho (idb)", "C.D. Illinois (ilcb)", "N.D. Illinois (ilnb)", "S.D. Illinois (ilsb)", "N.D. Indiana (innb)", "S.D. Indiana (insb)", "N.D. Iowa (ianb)", "S.D. Iowa (iasb)", "D. Kansas (ksb)", "E.D. Kentucky (kyeb)", "W.D. Kentucky (kywb)", "E.D. Louisiana (laeb)", "M.D. Louisiana (lamb)", "W.D. Louisiana (lawb)", "D. Maine (meb)", "D. Maryland (mdb)", "D. Massachusetts (mab)", "E.D. Michigan (mieb)", "W.D. Michigan (miwb)", "D. Minnesota (mnb)", "N.D. Mississippi (msnb)", "S.D. Mississippi (mssb)", "E.D. Missouri (moeb)", "W.D. Missouri (mowb)", "D. Montana (mtb)", "D. Nebraska (nebraskab)", "D. Nevada (nvb)", "D. New Hampshire (nhb)", "D. New Jersey (njb)", "D. New Mexico (nmb)", "E.D. New York (nyeb)", "N.D. New York (nynb)", "S.D. New York (nysb)", "W.D. New York (nywb)", "E.D. North Carolina (nceb)", "M.D. North Carolina (ncmb)", "W.D. North Carolina (ncwb)", "D. North Dakota (ndb)", "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. 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)", "D. Vermont (vtb)", "E.D. Virginia (vaeb)", "W.D. Virginia (vawb)", "E.D. Washington (waeb)", "W.D. Washington (wawb)", "N.D. West Virginia (wvnb)", "S.D. West Virginia (wvsb)", "E.D. Wisconsin (wieb)", "W.D. Wisconsin (wiwb)", "D. Wyoming (wyb)", "D. Guam (gub)", "Northern Mariana Islands (nmib)", "D. Puerto Rico (prb)", "D. Virgin Islands (vib)" ] } }, "query": { "title": "Search query", "type": "string", "description": "Full-text query across the case caption, debtor names and filing text. Supports quoted phrases and AND/OR/NOT. Leave empty to browse with the filters alone." }, "caseName": { "title": "Debtor or case name", "type": "string", "description": "Match words in the case caption, which on a bankruptcy petition is the debtor's name, for example \"holdings\" or \"smith\"." }, "partyName": { "title": "Party name", "type": "string", "description": "Name of a party recorded on the docket, for example a debtor, a joint debtor or a creditor that appeared." }, "docketNumber": { "title": "Docket number", "type": "string", "description": "Exact bankruptcy docket number, for example 26-12130 or 3:26-bk-04298. Pair it with a court for a single case." }, "filedAfter": { "title": "Filed on or after", "type": "string", "description": "Earliest date, as MM/DD/YYYY or YYYY-MM-DD. Measured 2026-09-08: CourtListener applies this window to the date the docket entered the RECAP archive, which is the same day for a fresh filing and can be years later for a backfilled case, so the dateFiled column can fall outside it. RECAP also adds the judge, the trustee and counsel over the weeks after a petition is docketed, so a settled window returns fuller rows than the last few days." }, "filedBefore": { "title": "Filed on or before", "type": "string", "description": "Latest date, as MM/DD/YYYY or YYYY-MM-DD. Same caveat as the field above: the window applies to the RECAP ingest date, not to the dateFiled column." }, "availableOnly": { "title": "Only cases with free PDFs", "type": "boolean", "description": "Keep only cases 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 petition, plan, discharge, 341 or motion." }, "documentNumber": { "title": "Document number", "type": "string", "description": "Filter to a specific document number within the docket, for example 1 for the voluntary petition." }, "includeTimeline": { "title": "Include the full docket timeline", "type": "boolean", "description": "Look up every docket entry for each case, not just the ones that matched the query. Adds the timeline and timelineEntryCount columns and costs one extra request per case, so runs are slower.", "default": false }, "timelineLimit": { "title": "Timeline entries per case", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many docket entries to attach when the timeline is on. Oldest 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 } } } } } } } } } }