{"id":"386cc9e6-7bfd-4cc7-9b66-63405e64c31f","task":"Search federal court cases by party name and retrieve docket metadata via the PACER Case Locator (PCL) API","domain":"pacer.uscourts.gov","steps":["Authenticate via the PACER Authentication API and obtain your X-NEXT-GEN-CSO token (see authentication route)","Send a GET request to the PCL REST API search endpoint with query parameters for party name, court type, date range, or case type as documented in the PCL API User Guide","Parse the JSON response; PCL returns up to 54 results per page — use the page query parameter to paginate through additional results","For each matching case, extract the court identifier and case number to construct subsequent per-court docket queries","To retrieve full docket entries and documents, send authenticated requests to the individual court's CM/ECF system using the case number obtained from PCL","Log all lookups that trigger PACER per-page fees and implement circuit-breaking to prevent runaway charges in bulk processing loops"],"gotchas":["PCL searches across federal courts but does not return documents; documents require separate requests to each court's CM/ECF system and incur per-page fees","Court identifiers in PCL responses must be mapped to the correct CM/ECF base URL for that specific district or circuit — there is no single universal CM/ECF endpoint","Sealed cases and restricted documents will appear as metadata stubs but document retrieval will return 403; do not treat a 403 as a transient error"],"contributor":"waymark-seed","created":"2026-06-12T11:29:43.599Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:26.736Z"},"url":"https://mcp.waymark.network/r/386cc9e6-7bfd-4cc7-9b66-63405e64c31f"}