--- title: プロセスの取得 description: 検証プロセスの現在の状態と結果を取得します。 canonical: https://developer.unico.io/ja/dual-api/developers/api-reference/web-sdk/get-process locale: ja generated_by: markdown-export --- - [/ja/](/ja/) - [API リファレンス](/ja/dual-api/developers/api-reference/) - [Web & ネイティブ](/ja/dual-api/developers/api-reference/web-sdk/) - プロセスの取得 **このページの内容プロセスの取得GET既存のプロセスを識別子で取得します。APIコントラクトの仕様上、結果はプロセス作成時にすでに同期的に返されているため、このエンドポイントは再照会・監査・サポート対応に使用します。 警告プロセスを取得する前に、Webhookの設定とフォールバック戦略を確認してください — [こちらをクリック](/ja/developers/webhooks-and-events/setup)。 ### エンドポイント​ 環境URL**本番**`GET https://api.idcloud.unico.app/client/v1/process/{processId}`**サンドボックス**`GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}` ### リクエスト​ ヘッダー ヘッダー値`Authorization``Bearer ` パスパラメータ パラメータ型必須説明`processId`string (UUID)はい[プロセスの作成](/ja/dual-api/developers/api-reference/web-sdk/post-process)で返されるプロセス識別子。 ### 例​ cURLNode.js``` curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID \ -H "Authorization: Bearer $TOKEN" ``` ``` import fetch from 'node-fetch';const res = await fetch( `https://api.idcloud.unico.app/client/v1/process/${processId}`, { headers: { Authorization: `Bearer ${accessToken}` } });const { process: proc } = await res.json(); ``` ### レスポンス​ 200 OK ``` { "process": { "id": "226fd950-4b80-4da6-a476-ba9d397ddc91", "flow": "id_r2", "callbackUri": "/", "userRedirectUrl": "https://cadastro.uat.unico.app/flow?collect-data=true&dynamic-wrapper=true&id=226fd950-4b80-4da6-a476-ba9d397ddc91", "state": "PROCESS_STATE_FINISHED", "result": "PROCESS_RESULT_APPROVED", "createdAt": "2026-08-06T01:42:21.693615Z", "finishedAt": "2026-08-06T01:43:03.080508Z", "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "40*******50", "friendlyName": "teste", "email": "", "phone": "5511999999999", "notifications": [ { "notificationChannel": "NOTIFICATION_CHANNEL_WHATSAPP" } ], "phoneCountryCodeAlpha3": "" }, "purpose": "personAuthentication", "services": [], "authenticationInfo": { "authenticationId": "55cba227-9828-49df-a16f-bcdaa7bdaa4d" }, "capacities": ["PROCESS_CAPACITY_IDCLOUDONE"], "expiresAt": "2026-08-13T01:42:21.536500Z", "token": "", "companyData": { "branchId": "", "countryCode": "BRA" }, "simulated": false }} ``` プロセスフィールド フィールド意味`id`プロセスのUUID。フローの照会・追跡に使用するキーです。`flow`実行されたジャーニーの種類（例: `id_r2`、`idlivetrust_r2`、`idtrust_r2` など）。`callbackUri`フロー終了時にクライアントアプリがリダイレクトされるコールバックURI。`userRedirectUrl`ユーザーがジャーニーを実行するために開くCbUページの完全なURL（`id` と挙動フラグを含みます）。`state`プロセスのライフサイクル状態。`PROCESS_STATE_*` の値（例: `CREATED`、`FAILED`、`FINISHED`、`AWAITING_FOR_DOCUMENT`、`UNSPECIFIED`）。`result`評価の最終判定結果。`PROCESS_RESULT_*` の値（例: `APPROVED`、`AUTHENTICATED`、`NOT_APPROVED` など）。`state = PROCESS_STATE_FINISHED` の場合のみ確定します。`createdAt`プロセス作成時のタイムスタンプ（UTC）。`finishedAt`プロセス完了時のタイムスタンプ（UTC）。`person`検証対象の人物のデータを含むサブオブジェクト。`purpose`プロセスの目的（例: `personAuthentication`、本人登録）。`services`プロセスに付随する追加サービスの一覧。存在しない場合は空になります。`authenticationInfo.authenticationId`フローによって生成された本人認証イベントのID。`capacities`使用されたケイパビリティ／プロダクト。`PROCESS_CAPACITY_*` の値（例: `IDCLOUDONE`）。`expiresAt`プロセス／リンクの有効期限のタイムスタンプ（UTC）。`token`プロセスに関連付けられたセッション／アクセストークン（空の場合があります）。`companyData`プロセスを所有する会社／テナントのデータを含むサブオブジェクト。`simulated`ブール値。シミュレーション／サンドボックスのプロセスであれば `true`、実際のプロセスであれば `false`。 人物フィールド フィールド意味`duiType`一意の本人確認書類の種類。`DUI_TYPE_*` の値（例: `BR_CPF`）。`duiValue`書類の値（例: CPF番号）。`friendlyName`人物のフレンドリーネーム／ニックネーム（自由入力のテキストで、検証されません）。`email`人物のメールアドレス。空の場合があります。`phone`E.164形式の電話番号（国番号＋地域番号＋番号）。`notifications`通知チャネルの一覧。各項目は `NOTIFICATION_CHANNEL_*` の値を持つ `notificationChannel` を含みます（例: `WHATSAPP`、`SMS`、`EMAIL`）。`phoneCountryCodeAlpha3`電話番号のISO alpha-3国コード（例: `BRA`）。空の場合があります。 会社データフィールド フィールド意味`branchId`テナントの支店識別子。支店で区分されていない場合は空になります。`countryCode`ISO alpha-3形式の会社の国（例: `BRA`）。 ドキュメントタイプと OCR フィールド `process.services[].documents[].doc.code` は、ドキュメントタイプを大文字の短いコードとして返します。`unico.moja.dictionary.br.cnh.v2.Cnh` は `CNH` になります。 このコードには国もスキーマバージョンも含まれません。バージョンは `doc.version` で別途返されます。 統合スキーマ — [フィールドリファレンス](/ja/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json) の `unified_schema` — を使用するドキュメントタイプは、キャプチャ時に識別されたタイプが大文字で返されます: `IDCARD`、`DRIVERLICENSE`、`PASSPORT`、`VOTERID`。 米国のパスポートは `PASSPORT` にまとめられず、バリアントがそのまま保持されるため、`POLYCARBONATEPASSPORT`、`PASSPORTCARD`、`PAPERPASSPORT` といった値も返されます。 たとえば、`unico.moja.dictionary.ar.generic.v1.IdCard` と `unico.moja.dictionary.us.generic.v1.PolycarbonatePassport` は、それぞれ `IDCARD` と `POLYCARBONATEPASSPORT` として返されます。 個別スキーマ 独自のフィールドスキーマを使用するドキュメントタイプ — [フィールドリファレンス](/ja/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json) の `specific_document_schemas` に記載 — は、以下の表のとおりです。ディクショナリタイプを使って、そのファイル内で各スキーマを参照してください。 国`doc.code`ディクショナリタイプドキュメントBR`RG``unico.moja.dictionary.br.rg.v2.Rg`RGBR`CNH``unico.moja.dictionary.br.cnh.v2.Cnh`CNH（運転免許証）BR`CIN``unico.moja.dictionary.br.cin.v1.Cin`CINBR`PASSAPORTE``unico.moja.dictionary.br.passaporte.v1.Passaporte`パスポートMX`INE``unico.moja.dictionary.mx.ine.v1.Ine`INE 選挙人証MX`LPC``unico.moja.dictionary.mx.lpc.v1.Lpc`Licencia para conducir（運転免許証）MX`PASAPORTE``unico.moja.dictionary.mx.pasaporte.v1.Pasaporte`パスポート—`UNKNOWN``unico.moja.dictionary.other.unknown.v1.Unknown`タイプを識別できませんでした — `doc.data` は空になります `PASSAPORTE` と `PASAPORTE` は異なるドキュメントですブラジルのパスポートは `PASSAPORTE`（S が 2 つ）、メキシコのパスポートは `PASAPORTE`（S が 1 つ）で、それぞれ自国のディクショナリの綴りを反映しています。誤字ではありません。この 2 つの値を同一のものとして扱わないでください。 `doc.code` が `UNKNOWN` の場合、OCR抽出は実行されず、`doc.data` にフィールドは一切返されません。 ブラジルのクライアントはプロセスの完全なペイロードを受け取る場合があります全体のレスポンス構造は変わらず、単一の結果がデフォルトです。ブラジルの統合では、以下の完全なプロセスオブジェクトを受け取る場合があり、ケイパビリティごとの結果は authenticationInfo に含まれます。``` { "process": { "id": "53060f52-f146-4c12-a234-5bb5031f6f5b", "flow": "idchecktrust", "callbackUri": "https://example.com/callback", "userRedirectUrl": "https://example.com/redirect", "state": "PROCESS_STATE_FINISHED", "result": "PROCESS_RESULT_OK", "createdAt": "2024-01-01T10:00:00Z", "finishedAt": "2024-01-01T10:15:00Z", "expiresAt": "2024-01-08T10:00:00Z", "purpose": "VERIFICATION", "clientReference": "client-ref-abc", "useCase": "smart_revalidation", "capacities": ["liveness", "face_match"], "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909", "friendlyName": "Luke Skywalker", "notifications": [ { "notificationChannel": "email" } ] }, "authenticationInfo": { "authenticationId": "auth-123", "livenessResult": "LIVENESS_RESULT_LIVE", "authenticationResult": "AUTHENTICATION_RESULT_INCONCLUSIVE", "identityFraudstersResult": "TRUST_RESULT_INCONCLUSIVE", "bioTokenEngineResult": "BIO_TOKEN_ENGINE_RESULT_UNSPECIFIED", "smartRevalidationResult": "SMART_REVALIDATION_RESULT_UNSPECIFIED", "idAgeResult": "ID_AGE_RESULT_UNSPECIFIED", "scoreEngineResult": { "scoreEnabled": "SCORE_ENABLED_TRUE", "score": 85.5 } }, "companyData": { "branchId": "branch-123", "countryCode": "BR" }, "bioTokenData": { "referenceProcessId": "ref-proc-123", "authenticationId": "auth-ref-123" }, "services": [ { "envelopeId": "4d4f3d90-04a3-4259-b63b-930ab10d2e47", "documentIds": ["doc-abc-123"], "consent_granted": true, "documents": [ { "doc_id": "doc-abc-123", "typified": true, "cpf_match": true, "face_match": true, "validate_doc": true, "reused_doc": false, "signed_url": "https://example.com/doc?token=xyz", "doc": { "version": 1, "code": "CNH", "data": { "numero": "044589731564", "cpfNumero": "12345678909", "nomeCivil": "Luke Skywalker", "dataNascimento": "1990-05-12T00:00:00Z", "dataExpiracao": "2027-12-07T00:00:00Z", "categoria": "B" } } } ] } ] }} ``` トップレベルフィールドフィールド型説明`process.id`string (UUID)プロセス識別子。`process.flow`string作成時に送信されたフロー識別子。`process.callbackUri`stringプロセスイベント用に設定されたコールバックURL。`process.userRedirectUrl`stringジャーニー完了後にユーザーをリダイレクトするURL。`process.state`enumプロセスの現在の状態。値は以下を参照。`process.result`enum検証結果。`state = PROCESS_STATE_FINISHED` の場合のみ存在します。`process.createdAt`string (datetime)プロセス作成時のISO 8601タイムスタンプ。`process.finishedAt`string (datetime)プロセス終了時のISO 8601タイムスタンプ。`state = PROCESS_STATE_FINISHED` の場合のみ存在します。`process.expiresAt`string (datetime)プロセスの有効期限のISO 8601タイムスタンプ。`process.purpose`stringフローで設定されたプロセスの目的。`process.clientReference`stringポータルでのインデックス作成に使用する任意のクライアント側参照。`process.useCase`stringフローに関連付けられたシナリオ識別子。`process.capacities`array of stringsこのプロセスで有効化されたケイパビリティの一覧。`process.token`stringSDK統合用に署名されたJWT。`process.person`object作成時に提供された識別情報。`process.person.notifications`arrayジャーニー用に設定された通知チャネル（例: `email`）。`process.authenticationInfo`objectケイパビリティごとの結果。以下を参照。`process.companyData`object会社および支店のコンテキスト。`process.companyData.branchId`string支店識別子。`process.companyData.countryCode`stringISO 3166-1 alpha-2 国コード。`process.bioTokenData`object参照プロセス情報 — 1:1 バリデーションとスマート再検証のフローでのみ存在します。`process.services`array署名済みエンベロープ、キャプチャされたドキュメント、その他のサービス出力。以下を参照。process.stateの値値意味`PROCESS_STATE_CREATED`プロセスが作成され、ユーザーがまだジャーニーを完了していません。`AWAITING_FOR_DOCUMENT`本人確認書類なしでプロセスが作成され、[Set Process Document](/ja/dual-api/developers/api-reference/web-sdk/post-process-document)経由で設定されるのを待っています。カスタムフローが任意の書類を許可している場合のみ存在します。`PROCESS_STATE_FINISHED`ジャーニーが完了しました。`result` と `authenticationInfo` を確認してください。`PROCESS_STATE_FAILED`処理エラー。状態名の不整合`AWAITING_FOR_DOCUMENT` は、他の状態で使用されている `PROCESS_STATE_*` プレフィックスの命名規則に従っていません。これは現在のAPIにおける既知の命名の不整合です。process.resultの値値意味`PROCESS_RESULT_OK`すべてのケイパビリティが肯定的な結果を返しました。`PROCESS_RESULT_INVALID_IDENTITY`少なくとも1つのケイパビリティが確定的な否定結果を返しました（例: ライブネス失敗、本人確認不一致）。`PROCESS_RESULT_ERROR`結果処理中にエラーが発生しました。`PROCESS_RESULT_EXPIRED`ジャーニーが完了する前にプロセスが期限切れになりました。`PROCESS_RESULT_UNSPECIFIED`プロセスがまだ終了していません。authenticationInfoの機能結果すべてのフィールドは、フローに関係なく常に返されます。フローで使用されていないケイパビリティのフィールドは `*_UNSPECIFIED` を返します。短縮形の列挙値短縮値（例: `livenessResult = LIVE`、`authenticationResult = INCONCLUSIVE`）は、ここで説明されている完全な列挙値（`LIVENESS_RESULT_LIVE`、`AUTHENTICATION_RESULT_INCONCLUSIVE` など）に直接対応します — 簡潔にするためプレフィックスは省略されています。フィールドケイパビリティ可能な値`authenticationId`—この認証試行の一意の識別子。`livenessResult`[ライブネス](/ja/capabilities/liveness)`LIVENESS_RESULT_LIVE`、`LIVENESS_RESULT_NOT_LIVE`、`LIVENESS_RESULT_UNSPECIFIED``authenticationResult`[本人確認](/ja/capabilities/identity-verification)`AUTHENTICATION_RESULT_POSITIVE`、`AUTHENTICATION_RESULT_NEGATIVE`、`AUTHENTICATION_RESULT_INCONCLUSIVE`、`AUTHENTICATION_RESULT_UNSPECIFIED``identityFraudstersResult`[不正リスク分類](/ja/capabilities/fraud-risk-classification)`TRUST_RESULT_YES`、`TRUST_RESULT_INCONCLUSIVE`、`TRUST_RESULT_UNSPECIFIED``bioTokenEngineResult`[1:1 バリデーション](/ja/capabilities/1-1-validation)`BIO_TOKEN_ENGINE_RESULT_POSITIVE`、`BIO_TOKEN_ENGINE_RESULT_NEGATIVE`、`BIO_TOKEN_ENGINE_RESULT_UNSPECIFIED``smartRevalidationResult`[スマート再検証](/ja/capabilities/smart-revalidation)`SMART_REVALIDATION_RESULT_POSITIVE`、`SMART_REVALIDATION_RESULT_NEGATIVE`、`SMART_REVALIDATION_RESULT_UNSPECIFIED``idAgeResult`[年齢確認](/ja/capabilities/age-verification)`ID_AGE_RESULT_POSITIVE`、`ID_AGE_RESULT_NEGATIVE`、`ID_AGE_RESULT_INCONCLUSIVE`、`ID_AGE_RESULT_UNSPECIFIED``scoreEngineResult.scoreEnabled`[リスクスコア](/ja/capabilities/risk-score)`SCORE_ENABLED_TRUE`、`SCORE_ENABLED_FALSE`、`SCORE_ENABLED_UNSPECIFIED``scoreEngineResult.score`[リスクスコア](/ja/capabilities/risk-score)-100から+100までの数値。`authenticationResult = AUTHENTICATION_RESULT_INCONCLUSIVE` かつリスクスコアが有効な場合に存在します。`serproResult.score`[Serpro類似度返却](/ja/capabilities/serpro-similarity-return)`0`〜`100`（類似度）、`-1`（このCPFに登録された顔写真がない）、`-2`（統合エラー）。process.servicesフィールドservicesにおける命名規則の混在`services` 配列は、エンベロープレベルのフィールド（`envelopeId`、`documentIds`）にキャメルケースを使用し、ドキュメントレベルのフィールド（`doc_id`、`consent_granted`、`face_match` など）にスネークケースを使用します。これは実際のAPIレスポンスを反映したものであり、両方の命名規則は意図的なものでドキュメントの誤りではありません。フィールド型説明`envelopeId`string (UUID)署名済みエンベロープ識別子。`documentIds`array of stringsこのサービスでキャプチャされたドキュメントのID。`consent_granted`booleanユーザーがデータ共有の同意を許諾したかどうか。`documents`arrayOCRデータと検証結果を含むキャプチャされたドキュメント。`documents[].doc_id`stringドキュメント識別子。`documents[].typified`booleanドキュメントタイプが正常に識別されたかどうか。`documents[].cpf_match`booleanドキュメント上のCPFが提供されたCPFと一致するかどうか（ブラジルのみ）。`documents[].face_match`booleanセルフィーがドキュメントの写真と一致するかどうか。`documents[].validate_doc`booleanドキュメントが真正性検証に合格したかどうか。`documents[].reused_doc`booleanこのドキュメントが以前のプロセスから再利用されたかどうか。`documents[].signed_url`stringドキュメントPDFをダウンロードするための署名付きURL（有効期限5分 — 更新するには再取得してください）。`documents[].doc.version`integerOCRスキーマのバージョン。`documents[].doc.code`string短いドキュメントタイプコード（例: `CNH`）。すべての値とコードの導出方法については [ドキュメントタイプと OCR フィールド](#document-type-values) を参照してください。`documents[].doc.data`object抽出されたOCRフィールド。内容はドキュメントタイプによって異なります — 完全なカタログは[フィールドリファレンス全体](/ja/assets/files/document-content-fields-0e4663f2ade946e901bbc7523c21f032.json)を参照してください。`doc.data` 内のフィールド名（例: `nomeCivil`、`dataNascimento`）はポルトガル語で返されます — これはOCRエンジンが生成する実際の値です。 メキシコのクライアントはRENAPO検証ブロックを受け取る場合がありますレスポンスの構造は同じままで、idGov ブロックが追加されます。RENAPO検証が有効なメキシコの統合は、authenticationInfo の下に、ユーザーのCURPについてRENAPOが保有するレコードを含む追加の idGov ブロックを受け取ります。これは本人確認の結果とは別個の回答です。``` { "process": { "id": "11111111-2222-3333-4444-555555555555", "state": "PROCESS_STATE_FINISHED", "result": "PROCESS_RESULT_APPROVED", "person": { "duiType": "DUI_TYPE_MX_CURP", "duiValue": "PUEA880304MDFRJN04" }, "authenticationInfo": { "authenticationId": "22222222-3333-4444-5555-666666666666", "idGov": { "government_valid": true, "curp": "PUEA880304MDFRJN04", "government_name": "ANA PRUEBA EJEMPLO" } }, "companyData": { "countryCode": "MEX" } }} ``` その他のフィールドおよび残りの `idGov` キーは簡潔さのため省略しています。`idGov` フィールドの完全な表については、[RENAPO検証](/ja/capabilities/renapo-verification#possible-responses)を参照してください。フィールド型説明`authenticationInfo.idGov`objectCURPに対するRENAPOのレコード。ケイパビリティが有効でない場合は存在しません。RENAPOが応答しなかった場合は `{}`。メキシコのみで利用可能。[RENAPO検証](/ja/capabilities/renapo-verification)を参照してください。 ### エラーコード​ 400 Bad Request401 Unauthorized404 Not Found429 Too Many Requests500 Internal Server Errorコードメッセージ説明`3`process id is invalidプロセスIDが無効な場合。コードメッセージ説明—Jwt header is an invalid JSON使用されたアクセストークンに不正な文字が含まれている場合。—Jwt is expired使用されたアクセストークンの有効期限が切れている場合。コードメッセージ説明`5`error getting process: rpc error: code = NotFound desc = process not foundプロセスIDが見つからなかった場合。レート制限に達しました。システムが HTTP 429 エラーを受信した場合、連鎖的な障害を防ぎ、制限の悪化を避けるためのメカニズムを実装する必要があります。 **ベストプラクティス:** **クールダウン期間（バックオフ）:** システムからの後続のリクエストを直ちに停止または抑制してください。失敗したリクエストを短いループで継続的にリトライしないでください。 **キューイングとスロットリング:** 送信リクエストをバッファリングまたはキューに入れて、再送信前にトラフィックフローを制御してください。 **ジッター付き指数バックオフ:** リトライ時には、試行間の待機時間を指数的に増加させ（例: 1秒、2秒、4秒、8秒）、小さなランダムな遅延（「ジッター」）を追加して、キュー内のすべてのリクエストがまったく同じミリ秒にリトライするハードエフェクトを防止してください。 警告バックオフを適用せずにレート制限されたエンドポイントにリクエストを送り続けると、**制限期間が延長され**、システムの運用スループットに深刻な影響を与える可能性があります。リクエストを適切にスロットリングすることで、よりスムーズで回復力のあるインテグレーションが実現します。 デフォルトの制限、リクエストの増加、その他の詳細については、[レート制限](/ja/dual-api/developers/api-reference/rate-limits)を参照してください。コードメッセージ説明`99999`Internal failure! Try again later内部エラーが発生した場合。 ### ポーリング vs Webhook​ このエンドポイントをポーリングして進捗を確認することもできますが、推奨されるパターンは**Webhookを購読**し、このエンドポイントはフォールバックとしてのみ呼び出すことです。[Webhooks and Events](/ja/developers/webhooks-and-events)を参照してください。 ### 次のステップ​ キャプチャされたセルフィーについては、[Get Selfie](/ja/dual-api/developers/api-reference/web-sdk/get-selfie)を参照してください。 証拠の監査バンドルについては、[Get Evidence Set](/ja/dual-api/developers/api-reference/web-sdk/get-evidence-set)を参照してください。 最終更新 2026年10月8日**に