GET /companies/{companyId}/cases

GET /api/signal-foundry/companies/{companyId}/cases は、既存 observation から 1 社の事例、顧客関係、施工/案件 evidence を返します。

この endpoint は read surface です。新規 crawl、render、外部検索、全文取得で新しい evidence を作る surface ではありません。

契約サマリー

request credit は response header で返ります。

リクエスト

curl -s \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \
  "https://signal-foundry.app/api/signal-foundry/companies/jpx_6836/cases?limit=5&relation_tier=all"

{companyId} は先に GET /companies または sf company search ... --json で解決します。

クエリパラメータ

レスポンス

まず見る key:

• company.company_id
• customer_relations[].customer.company_name
• customer_relations[].relation_tier
• case_studies[].page_title
• projects[].project_name
• *.url
• meta.coverage_warnings
• meta.request_credit.credits_used (CLI JSON)
• meta.returned_case_studies
• meta.returned_customer_relations
• meta.returned_projects

{
  "object": "company_cases",
  "company": {
    "company_id": "jpx_6836",
    "display_name": "ぷらっとホーム株式会社"
  },
  "customer_relations": [],
  "case_studies": [],
  "projects": [],
  "meta": {
    "coverage_warnings": [
      {
        "code": "company_cases_coverage_gap",
        "status": "no_data"
      }
    ],
    "returned_case_studies": 0,
    "returned_customer_relations": 0,
    "returned_projects": 0
  }
}

case_studies、customer_relations、projects がすべて 0 件でも、meta.coverage_warnings がある場合は「事例なし」と断定しません。website / observations の coverage gap、または未観測の状態として扱います。

Billing

この endpoint は既存 evidence を読む data request なので、API / CLI で呼ぶと 1 request credit です。

credit summary では usage.api_request ledger event が meterType = api_request、usageKey = api.data_request として出ます。

新規 crawl、crawl4ai / browser render、外部検索、全文取得として新しい evidence を作る場合は、他の source と同じ credit-consuming write です。実行前に利用量上限を明示してください。

エラーと復旧方法