Bankruptcy Observer

Check your subscription status. Uses the API key from your connection (Authorization header) if api_key is not passed.
Optional: pass api_key (the same token you use in the Authorization header).
Returns: valid (whether the key is active), requestsThisMonth, monthlyLimit, requestsRemaining.
Does not count against your request limit.

Look up a bankruptcy case by short case number (e.g. 22-12345, 26-10543). FREE (no API key): pass only the case number; no court required. Returns all matching cases (same number can exist in multiple courts). Subscribers: use live_update=True with court_state or court_id for a real-time refresh at no extra cost. Non-subscribers: subscribe via list_plans_tool and purchase_plan_tool for live_update. Returns: JSON with results (array), total; each case has name, court, shortCaseNumber, dateFiled, dateLastUpdated, isOpen, isClosed, etc.
live_update: if True (subscribers only), request a refresh from source before returning; requires court_state or court_id so the case is unique.

Look up bankruptcy case by debtor EIN (Employer Identification Number).
include_last_filing: if True, add lastFilingDate from docket (slightly slower).
live_update: if True (subscribers: no extra charge), request a refresh from source before returning (slower; may not be enabled).
Returns: JSON with einInDatabase ("Yes" or "No") and case (object with standard fields, or null if not found).

Get bankruptcy cases filed within a date range (by dateFiled).
If both start_date and end_date are omitted, defaults to the prior calendar day (yesterday).
Use this for "cases filed yesterday", "new filings this week", or any date range.
start_date, end_date: ISO date strings (YYYY-MM-DD). Inclusive.
Returns: JSON with results (array of cases), total. Each case has standard fields (name, court, shortCaseNumber, dateFiled, dateLastUpdated, etc.).

Get bankruptcy cases by industry. Use label (Hotels, Real Estate, Retail, etc.)
or key (hotels, real-estate, retail).
Supported: Hotels, Oil & Gas, Real Estate, Restaurants, Retail, Trucking.
Returns: JSON with results (array of cases), total. Each case has standard fields (name, court, shortCaseNumber, dateFiled, dateLastUpdated, etc.).

Get bankruptcy cases by NAICS code (2–4 digits). Reject more than 4 digits.
Use 2 digits for sector, 3 for subsector, 4 for industry (e.g. 72, 721, 7211).
Returns: JSON with results (array of cases), total. Each case has standard fields (name, court, shortCaseNumber, dateFiled, dateLastUpdated, etc.).

Get docket entries for a bankruptcy case. Use this when you have a case number.

Steps:
1. Call with the short case number (e.g. 26-00712, 22-12345).
2. Different courts can use the same case number. If the number exists in more than one court,
   provide court_state (2-letter state abbreviation, e.g. PR for Puerto Rico, TX for Texas)
   or court_id. If you get no results or the wrong case, ask the user for the state and pass court_state.
3. The tool resolves the case number (and optional court_state or court_id) to the case, then returns
   docket entries plus dates so you can say how recent the information is.

Returns: JSON with entries (array of itemNumber, itemText, itemDate, …), latestEntryDate, dateDocketUpdated.
Response includes:
- entries: list of docket items (itemNumber, itemText, itemDate, etc.).
- latestEntryDate: date of the most recent docket entry in our data.
- dateDocketUpdated: from the case table; when this case's docket was last synced to the database.
  Use this to answer "how recent is this docket information?"

live_update: if True (subscribers: no extra charge), request a refresh from source before returning (slower; may not be enabled).

List subscription plans (Professional, Business, Enterprise). No API key required. Subscribers get real-time updates (live_update=True) at no extra cost. Free lookups: exact name search and 7-digit case number work with no API key. Non-subscribers: subscribe via purchase_plan_tool for live_update and full tool access. Returns: JSON with plans and note.

Get a Stripe Checkout link to subscribe. No API key required. plan_id: use an id returned by list_plans_tool (e.g. professional, business, enterprise). Subscribers use live_update=True on tools at no extra cost. Returns: JSON with "url" (checkout link).

Search bankruptcy cases by debtor name. FREE (no API key): name search (e.g. "JOY-CPW, INC.") — no court required; returns up to 25 matches with limited case info. Subscribe (list_plans_tool, purchase_plan_tool) for full access and live updates. Other searches (wildcard) require a subscription. Optional court filter (court_id or court_state). By default name search is prefix; use *term for contains. For lookup by case number use get_case_by_case_number_tool. Returns: JSON with results, total; each case has name, court, shortCaseNumber, dateFiled, dateLastUpdated, isOpen, isClosed, etc.