RoboRoboコンプライアンスチェックAPIv2仕様 (1.1.4)

Download OpenAPI specification:Download

アクセストークン（APIトークン）について

・アクセストークンを付加のうえリクエストを送信することで、各APIに応じた機能が利用できます。
・アクセストークンは、API利用契約時に弊社にて発行・通知いたします。

新聞記事検索契約について

・API契約時に、新聞記事検索契約を行うと、コンプライアンスチェック実行時に新聞記事検索を同時に行うことができます。
・取引先登録・チェックAPIを利用すると、同時に新聞記事検索が行われます。
・新聞記事検索結果は、取引先登録・チェックAPIのコールバック、及びチェック結果詳細取得APIを利用すると取得することができます。
・新聞記事検索は、検索ワードに特殊な文字（文字コード：EUC-JP で変換できない文字）が含まれていると検索を行えません。
（新聞記事検索で連携しているG-Searchデータベースサービスの仕様です。）

World-Check検索契約について

・API契約時に、World-Check検索をしていただくとWorld-Check検索がインターネット検索と同時に実行されます。
・取引先登録・チェックAPIを利用時に、World-Check検索の実行有無を設定することができます。「組織」「個人」を設定すると同時にWorld-Check検索が行われます。
・World-Check検索の結果は、取引先登録・チェックAPIのコールバック、及びチェック結果詳細取得APIを利用すると取得することができます。
・World-Check検索にて「あり」だった場合、候補を選択する必要があります。候補一覧はWorld-Check候補一覧取得APIにて取得をしてください。
・候補を取得したあと、該当のデータを指定してWorld-Check詳細取得APIをご利用いただくと、詳細情報を取得することができます。

更新履歴

2024年4月～

日付	Version	更新箇所	更新内容
2024/4/24	1.1.0	所属グループ取得API	追加作成
2024/4/24	1.1.0	取引先登録・チェック実行API	グループを指定して実行できるように修正
2024/9/12	1.1.1	取引先登録・チェック実行API	契約件数の120％まで実行可能に併せてエラーメッセージを修正

2025年5月～

2025/5/20	1.1.2	取引先登録・チェック実行API	callbackに解析除外件数を追加
2025/5/20	1.1.2	チェック結果詳細取得API	取得結果に解析除外件数を追加
2025/7/22	1.1.3	取引先登録・チェック実行API	フォルダ登録できるように修正 callbackにLLM結果、チェック日、チェック実行ID、フォルダID、フォルダ名を追加
2025/7/22	1.1.3	チェック結果詳細取得API	取得結果にLLM結果、チェック日、チェック実行ID、フォルダID、フォルダ名を追加該当記事0のときもチェック結果詳細URLを戻す
2025/7/22	1.1.3	チェック結果詳細取得（履歴）API	追加作成

2025年10月

日付	Version	更新箇所	更新内容
2025/10/13	1.1.4	取引先登録・チェック実行API	パラメータにWorld Check項目を追加 callbackにWorld Check結果を追加
2025/10/13	1.1.4	チェック結果詳細取得API	World Check結果を追加
2025/10/13	1.1.4	チェック結果詳細取得（履歴）API	World Check結果を追加
2025/10/13	1.1.4	World-Check国籍リスト取得API	追加作成
2025/10/13	1.1.4	World-Check国リスト取得API	追加作成
2025/10/13	1.1.4	World-Check識別番号種別取得API	追加作成
2025/10/13	1.1.4	World-Check候補一覧取得API	追加作成
2025/10/13	1.1.4	World-Check詳細取得API	追加作成

取引先登録・チェックAPI

チェック対象とする取引先名をRoboRoboコンプライアンスチェックへ登録し、チェックを実施、指定のURLに結果を送付

Authorizations:

Bearer

Request Body schema: application/json

チェック実行リスト

groupId	integer コンプライアンスチェックを実行するグループID
folderName	string コンプライアンスチェックを実行するフォルダ名
	Array of objects or objects
	object チェック結果の返却先の指定　トークンが空欄の場合は特に設定をせず返却　ヘッダーに下記を付与してPOSTリクエストを送る　・Authorization: Bearer {token} 結果の返却先URLへの送付はステータスコード：4xx、5xxの場合リトライを行う（最大10回）指定がない場合は返却を行わない

Responses

Request samples

Payload

Content type

application/json

{"groupId": 100000,
"folderName": "チェック202510",
"checkList": [{"customerName": ["株式会社〇〇〇",
"株式会社△△△"
],
"checkablePeriodNumber": 3,
"checkablePeriodUnit": "month",
"isSiteFilter": true,
"isExecuteWorldCheck": "組織",
"documentIdType": "MU-PASS",
"documentId": "〇〇〇",
"registeredCountry": "JPN"
},
{"customerName": "株式会社□□□",
"relativeWord": "東京都",
"negativeWord": "架空 偽装 振込",
"searchStartDate": "2023-07-01"
}
],
"responseTarget": {"url": "https://xxxxx.co.jp/recivexxx",
"token": "a0b1c2d3e4f5g6h7i8g9a0b1c2d3e4f5g6h7i8g9"
}
}

Response samples

Content type

application/json

{"groupId": 100000,
"folderName": "チェック202510",
"checkList": [{"customerId": 100000,
"customerName": "株式会社〇〇〇",
"negativeWord": "粉飾 横領 着服 背任 脱税 申告漏れ 違反 逮捕 送検 検挙 捜査 捜索 指名手配 判決 提訴 告訴 罪 詐欺 不正 偽装 裏 疑 架空 暗躍 闇 グレー 悪 暴力団 ヤクザ 総会屋 インサイダー 相場操縦 行政処分 行政指導",
"checkablePeriodNumber": 3,
"checkablePeriodUnit": "month",
"isSiteFilter": true
},
{"customerId": 100001,
"customerName": "株式会社△△△",
"negativeWord": "粉飾 横領 着服 背任 脱税 申告漏れ 違反 逮捕 送検 検挙 捜査 捜索 指名手配 判決 提訴 告訴 罪 詐欺 不正 偽装 裏 疑 架空 暗躍 闇 グレー 悪 暴力団 ヤクザ 総会屋 インサイダー 相場操縦 行政処分 行政指導",
"checkablePeriodNumber": 3,
"checkablePeriodUnit": "month",
"isSiteFilter": true
},
{"customerId": 100002,
"customerName": "株式会社□□□",
"relativeWord": "東京都",
"negativeWord": "架空 偽装 振込",
"searchStartDate": "2023-07-01",
"isSiteFilter": false
}
],
"responseTarget": {"url": "https://xxxxx.co.jp/recivexxx",
"token": "a0b1c2d3e4f5g6h7i8g9a0b1c2d3e4f5g6h7i8g9"
}
}

取引先登録・チェックAPIで指定したURLに対してチェック結果を送付

取引先登録・チェックAPIでresponseTargetのurlを指定した場合、指定のURLにチェック結果を送付
結果の返却先URLへの送付はステータスコード：4xx、5xxの場合リトライ（最大10回）
※responseTargetのtokenを指定した場合、BearerTokenに指定のtokenを付与

Authorizations:

Bearer

Request Body schema: application/json

チェック実行結果

Array of objects

結果

Responses

Request samples

Payload

Content type

application/json

{"resultList": [{"checkExecutionId": 200000,
"customerId": 100000,
"customerName": "株式会社〇〇〇",
"negativeWord": "粉飾 横領 着服 背任 脱税 申告漏れ 違反 逮捕 送検 検挙 捜査 捜索 指名手配 判決 提訴 告訴 罪 詐欺 不正 偽装 裏 疑 架空 暗躍 闇 グレー 悪 暴力団 ヤクザ 総会屋 インサイダー 相場操縦 行政処分 行政指導",
"checkedExecutionAt": "2023-07-01 11:39:48",
"folderId": 300000,
"folderName": "チェック202510",
"complianceUrl": "https://compliance.roborobo.co.jp/groups/1000/customers/100000/check-results/1000000/detail",
"totalUrlCount": 2,
"riskLevelCount": {"high": 1,
"middle": 0,
"low": 1,
"none": 0
},
"llmRiskLevelCount": {"llmHigh": 1,
"llmLow": 1
},
"newspaperResult": {"message": "success",
"articleCount": 3,
"url": "https://dbs.g-search.or.jp/aps/RXCN/main.jsp?verb=xxx"
},
"checkResultList": [{"checkExecutionResultId": 10000000,
"title": "xxxxの電話番号検索結果",
"snippet": "11 hours ago ... 050xxxx · 架空請求の電話番号【注意】 · 株式会社〇〇〇 ...",
"url": "https://www.telnavi.jp/search?q=050xxxx",
"domain": "www.telnavi.jp",
"riskLevelScore": 0,
"llmRiskLevelScore": 0,
"llmReason": "LLM要約内容1"
},
{"checkExecutionResultId": 10000001,
"title": "△△△△小売価格 ...",
"snippet": "20 hours ago ... お支払いについて□銀行振込(三井住友銀行/三菱東京UFJ銀行/ゆうちょ銀行/ジャパンネットバンク) □Yahoo!かんたん決済注意事項 ...",
"url": "https://finance.yahoo.co.jp/xxxx/1234",
"domain": "finance.yahoo.co.jp",
"domainName": "Yahoo! ファイナンス",
"riskLevelScore": 2,
"llmRiskLevelScore": 2,
"llmReason": "LLM要約内容2"
}
]
}
]
}

チェック結果詳細取得API

コンプライアンスチェック実行済みの取引先を指定し、最新のチェック実行結果の詳細を返却

Authorizations:

Bearer

Request Body schema: application/json

チェック結果取得対象

One of

customerId required	Array of integers 取引先ID 取引先登録・チェックAPIのチェック実行結果から取得可能リストで指定することで、複数の取引先に対して一括してチェック結果詳細の取得が可能 ※一度のリクエストで、取引先の合計件数最大10件まで
limit	integer Default: null 取引先ごとの取得件数最大数
offset	integer Default: null 取得するデータの開始位置最大取得件数を超える場合にページネーションとして指定できる
isSiteFilter	boolean Default: false サイト絞り込みをするか（true/false） trueにすると、信頼性の高いサイトに絞って結果を取得できる
riskLevelScore	integer Default: null 取得する注目度（高：0/中：1/低：2/判定不可：3/解析除外：-1） ※未指定で全取得

Responses

Request samples

Payload

Content type

application/json

{"customerId": 100000,
"limit": 20,
"offset": 10,
"isSiteFilter": true,
"riskLevelScore": 1
}

Response samples

Content type

application/json

{"resultList": [{"checkExecutionId": 200000,
"customerId": 100000,
"customerName": "株式会社〇〇〇",
"negativeWord": "粉飾 横領 着服 背任 脱税 申告漏れ 違反 逮捕 送検 検挙 捜査 捜索 指名手配 判決 提訴 告訴 罪 詐欺 不正 偽装 裏 疑 架空 暗躍 闇 グレー 悪 暴力団 ヤクザ 総会屋 インサイダー 相場操縦 行政処分 行政指導",
"checkedExecutionAt": "2023-07-01 11:39:48",
"folderId": 300000,
"folderName": "チェック202510",
"complianceUrl": "https://compliance.roborobo.co.jp/groups/1000/customers/100000/check-results/1000000/detail",
"totalUrlCount": 2,
"riskLevelCount": {"high": 1,
"middle": 0,
"low": 1,
"none": 0
},
"llmRiskLevelCount": {"llmHigh": 1,
"llmLow": 1
},
"checkDecisionChoice": 0,
"newspaperResult": {"message": "success",
"articleCount": 3,
"url": "https://dbs.g-search.or.jp/aps/RXCN/main.jsp?verb=xxx"
},
"checkResultList": [{"checkExecutionResultId": 10000000,
"title": "xxxxの電話番号検索結果",
"snippet": "11 hours ago ... 050xxxx · 架空請求の電話番号【注意】 · 株式会社〇〇〇 ...",
"url": "https://www.telnavi.jp/search?q=050xxxx",
"domain": "www.telnavi.jp",
"riskLevelScore": 0,
"llmRiskLevelScore": 0,
"llmReason": "LLM要約内容1"
},
{"checkExecutionResultId": 10000001,
"title": "△△△△小売価格 ...",
"snippet": "20 hours ago ... お支払いについて□銀行振込(三井住友銀行/三菱東京UFJ銀行/ゆうちょ銀行/ジャパンネットバンク) □Yahoo!かんたん決済注意事項 ...",
"url": "https://finance.yahoo.co.jp/xxxx/1234",
"domain": "finance.yahoo.co.jp",
"domainName": "Yahoo! ファイナンス",
"riskLevelScore": 2,
"llmRiskLevelScore": 2,
"llmReason": "LLM要約内容2"
}
]
}
]
}

チェック結果詳細取得（履歴）API

コンプライアンスチェック実行済みの取引先、実行IDを指定し、チェック実行結果の詳細を返却

Authorizations:

Bearer

Request Body schema: application/json

チェック結果取得対象

One of

	Array of objects 取引先IDとチェック実行IDの組み合わせリスト特定のチェック実行結果を1:1で指定したい場合に使用 ※一度のリクエストで、最大10件まで
limit	integer Default: null 取引先ごとの取得件数最大数
offset	integer Default: null 取得するデータの開始位置最大取得件数を超える場合にページネーションとして指定できる
isSiteFilter	boolean Default: false サイト絞り込みをするか（true/false） trueにすると、信頼性の高いサイトに絞って結果を取得できる
riskLevelScore	integer Default: null 取得する注目度（高：0/中：1/低：2/判定不可：3/解析除外：-1） ※未指定で全取得

Responses

Request samples

Payload

Content type

application/json

{"executionList": [{"customerId": 100000,
"checkExecutionId": 200000
},
{"customerId": 100001,
"checkExecutionId": 200001
}
],
"limit": 20,
"offset": 10,
"isSiteFilter": true,
"riskLevelScore": 1
}

Response samples

Content type

application/json

{"resultList": [{"checkExecutionId": 200000,
"customerId": 100000,
"customerName": "株式会社〇〇〇",
"negativeWord": "粉飾 横領 着服 背任 脱税 申告漏れ 違反 逮捕 送検 検挙 捜査 捜索 指名手配 判決 提訴 告訴 罪 詐欺 不正 偽装 裏 疑 架空 暗躍 闇 グレー 悪 暴力団 ヤクザ 総会屋 インサイダー 相場操縦 行政処分 行政指導",
"checkedExecutionAt": "2023-07-01 11:39:48",
"folderId": 300000,
"folderName": "チェック202510",
"complianceUrl": "https://compliance.roborobo.co.jp/groups/1000/customers/100000/check-results/1000000/detail",
"totalUrlCount": 2,
"riskLevelCount": {"high": 1,
"middle": 0,
"low": 1,
"none": 0
},
"llmRiskLevelCount": {"llmHigh": 1,
"llmLow": 1
},
"checkDecisionChoice": 0,
"newspaperResult": {"message": "success",
"articleCount": 3,
"url": "https://dbs.g-search.or.jp/aps/RXCN/main.jsp?verb=xxx"
},
"checkResultList": [{"checkExecutionResultId": 10000000,
"title": "xxxxの電話番号検索結果",
"snippet": "11 hours ago ... 050xxxx · 架空請求の電話番号【注意】 · 株式会社〇〇〇 ...",
"url": "https://www.telnavi.jp/search?q=050xxxx",
"domain": "www.telnavi.jp",
"riskLevelScore": 0,
"llmRiskLevelScore": 0,
"llmReason": "LLM要約内容1"
},
{"checkExecutionResultId": 10000001,
"title": "△△△△小売価格 ...",
"snippet": "20 hours ago ... お支払いについて□銀行振込(三井住友銀行/三菱東京UFJ銀行/ゆうちょ銀行/ジャパンネットバンク) □Yahoo!かんたん決済注意事項 ...",
"url": "https://finance.yahoo.co.jp/xxxx/1234",
"domain": "finance.yahoo.co.jp",
"domainName": "Yahoo! ファイナンス",
"riskLevelScore": 2,
"llmRiskLevelScore": 2,
"llmReason": "LLM要約内容"
}
]
}
]
}

取引判断更新API

コンプライアンスチェック実行済みの取引先に対し、取引判断（取引承認/取引否認/取引保留）を更新

Authorizations:

Bearer

Request Body schema: application/json

取引判断更新

One of

customerId required	Array of integers 取引先ID 取引先登録・チェックAPIのチェック実行結果から取得可能リストで指定することで、複数の取引先に対して一括して取引判断が可能 ※一度のリクエストで、取引先の合計件数最大1,000件まで
checkDecisionChoice required	integer 取引判断（保留：0/承認：1/否認：2）

Responses

Request samples

Payload

Content type

application/json

{"customerId": 100000,
"checkDecisionChoice": 0
}

Response samples

Content type

application/json

{"checkDecisionList": [{"customerId": 100000,
"customerName": "株式会社〇〇〇"
},
{"customerId": 100001,
"customerName": "株式会社△△△",
"relativeWord": "東京都"
}
],
"checkDecisionChoice": 1
}

PDFダウンロードAPI

コンプライアンスチェック実行結果から記事を指定し、当該記事のPDFダウンロード用URLを生成して返却

Authorizations:

Bearer

Request Body schema: application/json

PDFダウンロードURLの取得対象のチェック結果ID

One of

checkExecutionResultId

required

Array of integers

チェック結果ID
取引先登録・チェックAPI、或いはチェック結果詳細取得APIのチェック実行結果から取得可能
リストで指定することで、複数のチェック結果に対して一括してPDFダウンロードURLの取得が可能
※一度のリクエストで、チェック結果の合計件数最大100件まで

Responses

Request samples

Payload

Content type

application/json

Example

CheckExecutionResultIdList

{"checkExecutionResultId": [1000000,
1000001
]
}

Response samples

200
400
401
403
500

Content type

application/json

{"pdfUrlList": [{"checkExecutionResultId": 100000,
"message": "success",
"url": "https://roborobo-riskcheck-pdf.s3.amazonaws.com/example.pdf?xxx=yyy"
},
{"checkExecutionResultId": 1000001,
"message": "pdf file does not exist"
}
]
}

コンプラチェック件数取得API

期間を指定し、期間内のコンプライアンスチェックの実行件数を返却

Authorizations:

Bearer

query Parameters

startDate required	string Example: startDate=2023-07-01 検索対象開始日(yyyy-MM-ddの形式で設定)
endDate required	string Example: endDate=2023-08-31 検索対象終了日(yyyy-MM-ddの形式で設定) 前日までの件数(検索終了日の件数は含まれない)

Responses

Response samples

200
400
401
403
500

Content type

application/json

{"count": {"check": 93,
"newspaper": 81,
"creditDownload": 9
}
}

所属グループ取得API

実行ユーザの所属しているグループを返却

Authorizations:

Bearer

Responses

Response samples

200
401
500

Content type

application/json

{"groupList": [{"id": 100000,
"name": "〇〇〇グループ"
},
{"id": 100001,
"name": "△△△グループ"
}
]
}

World-Check国籍リスト取得API

World-Check国籍リストを返却

Authorizations:

Bearer

Responses

Response samples

200
401
500

Content type

application/json

{"nationalities": [{"code": "JPN",
"name": "日本"
},
{"code": "USA",
"name": "アメリカ"
}
]
}

World-Check国リスト取得API

World-Check国リストを返却

Authorizations:

Bearer

Responses

Response samples

200
401
500

Content type

application/json

{"countries": [{"code": "JPN",
"name": "日本"
},
{"code": "USA",
"name": "アメリカ合衆国"
}
]
}

World-Check識別番号種別リスト取得API

World-Check識別番号種別リストを返却

Authorizations:

Bearer

query Parameters

countryCode required	string Example: countryCode=JPN 国コード
entityType required	string Example: entityType=個人 World Check種別 (個人/組織)

Responses

Response samples

200
401
500

Content type

application/json

{"identification": [{"type": "MU-PASS",
"name": "PASSPORT NUMBER"
}
]
}

World-Check候補一覧取得API

World-Check候補一覧を返却

Authorizations:

Bearer

Request Body schema: application/json

worldCheckExecutionHistoryId	Array of integers World-Check実行履歴ID ※一度のリクエストで最大10件まで
limit	integer Default: null 取引先ごとの取得件数最大数
offset	integer Default: null 取得するデータの開始位置最大取得件数を超える場合にページネーションとして指定できる

Responses

Request samples

Payload

Content type

application/json

{"worldCheckExecutionHistoryId": [[100000,
100001
]
],
"limit": 20,
"offset": 10
}

Response samples

200
401
500

Content type

application/json

{"resultList": [{"customerName": "株式会社〇〇〇",
"worldCheckSearchResultId": 200000,
"referenceId": "e_tr_wci_△△△",
"primaryName": "株式会社〇〇〇",
"matchedTerm": "株式会社△△△",
"matchScore": 92.79,
"sourceCategories": ["Sanctions",
"Special Interest Categories"
],
"gender": "MALE",
"birth": ["1934-04-01",
"1934-03-31"
],
"placeOfBirth": "UKRAINE",
"countryLocation": "UKRAINE"
}
]
}

World-Check詳細取得API

World-Check詳細を返却

Authorizations:

Bearer

query Parameters

worldCheckSearchResultId required	integer Example: worldCheckSearchResultId=20000 World-Check候補一覧ID
referenceId required	string Example: referenceId=e_tr_wci_△△△ 参照ID

Responses

Response samples

200
401
500

Content type

application/json

{"master": {"primaryName": "株式会社〇〇〇",
"updateRecord": {"lastPublishedUpdateCategory": "C1",
"initialPublishedDate": "2000/11/05 0:00:00",
"lastPublishedDate": "2000/11/05 0:00:00"
},
"category": "INDIVIDUAL",
"recordSubType": "POLITICAL INDIVIDUAL",
"pepStatus": "ACTIVE",
"crimeCategories": ["POLITICALLY_EXPOSED",
"Special Interest Categories",
"Sanctions",
"Other Bodies",
"Regulatory Enforcement",
"PEP",
"Law Enforcement"
],
"gender": "MALE",
"birthDates": ["1952-00-00",
"1952-10-07"
],
"placeOfBirth": "RUSSIAN FEDERATION",
"nationalities": ["RUSSIAN FEDERATION",
"UNKNOWN"
],
"locations": [{"street": "Bocharov Ruchey, Sochi, Russia",
"city": "Moscow",
"region": "Moscow Region",
"countryName": "RUSSIAN FEDERATION"
}
],
"identifications": [{"number": "XX-AK 525818",
"type": "RU-PASS",
"countryName": "RUSSIAN FEDERATION"
}
]
},
"furtherInfo": [{"title": "来歴",
"text": "〇〇〇△△△"
}
],
"alias": {"aliases": [{"fullName": "株式会社〇〇〇",
"languageName": "Japanese"
}
],
"nativeAliases": [{"fullName": "株式会社〇〇〇",
"languageName": "Japanese"
}
]
},
"keyword": [{"keyword": "UAGUR-EOW",
"description": "〇〇〇△△△",
"keywordType": "SIC",
"countryName": "UNKNOWN"
}
],
"connection": {"organisation": [{"name": "株式会社〇〇〇",
"connection": "ASSOCIATE",
"types": ["PEP",
"Sanctions",
"Special Interest Categories"
],
"category": "BANK"
}
],
"individual": [{"name": "△△△",
"connection": "ASSOCIATE",
"types": ["PEP",
"Sanctions",
"Special Interest Categories"
],
"category": "INDIVIDUAL"
}
]
},
"pepRole": [{"role": "Regional Organisation Official",
"roleLevel": "PEP RO",
"position": "Regional Organisation Official",
"positionDetail": "Member of Supreme State Council of the Union State of Russia and Belarus",
"roleStatus": "CURRENT",
"fromDate": "2000-01",
"toDate": "2012-05"
}
],
"source": [{"addedDate": "2022/06/08",
"uri": "http://〇〇〇"
}
]
}