RISK EYES V2 取引先管理API

API情報

説明: RISK EYES V2 取引先管理API 仕様書

バージョン: 1.0.2

サーバー: https://www.riskeyes.jp

公開日: 2026年02月19日

概要

取引先の一覧取得、作成、詳細操作（取得・更新・削除）、法人番号検索による作成、承認ステータスの取得・更新、カスタムフィールドスキーマの取得が可能です。

主な機能

取引先の一覧の取得（検索・ページング対応）
取引先の新規作成
取引先詳細の取得・更新・削除
法人番号による企業情報検索・取引先作成
承認ステータスの取得・更新
カスタムフィールドスキーマの取得

注意事項

/api/v2/token で取得したトークンを Authorization ヘッダーに設定してください。
並行でリクエストを送信せず、1件ずつリクエストを送信してください。

認証

認証方式: Bearer Token

ヘッダー: Authorization: Bearer {token}

/api/v2/token で取得したトークンを設定してください。

エンドポイント

GET /api/v2/customer

概要: 取引先一覧取得

説明: 取引先一覧を取得します。検索キーワードによるフィルタリングとページング機能を提供します。

クエリパラメータ

パラメータ名	型	必須	説明	例
search_keyword	string	任意	会社名、代表者名、または住所のどれかでの部分一致検索	"ソーシャルワイヤー"
customer_unique_id	string	任意	貴社取引先IDの完全一致検索	"CUST001"
corporate_number	integer	任意	法人番号の完全一致検索	3011101058626
page	integer	任意	ページ番号（デフォルト: 1）	1
page_size	integer	任意	ページサイズ（デフォルト: 30）	10

レスポンス

200 取引先一覧取得成功

説明: 取引先一覧取得成功

レスポンス例

取引先一覧取得成功:

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1,
      "corporate_number": 3011101058626,
      "company_name": "ソーシャルワイヤー株式会社",
      "customer_unique_id": "CUST001",
      "representative_name": "矢田峰之",
      "address": "東京都港区新橋１丁目１－１３アーバンネット内幸町ビル３階",
      "remarks": "重要取引先",
      "risk_alert_enabled": true,
      "custom_fields": {
        "department": "営業部",
        "priority": "high"
      },
      "research_subjects": [
        {
          "word": "藤原直美",
          "memo": "取締役ＣＯＯ",
          "word_type": 0,
          "word_en": null,
          "word_dj": null
        }
      ],
      "created_at": "2025-07-18T13:48:37",
      "updated_at": "2025-07-22T10:52:28"
    }
  ]
}

401 認証エラー

説明: 認証エラー

エラー例

認証エラー:

{
  "error": "認証に失敗しました。"
}

POST /api/v2/customer/create

概要: 取引先新規作成

説明: 新しい取引先を作成します。

リクエストボディ

パラメータ名	型	必須	説明	例
corporate_number	integer (nullable)	任意	法人番号（13桁の半角数字）	3011101058626
company_name	string	必須	会社名	"ソーシャルワイヤー株式会社"
customer_unique_id	string (nullable)	任意	貴社取引先ID	"CUST001"
representative_name	string (nullable)	任意	代表者名	"矢田峰之"
address	string (nullable)	任意	住所	"東京都港区..."
remarks	string (nullable)	任意	備考	"重要取引先"
risk_alert_enabled	boolean	任意	リスクアラート有効フラグ	false
custom_fields	object (nullable)	任意	カスタムフィールド（事前に設定したキー・型の形式でデータを格納可能）	{"department": "営業部", "priority": "high"}
research_subjects	array	任意	調査対象リスト	[{"word": "藤原直美", "memo": "取締役ＣＯＯ"}]

リクエスト例

{
  "corporate_number": 3011101058626,
  "company_name": "ソーシャルワイヤー株式会社",
  "customer_unique_id": "CUST001",
  "representative_name": "矢田峰之",
  "address": "東京都港区新橋１丁目１－１３アーバンネット内幸町ビル３階",
  "remarks": "重要取引先",
  "risk_alert_enabled": false,
  "custom_fields": {
    "department": "営業部",
    "priority": "high"
  },
  "research_subjects": [
    {
      "word": "藤原直美",
      "memo": "取締役ＣＯＯ"
    }
  ]
}

レスポンス

201 取引先作成成功

説明: 取引先作成成功

レスポンス例

取引先作成成功:

{
  "id": 1,
  "corporate_number": 3011101058626,
  "company_name": "ソーシャルワイヤー株式会社",
  "customer_unique_id": "CUST001",
  "representative_name": "矢田峰之",
  "address": "東京都港区新橋１丁目１－１３アーバンネット内幸町ビル３階",
  "remarks": "重要取引先",
  "risk_alert_enabled": false,
  "custom_fields": {
    "department": "営業部",
    "priority": "high"
  },
  "research_subjects": [
    {
      "word": "藤原直美",
      "memo": "取締役ＣＯＯ",
      "word_type": 0,
      "word_en": null,
      "word_dj": null
    }
  ],
  "created_at": "2024-01-01T10:00:00Z",
  "updated_at": "2024-01-01T10:00:00Z"
}

400 バリデーションエラー

説明: バリデーションエラー

エラー例

必須フィールドエラー:

{
  "company_name": ["この項目は必須です。"]
}

法人番号重複エラー:

{
  "corporate_number": [
    "この法人番号は既に使用されています。"
  ]
}

401 認証エラー

説明: 認証エラー

エラー例

認証エラー:

{
  "error": "認証に失敗しました。"
}

GET /api/v2/customer/detail/{id}

概要: 取引先詳細取得

説明: 指定されたIDの取引先詳細情報を取得します。調査対象も含めて返却します。

パスパラメータ

パラメータ名	型	必須	説明	例
id	integer	必須	取引先ID	1

レスポンス

200 取引先詳細取得成功

説明: 取引先詳細取得成功

レスポンス例

取引先詳細取得成功:

{
  "id": 1,
  "corporate_number": 3011101058626,
  "company_name": "ソーシャルワイヤー株式会社",
  "customer_unique_id": "CUST001",
  "representative_name": "矢田峰之",
  "address": "東京都港区新橋１丁目１－１３アーバンネット内幸町ビル３階",
  "remarks": "重要取引先",
  "risk_alert_enabled": true,
  "custom_fields": {
    "department": "営業部",
    "priority": "high",
    "contract_date": "2024-01-15"
  },
  "research_subjects": [
    {
      "word": "藤原直美",
      "memo": "取締役ＣＯＯ",
      "word_type": 0,
      "word_en": null,
      "word_dj": null
    }
  ],
  "created_at": "2024-01-01T10:00:00Z",
  "updated_at": "2024-01-01T10:00:00Z"
}

401 認証エラー

説明: 認証エラー

エラー例

認証エラー:

{
  "error": "認証に失敗しました。"
}

404 取引先が見つからない

説明: 取引先が見つからない、クエリが間違っている

エラー例

取引先が見つからない:

{
  "error": "取引先が見つかりませんでした。"
}

PATCH /api/v2/customer/detail/{id}

概要: 取引先情報部分更新

説明: 指定されたIDの取引先情報を部分的に更新します。指定されたフィールドのみが更新され、未指定のフィールドは変更されません。
※調査対象を更新する場合は、取引先に紐づいた全ての調査対象を上書きするため、ご注意ください。

パスパラメータ

パラメータ名	型	必須	説明	例
id	integer	必須	取引先ID	1

リクエストボディ

パラメータ名	型	必須	説明	例
corporate_number	integer (nullable)	任意	法人番号（13桁）	3011101058626
company_name	string	任意	会社名	"ソーシャルワイヤー株式会社"
customer_unique_id	string (nullable)	任意	貴社取引先ID	"CUST001"
representative_name	string (nullable)	任意	代表者名	"矢田峰之"
address	string (nullable)	任意	住所	"東京都港区..."
remarks	string (nullable)	任意	備考	"重要取引先"
risk_alert_enabled	boolean	任意	リスクアラート有効フラグ	true
custom_fields	object (nullable)	任意	カスタムフィールド（事前に設定したキー・型の形式でデータを格納可能）	{"department": "営業部", "priority": "high"}
research_subjects	array	任意	調査対象リスト	[{"word": "藤原直美", "memo": "取締役ＣＯＯ"}]

リクエスト例

{
  "company_name": "ソーシャルワイヤー",
  "risk_alert_enabled": true,
  "custom_fields": {
    "department": "営業部",
    "priority": "high"
  }
}

レスポンス

200 取引先部分更新成功

説明: 取引先部分更新成功

レスポンス例

取引先部分更新成功:

{
  "id": 1,
  "corporate_number": 3011101058626,
  "company_name": "ソーシャルワイヤー",
  "customer_unique_id": "CUST001",
  "representative_name": "矢田峰之",
  "address": "東京都港区...",
  "remarks": "重要取引先",
  "risk_alert_enabled": true,
  "custom_fields": {
    "department": "営業部",
    "priority": "high"
  },
  "research_subjects": [
    {
      "word": "藤原直美",
      "memo": "取締役ＣＯＯ",
      "word_type": 0,
      "word_en": null,
      "word_dj": null
    }
  ],
  "created_at": "2024-01-01T10:00:00Z",
  "updated_at": "2024-01-01T10:00:00Z"
}

401 認証エラー

説明: 認証エラー

エラー例

認証エラー:

{
  "error": "認証に失敗しました。"
}

404 取引先が見つからない

説明: 取引先が見つからない、クエリが間違っている

エラー例

取引先が見つからない:

{
  "error": "取引先が見つかりませんでした。"
}

PUT /api/v2/customer/detail/{id}

概要: 取引先情報更新

説明: 指定されたIDの取引先情報を全て更新(上書き)します。調査対象も同時に上書きされます。

パスパラメータ

パラメータ名	型	必須	説明	例
id	integer	必須	取引先ID	1

リクエストボディ

パラメータ名	型	必須	説明	例
corporate_number	integer (nullable)	必須	法人番号（13桁）	3011101058626
company_name	string	必須	会社名	"ソーシャルワイヤー株式会社"
customer_unique_id	string (nullable)	必須	貴社取引先ID	"CUST001"
representative_name	string (nullable)	必須	代表者名	"矢田峰之"
address	string (nullable)	必須	住所	"東京都港区..."
remarks	string (nullable)	必須	備考	"重要取引先"
risk_alert_enabled	boolean	任意	リスクアラート有効フラグ（未指定の場合は既存の値を維持）	true
custom_fields	object (nullable)	必須	カスタムフィールド（事前に設定したキー・型の形式でデータを格納可能）	{"department": "営業部", "priority": "high"}
research_subjects	array	必須	調査対象リスト	[{"word": "藤原直美", "memo": "取締役ＣＯＯ"}]

リクエスト例

{
  "corporate_number": 3011101058626,
  "company_name": "ソーシャルワイヤー株式会社",
  "customer_unique_id": "CUST001",
  "representative_name": "矢田峰之",
  "address": "東京都港区新橋１丁目１－１３アーバンネット内幸町ビル３階",
  "remarks": "重要取引先",
  "risk_alert_enabled": true,
  "custom_fields": {
    "department": "営業部",
    "priority": "high"
  },
  "research_subjects": [
    {
      "word": "藤原直美",
      "memo": "取締役ＣＯＯ"
    }
  ]
}

レスポンス

200 取引先更新成功

説明: 取引先更新成功

レスポンス例

取引先更新成功:

{
  "id": 1,
  "corporate_number": 3011101058626,
  "company_name": "ソーシャルワイヤー株式会社",
  "customer_unique_id": "CUST001",
  "representative_name": "矢田峰之",
  "address": "東京都港区新橋１丁目１－１３アーバンネット内幸町ビル３階",
  "remarks": "重要取引先",
  "risk_alert_enabled": true,
  "custom_fields": {
    "department": "営業部",
    "priority": "high"
  },
  "research_subjects": [
    {
      "word": "藤原直美",
      "memo": "取締役ＣＯＯ",
      "word_type": 0,
      "word_en": null,
      "word_dj": null
    }
  ],
  "created_at": "2024-01-01T10:00:00Z",
  "updated_at": "2024-01-01T10:00:00Z"
}

400 バリデーションエラー

説明: バリデーションエラー

エラー例

必須フィールドエラー:

{
  "company_name": ["この項目は必須です。"]
}

法人番号重複エラー:

{
  "corporate_number": [
    "この法人番号は既に使用されています。"
  ]
}

401 認証エラー

説明: 認証エラー

エラー例

認証エラー:

{
  "error": "認証に失敗しました。"
}

404 取引先が見つからない

説明: 取引先が見つからない、クエリが間違っている

エラー例

取引先が見つからない:

{
  "error": "取引先が見つかりませんでした。"
}

DELETE /api/v2/customer/detail/{id}

概要: 取引先削除

説明: 指定されたIDの取引先を削除します。関連する調査対象も削除されます。

パスパラメータ

パラメータ名	型	必須	説明	例
id	integer	必須	取引先ID	1

レスポンス

204 取引先削除成功

説明: 取引先削除成功

401 認証エラー

説明: 認証エラー

エラー例

認証エラー:

{
  "error": "認証に失敗しました。"
}

404 取引先が見つからない

説明: 取引先が見つからない、クエリが間違っている

エラー例

取引先が見つからない:

{
  "error": "取引先が見つかりませんでした。"
}

POST /api/v2/customer/create/search

概要: 法人番号検索による取引先作成

説明: 法人番号を使用してRISK EYES企業情報を検索し、その結果を基に取引先を作成します。企業データベースから取得した情報で取引先を自動作成します。

リクエストボディ

パラメータ名	型	必須	説明	例
corporate_number	integer	必須	法人番号（13桁）	3011101058626
customer_unique_id	string	任意	貴社取引先ID	"CUST001"
remarks	string	任意	備考	"重要取引先"
risk_alert_enabled	boolean	任意	リスクアラート有効フラグ	false

リクエスト例

{
  "corporate_number": 3011101058626,
  "customer_unique_id": "CUST001",
  "remarks": "重要取引先",
  "risk_alert_enabled": false
}

レスポンス

201 企業情報検索・取引先作成成功

説明: 企業情報検索・取引先作成成功

レスポンス例

企業情報検索・取引先作成成功:

{
  "id": 1,
  "corporate_number": 3011101058626,
  "company_name": "ソーシャルワイヤー株式会社",
  "customer_unique_id": "CUST001",
  "representative_name": "矢田峰之",
  "address": "東京都港区新橋１丁目１－１３アーバンネット内幸町ビル３階",
  "remarks": "重要取引先",
  "risk_alert_enabled": false,
  "custom_fields": {},
  "research_subjects": [],
  "created_at": "2024-01-01T10:00:00Z",
  "updated_at": "2024-01-01T10:00:00Z"
}

400 バリデーションエラー

説明: バリデーションエラー

エラー例

必須フィールドエラー:

{
  "corporate_number": ["この項目は必須です。"]
}

法人番号重複エラー:

{
  "corporate_number": [
    "この法人番号は既に使用されています。"
  ]
}

401 認証エラー

説明: 認証エラー

エラー例

認証エラー:

{
  "error": "認証に失敗しました。"
}

404 企業情報が見つからない

説明: 企業情報が見つからない

エラー例

企業情報が見つからない:

{
  "error": "企業情報が見つかりませんでした。"
}

GET /api/v2/customer/approve/{id}

概要: 承認状態取得

説明: 指定されたIDの取引先の承認状態を取得します。承認レコードが存在しない場合は、confirm_status・approval_status ともに PENDING を返します。

パスパラメータ

パラメータ名	型	必須	説明	例
id	integer	必須	取引先ID	1

レスポンス

200 承認状態取得成功

説明: 承認状態取得成功

レスポンススキーマ

フィールド名	型	説明
confirm_status	string	確認ステータス（PENDING: 未確認、CONFIRMED: 確認済、NEEDS_CONFIRMATION: 要確認）
approval_status	string	承認ステータス（PENDING: 未確認、APPROVED: 承認、REJECTED: 否認）
remarks	string	備考

レスポンス例

承認状態取得成功:

{
  "confirm_status": "CONFIRMED",
  "approval_status": "APPROVED",
  "remarks": "承認済み"
}

承認レコードが存在しない場合:

{
  "confirm_status": "PENDING",
  "approval_status": "PENDING",
  "remarks": ""
}

401 認証エラー

説明: 認証エラー

エラー例

認証エラー:

{
  "error": "認証に失敗しました。"
}

404 取引先が見つからない

説明: 取引先が見つからない

エラー例

取引先が見つからない:

{
  "error": "取引先が見つかりませんでした。"
}

PATCH /api/v2/customer/approve/{id}

概要: 承認ステータス更新

説明: 指定されたIDの取引先の承認ステータスを更新します。confirm_status、approval_status、remarks のいずれか1つ以上を指定してください。
本エンドポイントには確認者権限または承認者権限が必要です。

パスパラメータ

パラメータ名	型	必須	説明	例
id	integer	必須	取引先ID	1

リクエストボディ

パラメータ名	型	必須	説明	例
confirm_status	string (nullable)	任意	確認ステータス（PENDING / CONFIRMED / NEEDS_CONFIRMATION）	"CONFIRMED"
approval_status	string (nullable)	任意	承認ステータス（PENDING / APPROVED / REJECTED）	"APPROVED"
remarks	string	任意	備考	"承認済み"

※ confirm_status、approval_status、remarks のいずれか1つ以上を指定してください。

リクエスト例

{
  "confirm_status": "CONFIRMED",
  "approval_status": "APPROVED",
  "remarks": "承認済み"
}

レスポンス

200 承認ステータス更新成功

説明: 承認ステータス更新成功

レスポンス例

承認ステータス更新成功:

{
  "confirm_status": "CONFIRMED",
  "approval_status": "APPROVED",
  "remarks": "承認済み"
}

400 バリデーションエラー

説明: バリデーションエラー

エラー例

必須パラメータ不足:

{
  "non_field_errors": [
    "approval_status, confirm_status, remarksのいずれかは必須です。"
  ]
}

401 認証エラー

説明: 認証エラー

エラー例

認証エラー:

{
  "error": "認証に失敗しました。"
}

403 権限エラー

説明: 確認者権限または承認者権限がない

404 取引先が見つからない

説明: 取引先が見つからない

エラー例

取引先が見つからない:

{
  "error": "取引先が見つかりませんでした。"
}

GET /api/v2/customer/custom-fields/schema

概要: カスタムフィールドスキーマ取得

説明: カスタムフィールドのJSON Schemaを取得します。事前に設定されたカスタムフィールドの定義（キー名、型、選択肢など）をJSON Schema形式で返します。

レスポンス

200 カスタムフィールドスキーマ取得成功

説明: カスタムフィールドスキーマ取得成功

レスポンススキーマ

フィールド名	型	説明
type	string	スキーマタイプ（"object"固定）
properties	object	各カスタムフィールドの定義（title, type, format, maxLength, enum等）
required	array	必須フィールドのキー一覧
additionalProperties	boolean	追加プロパティの許可（false固定）

レスポンス例

カスタムフィールドスキーマ取得成功:

{
  "type": "object",
  "properties": {
    "department": {
      "title": "部署",
      "type": "string",
      "maxLength": 255
    },
    "priority": {
      "title": "優先度",
      "type": "string",
      "enum": ["high", "medium", "low"]
    },
    "contract_date": {
      "title": "契約日",
      "type": "string",
      "format": "date"
    }
  },
  "required": ["department", "priority", "contract_date"],
  "additionalProperties": false
}

401 認証エラー

説明: 認証エラー

エラー例

認証エラー:

{
  "error": "認証に失敗しました。"
}

データスキーマ

Customer（取引先）

フィールド名	型	説明	例
corporate_number	integer (nullable)	法人番号	3011101058626
company_name	string	会社名	"ソーシャルワイヤー株式会社"
customer_unique_id	string (nullable)	貴社取引先ID	"CUST001"
representative_name	string (nullable)	代表者名	"矢田峰之"
address	string (nullable)	住所	"東京都港区新橋１丁目１－１３アーバンネット内幸町ビル３階"
remarks	string (nullable)	備考	"重要取引先"
risk_alert_enabled	boolean	リスクアラート有効フラグ	true
custom_fields	object (nullable)	カスタムフィールド（事前に設定したキー・型の形式でデータを格納可能）	{"department": "営業部", "priority": "high"}
research_subjects	array	調査対象配列	[{"word": "藤原直美", "memo": "取締役ＣＯＯ", "word_type": 0, "word_en": null, "word_dj": null}]

説明: 取引先に使用できるフィールド

ResearchSubject（調査対象）

フィールド名	型	説明	例
word	string	調査対象ワード	"藤原直美"
memo	string (nullable)	メモ	"取締役ＣＯＯ"
word_type	integer	ワード種別（0: 調査対象）	0
word_en	string (nullable)	英字名	"Naomi Fujiwara"
word_dj	string (nullable)	DJ現地語名	null

説明: 調査対象（会社名、代表者名以外の調査対象を入力してください）

ApprovalStatus（承認ステータス）

フィールド名	型	説明	例
confirm_status	string	確認ステータス（PENDING: 未確認、CONFIRMED: 確認済、NEEDS_CONFIRMATION: 要確認）	"CONFIRMED"
approval_status	string	承認ステータス（PENDING: 未確認、APPROVED: 承認、REJECTED: 否認）	"APPROVED"
remarks	string	備考	"承認済み"

説明: 承認状態を表すデータ

公開履歴

バージョン	公開日	変更内容
1.0.2	2026年02月19日	approve エンドポイント、custom-fields/schema エンドポイントの追加
1.0.1	2025年12月10日	custom_fieldsフィールドを追加
1.0.0	2025年8月19日	初版公開