{"contractVersion":"parcelops.connector.v1","name":"courtlistener","displayName":"CourtListener & RECAP","description":"U.S. court opinions and RECAP dockets, including bankruptcy-party screening and foreclosure or other real-property nature-of-suit filters. Anonymous access is supported; a free CourtListener API token is optional and raises applicable provider rate limits. RECAP is not complete PACER coverage.","tags":["court-records","bankruptcy","recap","litigation","business-screening"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"CourtListener and the RECAP Archive","sourceUrl":"https://www.courtlistener.com/","apiBaseUrl":"https://www.courtlistener.com/api/rest/v4","documentationUrl":"https://www.courtlistener.com/help/api/rest/"},"freshness":{"status":"declared","value":{"mode":"live","notes":"Envelope source.retrievedAt records the upstream retrieval time; ParcelOps caches searches for up to 1 hour and directory or disclosure lists for up to 24 hours."}},"coverage":{"geographic":{"status":"declared","value":["United States"]},"temporal":{"status":"not_declared"}},"methods":{"total":7,"items":[{"name":"searchBankruptcyDockets","description":"Screen bankruptcy dockets by party, court, and earliest filing date.","notes":"Name results are potential matches; RECAP is not complete PACER coverage.","requiredParams":["partyName"],"inputSchema":{"type":"object","properties":{"partyName":{"type":"string","minLength":1,"maxLength":200},"courtIds":{"type":"array","items":{"type":"string","minLength":2,"maxLength":20,"pattern":"^[A-Za-z0-9]+$"},"maxItems":50},"dateFiledAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"cursor":{"type":"string","maxLength":2048}},"required":["partyName"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"live"},"scope":"method"},"entities":{"status":"declared","value":["bankruptcy-docket"]},"pagination":{"status":"declared","value":{"style":"cursor","cursorField":"cursor"}},"output":{"schema":{"status":"declared","value":{"type":"object","additionalProperties":false,"required":["kind","schemaVersion","dataset","query","summary","records","pagination","source","export","privacy","caveats"],"properties":{"kind":{"const":"parcelops.public-data"},"schemaVersion":{"const":"1.0"},"dataset":{"type":"object","required":["connector","method","name","jurisdiction"],"properties":{"connector":{"const":"courtlistener"},"method":{"enum":["searchBankruptcyDockets","searchDockets","searchOpinions","searchJudges","listCourts","listFinancialDisclosures"]},"name":{"type":"string"},"jurisdiction":{"const":"United States"}}},"query":{"type":"object"},"summary":{"type":"object","required":["matchedRecords","returnedRecords","truncated"],"properties":{"matchedRecords":{"type":["integer","null"],"minimum":0},"returnedRecords":{"type":"integer","minimum":0},"truncated":{"type":"boolean"}}},"records":{"type":"array","items":{"type":"object"}},"pagination":{"type":["object","null"]},"source":{"type":"object","required":["name","url","retrievedAt"],"properties":{"name":{"const":"CourtListener and the RECAP Archive"},"url":{"type":"string","format":"uri"},"documentationUrl":{"type":"string","format":"uri"},"attribution":{"const":"Free Law Project"},"retrievedAt":{"type":"string"}}},"export":{"type":"object"},"privacy":{"type":"object"},"caveats":{"type":"array","items":{"type":"string"}}}}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["RECAP is a contributed archive and is not a complete PACER substitute.","A bankruptcy name result is a potential party match until identity is verified.","Judge-name results require identity verification.","An absent CourtListener financial-disclosure record is not proof that no disclosure exists.","A name hit is a potential party match, not proof that the audited entity filed bankruptcy."]},{"name":"searchDockets","description":"Search federal RECAP dockets by query, court, date, or nature of suit (for example, foreclosure).","inputSchema":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":300},"court":{"type":"string","minLength":2,"maxLength":20,"pattern":"^[A-Za-z0-9]+$"},"dateFiledAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"dateFiledBefore":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"date_filed_after":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"date_filed_before":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"cursor":{"type":"string","maxLength":2048},"natureOfSuit":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"integer","minimum":0,"maximum":999}]},"nature_of_suit":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"integer","minimum":0,"maximum":999}]}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"live"},"scope":"method"},"entities":{"status":"declared","value":["federal-docket"]},"pagination":{"status":"declared","value":{"style":"cursor","cursorField":"cursor"}},"output":{"schema":{"status":"declared","value":{"type":"object","additionalProperties":false,"required":["kind","schemaVersion","dataset","query","summary","records","pagination","source","export","privacy","caveats"],"properties":{"kind":{"const":"parcelops.public-data"},"schemaVersion":{"const":"1.0"},"dataset":{"type":"object","required":["connector","method","name","jurisdiction"],"properties":{"connector":{"const":"courtlistener"},"method":{"enum":["searchBankruptcyDockets","searchDockets","searchOpinions","searchJudges","listCourts","listFinancialDisclosures"]},"name":{"type":"string"},"jurisdiction":{"const":"United States"}}},"query":{"type":"object"},"summary":{"type":"object","required":["matchedRecords","returnedRecords","truncated"],"properties":{"matchedRecords":{"type":["integer","null"],"minimum":0},"returnedRecords":{"type":"integer","minimum":0},"truncated":{"type":"boolean"}}},"records":{"type":"array","items":{"type":"object"}},"pagination":{"type":["object","null"]},"source":{"type":"object","required":["name","url","retrievedAt"],"properties":{"name":{"const":"CourtListener and the RECAP Archive"},"url":{"type":"string","format":"uri"},"documentationUrl":{"type":"string","format":"uri"},"attribution":{"const":"Free Law Project"},"retrievedAt":{"type":"string"}}},"export":{"type":"object"},"privacy":{"type":"object"},"caveats":{"type":"array","items":{"type":"string"}}}}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["RECAP is a contributed archive and is not a complete PACER substitute.","A bankruptcy name result is a potential party match until identity is verified.","Judge-name results require identity verification.","An absent CourtListener financial-disclosure record is not proof that no disclosure exists.","Nature-of-suit filters reflect court coding and can omit cases with malformed or missing codes."]},{"name":"searchOpinions","description":"Search U.S. judicial opinions by query, court, or filing date.","inputSchema":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":300},"court":{"type":"string","minLength":2,"maxLength":20,"pattern":"^[A-Za-z0-9]+$"},"dateFiledAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"dateFiledBefore":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"date_filed_after":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"date_filed_before":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"cursor":{"type":"string","maxLength":2048}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"live"},"scope":"method"},"entities":{"status":"declared","value":["judicial-opinion"]},"pagination":{"status":"declared","value":{"style":"cursor","cursorField":"cursor"}},"output":{"schema":{"status":"declared","value":{"type":"object","additionalProperties":false,"required":["kind","schemaVersion","dataset","query","summary","records","pagination","source","export","privacy","caveats"],"properties":{"kind":{"const":"parcelops.public-data"},"schemaVersion":{"const":"1.0"},"dataset":{"type":"object","required":["connector","method","name","jurisdiction"],"properties":{"connector":{"const":"courtlistener"},"method":{"enum":["searchBankruptcyDockets","searchDockets","searchOpinions","searchJudges","listCourts","listFinancialDisclosures"]},"name":{"type":"string"},"jurisdiction":{"const":"United States"}}},"query":{"type":"object"},"summary":{"type":"object","required":["matchedRecords","returnedRecords","truncated"],"properties":{"matchedRecords":{"type":["integer","null"],"minimum":0},"returnedRecords":{"type":"integer","minimum":0},"truncated":{"type":"boolean"}}},"records":{"type":"array","items":{"type":"object"}},"pagination":{"type":["object","null"]},"source":{"type":"object","required":["name","url","retrievedAt"],"properties":{"name":{"const":"CourtListener and the RECAP Archive"},"url":{"type":"string","format":"uri"},"documentationUrl":{"type":"string","format":"uri"},"attribution":{"const":"Free Law Project"},"retrievedAt":{"type":"string"}}},"export":{"type":"object"},"privacy":{"type":"object"},"caveats":{"type":"array","items":{"type":"string"}}}}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["RECAP is a contributed archive and is not a complete PACER substitute.","A bankruptcy name result is a potential party match until identity is verified.","Judge-name results require identity verification.","An absent CourtListener financial-disclosure record is not proof that no disclosure exists."]},{"name":"searchJudges","description":"Search CourtListener people records for judges by a bounded query.","requiredParams":["q"],"inputSchema":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":300},"cursor":{"type":"string","maxLength":2048}},"required":["q"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"live","notes":"Responses may be served from the ParcelOps cache for up to 1 hour; source.retrievedAt records the upstream retrieval time."},"scope":"method"},"entities":{"status":"declared","value":["judicial-person"]},"pagination":{"status":"declared","value":{"style":"cursor","cursorField":"cursor"}},"output":{"schema":{"status":"declared","value":{"type":"object","additionalProperties":false,"required":["kind","schemaVersion","dataset","query","summary","records","pagination","source","export","privacy","caveats"],"properties":{"kind":{"const":"parcelops.public-data"},"schemaVersion":{"const":"1.0"},"dataset":{"type":"object","required":["connector","method","name","jurisdiction"],"properties":{"connector":{"const":"courtlistener"},"method":{"enum":["searchBankruptcyDockets","searchDockets","searchOpinions","searchJudges","listCourts","listFinancialDisclosures"]},"name":{"type":"string"},"jurisdiction":{"const":"United States"}}},"query":{"type":"object"},"summary":{"type":"object","required":["matchedRecords","returnedRecords","truncated"],"properties":{"matchedRecords":{"type":["integer","null"],"minimum":0},"returnedRecords":{"type":"integer","minimum":0},"truncated":{"type":"boolean"}}},"records":{"type":"array","items":{"type":"object"}},"pagination":{"type":["object","null"]},"source":{"type":"object","required":["name","url","retrievedAt"],"properties":{"name":{"const":"CourtListener and the RECAP Archive"},"url":{"type":"string","format":"uri"},"documentationUrl":{"type":"string","format":"uri"},"attribution":{"const":"Free Law Project"},"retrievedAt":{"type":"string"}}},"export":{"type":"object"},"privacy":{"type":"object"},"caveats":{"type":"array","items":{"type":"string"}}}}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["RECAP is a contributed archive and is not a complete PACER substitute.","A bankruptcy name result is a potential party match until identity is verified.","Judge-name results require identity verification.","An absent CourtListener financial-disclosure record is not proof that no disclosure exists.","A name result is a possible person match; verify identity before relying on it."]},{"name":"listCourts","description":"List courts with their jurisdiction, dates, and source identifiers.","inputSchema":{"type":"object","properties":{"cursor":{"type":"string","maxLength":2048}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"live","notes":"Responses may be served from the ParcelOps cache for up to 24 hours; source.retrievedAt records the upstream retrieval time."},"scope":"method"},"entities":{"status":"declared","value":["court"]},"pagination":{"status":"declared","value":{"style":"cursor","cursorField":"cursor"}},"output":{"schema":{"status":"declared","value":{"type":"object","additionalProperties":false,"required":["kind","schemaVersion","dataset","query","summary","records","pagination","source","export","privacy","caveats"],"properties":{"kind":{"const":"parcelops.public-data"},"schemaVersion":{"const":"1.0"},"dataset":{"type":"object","required":["connector","method","name","jurisdiction"],"properties":{"connector":{"const":"courtlistener"},"method":{"enum":["searchBankruptcyDockets","searchDockets","searchOpinions","searchJudges","listCourts","listFinancialDisclosures"]},"name":{"type":"string"},"jurisdiction":{"const":"United States"}}},"query":{"type":"object"},"summary":{"type":"object","required":["matchedRecords","returnedRecords","truncated"],"properties":{"matchedRecords":{"type":["integer","null"],"minimum":0},"returnedRecords":{"type":"integer","minimum":0},"truncated":{"type":"boolean"}}},"records":{"type":"array","items":{"type":"object"}},"pagination":{"type":["object","null"]},"source":{"type":"object","required":["name","url","retrievedAt"],"properties":{"name":{"const":"CourtListener and the RECAP Archive"},"url":{"type":"string","format":"uri"},"documentationUrl":{"type":"string","format":"uri"},"attribution":{"const":"Free Law Project"},"retrievedAt":{"type":"string"}}},"export":{"type":"object"},"privacy":{"type":"object"},"caveats":{"type":"array","items":{"type":"string"}}}}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["RECAP is a contributed archive and is not a complete PACER substitute.","A bankruptcy name result is a potential party match until identity is verified.","Judge-name results require identity verification.","An absent CourtListener financial-disclosure record is not proof that no disclosure exists."]},{"name":"listFinancialDisclosures","description":"List judicial financial-disclosure records with bounded pagination.","inputSchema":{"type":"object","properties":{"cursor":{"type":"string","maxLength":2048}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"live","notes":"Responses may be served from the ParcelOps cache for up to 24 hours; source.retrievedAt records the upstream retrieval time."},"scope":"method"},"entities":{"status":"declared","value":["judicial-financial-disclosure"]},"pagination":{"status":"declared","value":{"style":"cursor","cursorField":"cursor"}},"output":{"schema":{"status":"declared","value":{"type":"object","additionalProperties":false,"required":["kind","schemaVersion","dataset","query","summary","records","pagination","source","export","privacy","caveats"],"properties":{"kind":{"const":"parcelops.public-data"},"schemaVersion":{"const":"1.0"},"dataset":{"type":"object","required":["connector","method","name","jurisdiction"],"properties":{"connector":{"const":"courtlistener"},"method":{"enum":["searchBankruptcyDockets","searchDockets","searchOpinions","searchJudges","listCourts","listFinancialDisclosures"]},"name":{"type":"string"},"jurisdiction":{"const":"United States"}}},"query":{"type":"object"},"summary":{"type":"object","required":["matchedRecords","returnedRecords","truncated"],"properties":{"matchedRecords":{"type":["integer","null"],"minimum":0},"returnedRecords":{"type":"integer","minimum":0},"truncated":{"type":"boolean"}}},"records":{"type":"array","items":{"type":"object"}},"pagination":{"type":["object","null"]},"source":{"type":"object","required":["name","url","retrievedAt"],"properties":{"name":{"const":"CourtListener and the RECAP Archive"},"url":{"type":"string","format":"uri"},"documentationUrl":{"type":"string","format":"uri"},"attribution":{"const":"Free Law Project"},"retrievedAt":{"type":"string"}}},"export":{"type":"object"},"privacy":{"type":"object"},"caveats":{"type":"array","items":{"type":"string"}}}}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["RECAP is a contributed archive and is not a complete PACER substitute.","A bankruptcy name result is a potential party match until identity is verified.","Judge-name results require identity verification.","An absent CourtListener financial-disclosure record is not proof that no disclosure exists.","An absent CourtListener record is not proof that no judicial financial disclosure exists."]},{"name":"getServiceInfo","description":"Describe token auth, rate limits, pagination, coverage, and caveats.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"live","notes":"Envelope source.retrievedAt records the upstream retrieval time; ParcelOps caches searches for up to 1 hour and directory or disclosure lists for up to 24 hours."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["RECAP is a contributed archive and is not a complete PACER substitute.","A bankruptcy name result is a potential party match until identity is verified.","Judge-name results require identity verification.","An absent CourtListener financial-disclosure record is not proof that no disclosure exists."]}]},"caveats":["RECAP is a contributed archive and is not a complete PACER substitute.","A bankruptcy name result is a potential party match until identity is verified.","Judge-name results require identity verification.","An absent CourtListener financial-disclosure record is not proof that no disclosure exists."]}