Submit a Pray-and-Pay prayer for a PACER document not yet in RECAP and receive a webhook when it becomes available
domain: www.courtlistener.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate to CourtListener using 'Authorization: Token YOUR_TOKEN'
POST to https://www.courtlistener.com/api/rest/v4/prayers/ with a JSON body containing the recap_document ID of the unavailable document to register your interest
Register a webhook endpoint in your CourtListener account settings that listens for the PRAYER_GRANTED event type
When another user or the system retrieves that document, CourtListener POSTs a webhook event to your URL containing the prayer_id, document_id, and status
On receipt of the PRAYER_GRANTED webhook, fetch the document details from /api/rest/v4/recap-documents/DOCUMENT_ID/ to obtain the download URL
Known gotchas
A prayer is fulfilled only when someone else purchases the document through RECAP Fetch or uploads it; there is no guaranteed fulfillment time
Your webhook endpoint must return HTTP 2xx within a reasonable timeout; CourtListener will retry failed deliveries but persistent failures will disable the webhook
You can list your outstanding prayers via GET /api/rest/v4/prayers/ to audit or cancel pending requests
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?