GET /companies/{companyId}/filings/{filingId}

GET /api/signal-foundry/companies/{companyId}/filings/{filingId} は、1 filing の finance facts と text sections を返します。

契約サマリー

この endpoint の job は、選択済み filing の facts と sections を読むことです。filingId が分からない場合は、先に GET /companies/{companyId}/filings または sf company filings <companyId> --json を実行してください。

リクエスト

HTTP

curl "https://signal-foundry.app/api/signal-foundry/companies/jpx_5574/filings/edinet_fil_S100XYUO?section_key=business_risks&fact_limit=50" \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>"

CLI

sf filing show jpx_5574 edinet_fil_S100XYUO \
  --section-key business_risks \
  --fact-limit 50 \
  --json

見る key:

• filing.filing_id
• filing.summary_metrics
• finance.facts[]
• finance.meta.available_summary_metrics
• finance.meta.returned_facts
• sections.items[]
• sections.meta.returned_sections
• meta.resolved_filing_by

パスパラメータ

{filingId} には次のどちらかを使えます。

• edinet_fil_* の filing_id
• S100XXXX の doc_id

クエリパラメータ

include_section_content=false を使うと section metadata だけを返し、本文を省略できます。agent が最初に当たりをつける場合は、まず本文なしで取得してください。

レスポンス

中心フィールド

• company
• filing
  • filing summary
  • artifact_health
  • fact_stats
  • summary_metrics
  • segment_metrics
  • previous_comparable_filing
• finance
  • facts[]
  • meta.available_summary_metrics
  • meta.filtered_fact_stats
  • meta.returned_facts
  • meta.has_more
• sections
  • items[]
  • meta.filtered_section_stats
  • meta.returned_sections
• meta
  • requested_filing_identifier
  • resolved_filing_by
  • fact_filters
  • section_filters

例

{
  "company": {
    "company_id": "jpx_5574",
    "display_name": "ABEJA, Inc."
  },
  "filing": {
    "filing_id": "edinet_fil_S100XYUO",
    "doc_id": "S100XYUO",
    "document_type": "annual_report",
    "processing_state": "parsed",
    "artifact_health": {
      "failed_count": 0,
      "failed_fetch_error_codes": [],
      "pending_count": 0,
      "states": {
        "fetched": 2
      }
    },
    "fact_stats": {
      "consolidations": ["unknown"],
      "distinct_metric_keys": 120,
      "effective_consolidations": ["consolidated"],
      "metric_scopes": ["current_duration", "current_instant"],
      "relative_years": [0, -1],
      "segment_fact_rows": 12,
      "total_rows": 500
    },
    "summary_metrics": {
      "revenue": {
        "value": 1234567890,
        "unit": "JPY",
        "relative_year": 0
      }
    },
    "segment_metrics": [
      {
        "member_key": "Software",
        "context_ids": ["CurrentYearDuration_SoftwareMember"],
        "metrics": {
          "sales_revenue": {
            "value": 1234567890,
            "unit": "JPY",
            "metric_scope": "current_duration",
            "metric_key": "jpcrp_cor:SalesRevenuesIFRS",
            "context_id": "CurrentYearDuration_SoftwareMember"
          }
        }
      }
    ],
    "previous_comparable_filing": {
      "filing_id": "edinet_fil_S100PREV",
      "doc_id": "S100PREV"
    }
  },
  "finance": {
    "facts": [
      {
        "metric_key": "jpcrp_cor:NetSalesSummaryOfBusinessResults",
        "metric_scope": "current_duration",
        "metric_value": 1234567890,
        "unit": "JPY",
        "relative_year": 0,
        "evidence_key": "edinet:S100XYUO:net_sales"
      }
    ],
    "meta": {
      "available_summary_metrics": {
        "revenue": {
          "value": 1234567890,
          "unit": "JPY"
        }
      },
      "returned_facts": 1,
      "has_more": false,
      "total_filtered_facts": 1
    }
  },
  "sections": {
    "items": [
      {
        "section_key": "business_risks",
        "section_title": "事業等のリスク",
        "content": "..."
      }
    ],
    "meta": {
      "returned_sections": 1,
      "filtered_section_stats": {
        "section_keys": ["business_risks"],
        "total_rows": 1
      }
    }
  },
  "meta": {
    "requested_filing_identifier": "edinet_fil_S100XYUO",
    "resolved_filing_by": {
      "field": "filing_id",
      "value": "edinet_fil_S100XYUO"
    },
    "fact_limit": 50,
    "fact_offset": 0
  }
}

エラー

filing_not_found の例

{
  "error": {
    "code": "filing_not_found",
    "message": "Filing not found for identifier: S100XXXX"
  }
}

復旧方法

filing_not_found が返る場合:

1. sf company filings <companyId> --limit 10 --json を実行します。
2. filings[].filing_id と filings[].doc_id を確認します。
3. 同じ company_id に紐づく filing を選び直します。

finance.facts[] が多すぎる場合:

1. fact_limit を下げます。
2. metric_key, metric_scope, relative_year, consolidation で絞ります。
3. section の本文が不要なら include_section_content=false を付けます。

segment_metrics が空の場合:

1. filing.artifact_health.failed_count と pending_count を確認します。
2. filing.fact_stats.segment_fact_rows を確認します。
3. filing.processing_state が parsed ではない場合は、source refresh / EDINET retry の対象にします。

sections.items[] が 0 件の場合は、section_key filter を外して再実行します。本文抽出がない filing では、filing.summary_metrics と finance.facts[] だけを使ってください。

次に進む先

• 前回 filing と比較する: GET /companies/{companyId}/filings/{filingId}/compare
• filing を選び直す: GET /companies/{companyId}/filings