GET /companies/{companyId}/filings

GET /api/signal-foundry/companies/{companyId}/filings は、1 社の EDINET filing evidence list を返します。通常の公開 workflow では、Company Card と IR Signals を先に読み、必要なときだけ filing id や source 状態の確認に使います。

契約サマリー

この エンドポイントの役割 は、解決済み company_id から filing evidence を確認することです。社名や検索語しかない場合は、先に GET /companies または sf company search <query> --json で company_id を解決してください。

リクエスト

HTTP

curl "https://signal-foundry.app/api/signal-foundry/companies/jpx_5574/filings?document_type=annual_report&limit=5" \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>"

CLI

sf company filings jpx_5574 --document-type annual_report --limit 5 --json

見る key:

• filings[].filing_id
• filings[].doc_id
• filings[].document_type
• filings[].submitted_at
• filings[].artifact_health
• filings[].fact_stats
• filings[].previous_comparable_filing
• meta.returned_filings
• meta.has_more

クエリパラメータ

レスポンス

中心フィールド

• ok
• object
• status
• company_id
• company
• filings[]
  • filing_id
  • doc_id
  • document_type
  • submitted_at
  • disclosed_date
  • artifact_health
  • summary_metrics
  • fact_stats
  • segment_metrics
  • section_stats
  • previous_comparable_filing
  • artifacts
• meta
  • filters.document_types
  • requested_identifier
  • resolved_by
  • returned_filings
  • has_more

previous_comparable_filing は内部の差分生成や supporting evidence 確認で使われます。通常 workflow では、その結果を Company Card / IR Signals 側で読みます。artifacts には PDF / XBRL 由来の inventory 情報が入り、artifact_health は failed / expected 成果物 を先に見るための要約です。

例

{
  "ok": true,
  "object": "company_filings",
  "status": "completed",
  "company_id": "jpx_5574",
  "company": {
    "company_id": "jpx_5574",
    "display_name": "ABEJA, Inc."
  },
  "filings": [
    {
      "filing_id": "edinet_fil_S100XYUO",
      "doc_id": "S100XYUO",
      "document_type": "annual_report",
      "period_end": "2025-08-31",
      "submitted_at": "2025-11-28T00:00:00+09:00",
      "artifact_health": {
        "failed_count": 0,
        "failed_fetch_error_codes": [],
        "pending_count": 0,
        "states": {
          "fetched": 2
        }
      },
      "summary_metrics": {
        "revenue": {
          "value": 1234567890,
          "unit": "JPY",
          "relative_year": 0
        }
      },
      "fact_stats": {
        "total_rows": 320,
        "distinct_metric_keys": 180,
        "segment_fact_rows": 12
      },
      "segment_metrics": [],
      "section_stats": {
        "section_keys": ["business_risks", "strategy"],
        "total_rows": 2
      },
      "previous_comparable_filing": {
        "filing_id": "edinet_fil_S100PREV",
        "doc_id": "S100PREV",
        "document_type": "annual_report"
      },
      "artifacts": [
        {
          "artifact_type": "source_document",
          "inventory_state": "fetched",
          "file_extension": "pdf"
        }
      ]
    }
  ],
  "meta": {
    "company_id": "jpx_5574",
    "filters": {
      "document_types": ["annual_report"]
    },
    "returned_filings": 1,
    "has_more": false,
    "requested_identifier": "jpx_5574",
    "resolved_by": {
      "field": "company_id",
      "value": "jpx_5574"
    }
  }
}

filings[].previous_comparable_filing が null でも、一覧取得自体は成功です。前回 filing を自動選択できないだけなので、通常は IR Signals の coverage / gap として扱います。

エラー

復旧方法

company_not_found が返る場合:

1. sf company search <query> --json を実行します。
2. companies[].company.company_id を確認します。
3. 解決した company_id で sf company filings <companyId> --json を実行します。

filings が空の場合:

1. document_type 絞り込みを外して再実行します。
2. meta.returned_filings と meta.has_more を確認します。
3. それでも 0 件なら、対象会社が EDINET 提出会社ではない可能性があります。0 件を filing failure として扱わず、profile / observations 側の 根拠で補完してください。

rate_limit_exceeded が返る場合は、Retry-After を見て待機します。同じ request を短時間に繰り返さないでください。

次に進む先

• Company Card を読む: GET /companies/{companyId}/profile
• IR Signals を読む: sf signals <companyId> --include ir --json