Trace LLC ownership

# Step 1: Search by name
# Replace "EXAMPLE+PALM+HOLDINGS" with the actual LLC name
$ curl -s -H "x-api-key: $API_KEY" \
    "https://api.sunbizdata.com/api/v1/corporations/search/name?name=EXAMPLE+PALM+HOLDINGS"

< 200 OK (36ms)
{ "results": [{
    "documentNumber": "L00000000003",
    "corporationName": "EXAMPLE PALM HOLDINGS LLC",
    "status": "Active"
  }], "total": 1 }

# Step 2: Get full detail — check officer types
# Replace "L00000000003" with the documentNumber from step 1
$ curl -s -H "x-api-key: $API_KEY" \
    "https://api.sunbizdata.com/api/v1/corporations/detail?documentNumber=L00000000003"

< 200 OK (44ms)
{
  "corporationName": "EXAMPLE PALM HOLDINGS LLC",
  "officers": [
    { "title": "MGR", "type": "C", "name": "EXAMPLE PARTNERS LLC" },
    { "title": "MGR", "type": "C", "name": "EXAMPLE INVESTORS GROUP LLC" }
  ]
}
# type "C" = corporation — search that name to go deeper
# type "P" = person — you've found the end of the chain

// Recursively trace an LLC ownership chain
async function traceOwnership(name, depth = 0, maxDepth = 5) {
  const headers = { "x-api-key": process.env.SUNBIZDATA_KEY };
  if (depth >= maxDepth) return [{ name, note: "max depth reached" }];

  const search = await fetch(
    `https://api.sunbizdata.com/api/v1/corporations/search/name?name=${name}`,
    { headers }
  ).then(r => r.json());

  if (!search.results.length) return [{ name, note: "not found" }];

  const detail = await fetch(
    `https://api.sunbizdata.com/api/v1/corporations/detail?documentNumber=${search.results[0].documentNumber}`,
    { headers }
  ).then(r => r.json());

  const chain = [{ name: detail.corporationName, officers: detail.officers }];

  for (const officer of detail.officers.filter(o => o.type === "C")) {
    const deeper = await traceOwnership(officer.name, depth + 1, maxDepth);
    chain.push(...deeper);
  }

  return chain;
}