テナント一覧を取得します。

ほとんどのツールは tenant_id を必須パラメータに持つため、 SaaS_A の調査はまずこのツールで tenant_id を取得することから始めてください。

必要な権限レベル: 制限なし（どのユーザーレベルでも実行できます）。

既定で間引く項目: tenant_logo（ロゴ画像の Data URL。数百KBになりうる）は返さず、 has_logo (bool) で設定の有無のみ返します。画像そのものを取得する手段はありません。

テナント用ダッシュボードの一覧を取得します。

tenant_id は list_tenants で取得してください。

必要な権限レベル: システム管理者(user_level=1)、テナント管理者(user_level=2)。 権限が不足すると 403 になります。

このエンドポイントはページングに対応していないため、常に全件を返します （エンベロープの page / per_page は null）。

テナントに所属するユーザーの一覧を取得します。

tenant_id は list_tenants で取得してください。

必要な権限レベル: 制限なし（どのユーザーレベルでも実行できます）。

レスポンスにはメールアドレス（mailaddress）が含まれます。 個人情報であるため、必要のない場面で転記しないでください。 間引きは行いません。

テナントに紐づく現場（グループ）の一覧を取得します。

tenant_id は list_tenants で取得してください。

必要な権限レベル: 制限なし（どのユーザーレベルでも実行できます）。

既定で間引く項目:

• member（所属ユーザー。メールアドレスを含む）→ member_count のみ。全量は include_members=true

• destination（通知先。メールアドレスを含む）→ destination_count のみ。全量は include_destinations=true

• children → has_children (bool) に置換。API 仕様上つねに空配列で、 子現場の詳細を取得する操作は提供されていないため、階層構造の完全な取得はできません

• dashboard_id（単数形・未使用項目）→ 返しません。dashboard_ids を参照してください

このエンドポイントはページングに対応していないため、常に全件を返します。 現場の最大階層レベルは max_group_level として返します。

現場用ダッシュボードの一覧を取得します。

tenant_id は list_tenants で取得してください。

必要な権限レベル: システム管理者(user_level=1)、テナント管理者(user_level=2)、 現場管理者(user_level=3)。権限が不足すると 403 になります。

このエンドポイントはページングに対応していないため、常に全件を返します （エンベロープの page / per_page は null）。

テナントに紐づく地点（端末）の一覧を取得します。

Web管理画面の地点編集一覧と同じ情報（登録・更新項目の現在値）が得られます。 tenant_id は list_tenants で取得してください。

必要な権限レベル: 制限なし（どのユーザーレベルでも実行できます）。

既定で間引く項目:

• format_detail（項目定義。1フォーマットあたり数百件）→ format_detail_count のみ。 全量は include_format_detail=true

• address（通知先。メールアドレスを含む）→ alert_count のみ。全量は include_alerts=true

periodic_collection は、項目追加前に作成された既存地点では null になることがあります。 欠損と「停止(stop)」を取り違えないよう、null はそのまま返します。

地点用ダッシュボードの一覧を取得します。

tenant_id は list_tenants で取得してください。

必要な権限レベル: システム管理者(user_level=1)、テナント管理者(user_level=2)。 権限が不足すると 403 になります。

このエンドポイントはページングに対応していないため、常に全件を返します （エンベロープの page / per_page は null）。

テナントのフォーマット（機種）一覧を取得します。

tenant_id は list_tenants で取得してください。

必要な権限レベル: システム管理者(user_level=1) のみ。 テナント管理者以下の API ユーザーでは 403 になります。 403 が返った場合、パラメータではなく API ユーザーの権限レベルを疑ってください。

項目定義そのもの（各フォーマットの項目一覧）は含まれません。項目数は koumoku_count で分かります。 個々の項目定義が必要な場合は list_devices を include_format_detail=true で呼んでください。 間引きは行いません。

受信データ履歴を CSV でエクスポートします。

tenant_id は list_tenants で、group_cd は list_groups で、device_cd は list_devices で 取得してください。全件を対象にする場合は group_cd / device_cd に all を指定します。

必要な権限レベル: システム管理者(user_level=1)、テナント管理者(user_level=2)、 現場管理者(user_level=3)。権限が不足すると 403 になります。

CSV 本文はそのまま返しません（コンテキストを使い切るため）。 既定では行数・カラム名・先頭20行のプレビュー・データ期間の要約を返し、 CSV 本体は UTF-8 のファイルとして保存してその絶対パスを返します。 save_path を指定するとそのパス（絶対パスのみ・ディレクトリ可）へ、 未指定なら一時ディレクトリへ保存します。既存ファイルは上書きせず別名で保存します。 分析にはこのファイルを使ってください。

取得件数が API の上限を超えると 400 になります。その場合は期間を短くするか、 device_cd を all から個別の地点に絞って再実行してください。