# CourtListener New US Court Opinions Monitor

> CourtListener New US Court Opinions Monitor is a paid API for AI agents from oracles-production.up.railway.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns new US court opinions from CourtListener since a given timestamp, including case name, court, filing date, docket, precedential status, and citations.

## Facts

- Endpoint: GET https://oracles-production.up.railway.app/v1/court-opinions/changes
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/courtlistener-new-us-court-opinions-monitor-73609bbd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d4dYM6YjUZExJJw_iUM3R

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability courtlistener-new-us-court-opinions-monitor-73609bbd
```

Example prompt: Pull all new US court opinions from CourtListener since 2025-06-01T00:00:00Z, limit to 50 results, and only show me ones with a significance score of at least 5.

## When to prefer this

Use this endpoint when you need to monitor or retrieve newly published US court opinions since a specific point in time, especially for litigation monitoring, legal research pipelines, or compliance workflows that care about new case law. Prefer this over Federal Register endpoints when the focus is on court decisions rather than regulatory rules, and over general legal databases when you need a lightweight, timestamped change feed with significance scoring powered by CourtListener data.

## Known failure modes

- COURTLISTENER_API_TOKEN not set — endpoint is a no-op and returns empty results
- Invalid or missing 'since' parameter causes a 400 error
- 'since' timestamp in wrong format (not ISO-8601) causes a validation error
- Limit exceeds 500 or is below 1 causes a schema validation error
- CourtListener upstream API is unavailable, resulting in a 502 or empty response
- min_significance out of range (not 1-10) causes a validation error

## How this service works

New US court opinions from CourtListener since a timestamp — case name, court, filing date, docket, precedential status, and citations. For legal-research and litigation-monitoring agents.

## Output

Returns a JSON array of court opinion change objects, each with a case title, court identifier, docket number, filing/effective date, precedential status, citations, a significance score (1-10), a source URL for verification, and a summary. Also includes a total count and the data source label.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 500,
       "minimum": 1
      },
      "since": {
       "type": "string",
       "format": "date-time",
       "description": "Only changes detected after this ISO-8601 instant"
      },
      "min_significance": {
       "type": "integer",
       "maximum": 10,
       "minimum": 1,
       "description": "Keep only changes scored at least this"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "integer"
      },
      "source": {
       "type": "string"
      },
      "changes": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "type": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "detail": {
          "type": "object"
         },
         "summary": {
          "type": "string"
         },
         "entityId": {
          "type": "string"
         },
         "sourceUrl": {
          "type": [
           "string",
           "null"
          ],
          "description": "Primary-source link for verification"
         },
         "detectedAt": {
          "type": "string",
          "format": "date-time"
         },
         "significance": {
          "type": "integer",
          "maximum": 10,
          "minimum": 1
         },
         "effectiveDate": {
          "type": [
           "string",
           "null"
          ]
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/courtlistener-new-us-court-opinions-monitor-73609bbd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oracles-production.up.railway.app](https://www.zero.xyz/host/oracles-production.up.railway.app/llms.txt)