Compliance monitoring

# Check an entity's annual report compliance
# Replace "P00000000006" with the document number of the entity to check
$ curl -s -H "x-api-key: $API_KEY" \
    "https://api.sunbizdata.com/api/v1/corporations/detail?documentNumber=P00000000006"

< 200 OK (38ms)
{
  "corporationName": "EXAMPLE COMMUNITY ASSOCIATION INC",
  "status": "Active",
  "fileDate": "06122019",
  "principalAddress": "900 Example Ave, Fort Lauderdale, FL 33602",
  "registeredAgent": { "name": "CARLOS EXAMPLE", "type": "P" },
  "officers": [{ "name": "MARIA EXAMPLE", "title": "President" }],
  "annualReports": [
    { "year": "2023", "filedDate": "01152023" },
    { "year": "2024", "filedDate": "02102024" },
    { "year": "2025", "filedDate": "03012025" }
  ]
}

// Check a list of entities for annual report compliance
async function checkCompliance(documentNumbers) {
  const headers = { "x-api-key": process.env.SUNBIZDATA_KEY };
  const currentYear = new Date().getFullYear().toString();
  const currentMonth = new Date().getMonth() + 1;

  // Only flag after May 1 (when annual reports are due)
  if (currentMonth < 5) return { message: "Too early — reports not due until May 1" };

  const results = [];

  for (const docNum of documentNumbers) {
    const detail = await fetch(
      `https://api.sunbizdata.com/api/v1/corporations/detail?documentNumber=${docNum}`,
      { headers }
    ).then(r => r.json());

    const filedYears = detail.annualReports.map(r => r.year);
    const isCompliant = filedYears.includes(currentYear);

    results.push({
      name: detail.corporationName,
      documentNumber: docNum,
      compliant: isCompliant,
      lastFiled: filedYears[filedYears.length - 1],
    });
  }

  return {
    total: results.length,
    overdue: results.filter(r => !r.compliant),
    compliant: results.filter(r => r.compliant),
  };
}

// Check your portfolio
const portfolio = ["P00000000006", "L00000000004", "L00000000008"];
const report = await checkCompliance(portfolio);
console.log(`${report.overdue.length} entities overdue`);