{
  "openapi": "3.0.1",
  "info": {
    "title": "Federal Court Case Monitor — New Cases & Filings, No Login",
    "description": "Watch parties, keywords or courts on CourtListener (PACER/RECAP) and get only NEW federal cases, new docket filings and opinions since the last run, with judge, nature of suit, parties and latest entry. Daily schedule. No login required. MCP-ready. $20 per 1,000 alerts.",
    "version": "1.0",
    "x-build-id": "wrHJDWIUvybZbgYzW"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/flamboyant_liner~court-case-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-flamboyant_liner-court-case-monitor",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/flamboyant_liner~court-case-monitor/runs": {
      "post": {
        "operationId": "runs-sync-flamboyant_liner-court-case-monitor",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/flamboyant_liner~court-case-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-flamboyant_liner-court-case-monitor",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "partyNames": {
            "title": "Party names to watch",
            "type": "array",
            "description": "Companies or people. Each name is one watch, matched as a phrase against the parties on the docket (e.g. \"Amazon.com\", \"Tesla, Inc.\", \"John Smith\"). For opinions the phrase is matched against the case name.",
            "default": [
              "Amazon.com",
              "Tesla, Inc."
            ],
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords to watch",
            "type": "array",
            "description": "Each entry is one full-text watch across case names, parties, docket entries and documents. CourtListener query syntax works, e.g. \"data breach\", \"patent AND infringement\", \"securities fraud\".",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "courts": {
            "title": "Courts",
            "type": "array",
            "description": "CourtListener court IDs to restrict every watch to, e.g. cand (N.D. Cal.), nysd (S.D.N.Y.), txed (E.D. Tex.), ded (D. Del.), ca9 (9th Cir.), scotus. Full list: https://www.courtlistener.com/help/api/jurisdictions/. With no party names or keywords, the courts themselves become the watch (every new case in those courts).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "caseTypes": {
            "title": "What to watch",
            "type": "array",
            "description": "dockets = new federal cases from PACER/RECAP (and new docket entries when trackDocketEntries is on). opinions = new published court opinions.",
            "default": [
              "dockets"
            ],
            "items": {
              "type": "string"
            }
          },
          "filedSinceDays": {
            "title": "Filed within (days)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Only cases and opinions filed within this many days are considered new. For a daily schedule 3-7 days gives a safe overlap; the seen-state prevents duplicates.",
            "default": 7
          },
          "trackDocketEntries": {
            "title": "Track new docket entries on known cases",
            "type": "boolean",
            "description": "Re-check up to 100 previously seen dockets (most recently active first) and emit a new_filing record when a docket entry newer than the last one recorded has appeared.",
            "default": false
          },
          "maxNewPerWatch": {
            "title": "Max new items per watch",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Stop scanning a watch after this many new cases/opinions. Anything beyond stays unseen and comes out on the next run.",
            "default": 5
          },
          "maxItems": {
            "title": "Max alerts per run",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Hard cap on records emitted in one run across all watches (new cases, filings and opinions).",
            "default": 10
          },
          "firstRunMode": {
            "title": "First run mode",
            "enum": [
              "emitAll",
              "baseline"
            ],
            "type": "string",
            "description": "What to do when the monitor has no saved state yet. emitAll: treat every current match as new and emit it (good for a one-off pull or a first test). baseline: silently record every current match as seen and emit nothing, so the next scheduled run reports only what changed since.",
            "default": "emitAll"
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Optional. After each run a JSON summary {monitorId, runAt, newCases, newFilings, newOpinions, records[first 50]} is POSTed here (Slack/Zapier/Make/your API).",
            "default": ""
          },
          "monitorId": {
            "title": "Monitor ID",
            "type": "string",
            "description": "Name of this watchlist. Each monitor ID keeps its own seen-state in a key-value store named court-monitor-<hash>, so you can run several profiles (e.g. \"clients-litigation\", \"competitors-ip\") side by side.",
            "default": "default"
          },
          "courtlistenerApiToken": {
            "title": "CourtListener API token (optional)",
            "type": "string",
            "description": "Optional. Unauthenticated access is rate-limited to about 5 requests per minute; a free CourtListener account token (Profile > API) is sent as Authorization: Token ... and a Free Law Project membership raises the limits further."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}