{
  "info": {
    "name": "CaseVine API",
    "description": "Federal litigation screening over the PACER Case Locator. Screen a company or person and get every U.S. federal case they're a party to — normalized, deduplicated, and cached.\n\n## Setup\n1. Create a free account at https://www.casevine.ai to get a sandbox key (`cv_test_…`) instantly, then add a card for a production key (`cv_live_…`).\n2. Set the collection variable `api_key` to your key.\n3. Send **Party search** to make your first call.\n\nAll authenticated endpoints take your key as a Bearer token in the `Authorization` header. Full reference: https://www.casevine.ai/docs",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{api_key}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "api_base_url",
      "value": "https://api.casevine.ai/v1",
      "type": "string",
      "description": "Base URL for the versioned API (party search)."
    },
    {
      "key": "app_base_url",
      "value": "https://casevine.ai",
      "type": "string",
      "description": "Base URL for the app host (Case Alerts and health check)."
    },
    {
      "key": "api_key",
      "value": "cv_test_YOUR_SANDBOX_KEY",
      "type": "string",
      "description": "Your CaseVine API key. Sandbox keys start with cv_test_, live keys with cv_live_."
    }
  ],
  "item": [
    {
      "name": "Party search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "options": {
            "raw": {
              "language": "json"
            }
          },
          "raw": "{\n  \"name\": \"Acme Robotics\",\n  \"type\": \"business\",\n  \"website\": \"acmerobotics.com\",\n  \"state_of_incorporation\": \"DE\",\n  \"jurisdiction\": \"cv\",\n  \"case_year\": \"2022\"\n}"
        },
        "url": {
          "raw": "{{api_base_url}}/parties/search",
          "host": [
            "{{api_base_url}}"
          ],
          "path": [
            "parties",
            "search"
          ]
        },
        "description": "Returns every federal case in which the given party appears. `name` is the only required field. Optional entity signals (`ein_or_tax_id`, `website`, `ticker_symbol`, `linkedin_url`, `lei_number`, `state_of_incorporation`, `registration_number`, `phone_number`, `street_address`) drive entity resolution; `jurisdiction` (cv/cr/bk/ap) and `case_year` narrow a common name. Results are cached for 30 days."
      },
      "response": []
    },
    {
      "name": "Case Alerts — Add watched entity",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "options": {
            "raw": {
              "language": "json"
            }
          },
          "raw": "{\n  \"name\": \"Acme Corporation\",\n  \"type\": \"business\",\n  \"webhook_url\": \"https://example.com/hooks/casevine\"\n}"
        },
        "url": {
          "raw": "{{app_base_url}}/api/monitor/add",
          "host": [
            "{{app_base_url}}"
          ],
          "path": [
            "api",
            "monitor",
            "add"
          ]
        },
        "description": "Records the entity, captures a baseline of its current cases, and starts watching. CaseVine re-screens nightly and alerts by email (and the optional `webhook_url`) on newly filed cases. Free accounts can watch up to 3 entities; Pro is unlimited. Adding past the cap returns 409."
      },
      "response": []
    },
    {
      "name": "Case Alerts — List watched entities",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{app_base_url}}/api/monitor/list",
          "host": [
            "{{app_base_url}}"
          ],
          "path": [
            "api",
            "monitor",
            "list"
          ]
        },
        "description": "Returns your watched entities, your `limit` (null on Pro — unlimited), and how many are active."
      },
      "response": []
    },
    {
      "name": "Case Alerts — Remove watched entity",
      "request": {
        "method": "DELETE",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "options": {
            "raw": {
              "language": "json"
            }
          },
          "raw": "{\n  \"name\": \"Acme Corporation\"\n}"
        },
        "url": {
          "raw": "{{app_base_url}}/api/monitor/remove",
          "host": [
            "{{app_base_url}}"
          ],
          "path": [
            "api",
            "monitor",
            "remove"
          ]
        },
        "description": "Stops alerts for a watched entity while preserving its alert history. Provide either `id` or `name`."
      },
      "response": []
    },
    {
      "name": "Health check",
      "request": {
        "auth": {
          "type": "noauth"
        },
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{app_base_url}}/api/health",
          "host": [
            "{{app_base_url}}"
          ],
          "path": [
            "api",
            "health"
          ]
        },
        "description": "Public health check for uptime monitors — no authentication required. Returns 200 when production search can work (database and production PACER reachable), 503 otherwise."
      },
      "response": []
    }
  ]
}