Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.judit.io/llms.txt

Use this file to discover all available pages before exploring further.

Public beta. Miner is a new Judit product in open beta. The endpoints and pricing model documented here are stable, but small adjustments may happen during this phase. We recommend pinning the contract version and following docs.judit.io/en/resource/changelog.
Miner API usage pricing is not included in the JUDIT Miner Platform license. API consumption is billed separately, in credits, per the Credits & billing tiers. Confirm the active tiers for your account with the commercial team before running production queries.
Judit Miner is a product dedicated to discovering judicial assets at scale: paid or in-payment judgement bonds (judgement-bond) and sentence executions with recovery potential (sentence-execution). Instead of going lawsuit by lawsuit, you define a set of filters (courts, amount range, natures, tags) and Judit identifies every lawsuit that fits — automatically excluding the ones your company has already retrieved.
🤖 Base host: https://miner.production.judit.io. Authentication via the api-key header (same key used across Judit products, with miner_enabled granted). Pricing is credit-based — every find is priced by tier before processing.

What Miner does

Find judgement bonds

Identify federal, state and municipal judgement bonds by budget year, nature (alimentary/common) and court. Ideal for credit-rights funds and recovery practices.

Map sentence executions

Detect executions with signs of approved calculation, possible bond or already-issued bond. Ideal for sourcing credit-rights portfolios.

Amount range filters

Slice by free min/max or pre-defined tiers (0-100k, 100k-250k, 250k-500k, 500k-750k, 750k-1.5M, 1.5M+).

No repeats across queries

count automatically excludes lawsuits your company has already retrieved — you only pay for what you haven’t seen.

How it works

Miner follows a 3-step flow: estimatepurchasepaginate.
StepEndpointPurpose
1. CountPOST /requests/countKnow how many lawsuits match your filters, no credit cost. Synchronous response.
2. Create findPOST /requests/createTrigger the real query. Returns cost (credits charged) and status: pending.
3. TrackGET /requests/{request_id}Poll until status: completed.
4. CollectGET /responses?request_id=...List the returned lawsuits, paginated (up to 100 per page).

Who it’s for

Credit-rights funds

Mass sourcing of judgement bonds and judicial credits — with fine-grained filters by amount and court.

Recovery law firms

Identify executions with signs of approved calculation or imminent bond for proactive outreach.

Banks and fintechs

Curate baskets of judicial assets for portfolio analysis and securitization.

Marketplace platforms

Feed bond-marketplace listings with always-fresh inventory.

What’s not in Miner

Miner focuses on asset discovery based on lawsuit attributes. For any other case, the corresponding products remain available and bill normally.

Next steps

Quickstart

Run your first query in under 10 minutes.

Concepts

Understand kind, natures, tags, amount tiers and combination rules.

Credits & billing

How cost is computed, price tiers and handling of billing errors.

Supported courts

Full list of IDs and acronyms for the tribunals filter.