{ "openapi": "3.0.0", "info": { "contact": { "name": "Onfido", "url": "https://public.support.onfido.com" }, "description": "The Onfido Public API (v3.6)", "license": { "name": "MIT" }, "title": "Onfido Public API v3.6", "version": "v3.6" }, "externalDocs": { "url": "https://documentation.onfido.com" }, "servers": [ { "url": "https://api.{region}.onfido.com/v3.6", "variables": { "region": { "default": "eu", "enum": ["eu", "us", "ca"] } } } ], "security": [ { "Token": [] }, { "OAuth2ClientCredentials": [] } ], "paths": { "/applicants": { "get": { "description": "Lists all applicants you've created, sorted by creation date in descending order.\n", "operationId": "list_applicants", "parameters": [ { "description": "The page to return. The first page is `page=1`", "in": "query", "name": "page", "schema": { "default": 1, "type": "integer" } }, { "description": "The number of objects per page.", "in": "query", "name": "per_page", "schema": { "default": 20, "type": "integer" } }, { "description": "Whether to also include applicants scheduled for deletion.", "in": "query", "name": "include_deleted", "schema": { "default": false, "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Applicants_list" } } }, "description": "A list of applicants" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List Applicants", "tags": ["Core Resources | Applicants"] }, "post": { "description": "Creates a single applicant. Returns an applicant object.\n", "operationId": "create_applicant", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/applicant_builder" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/applicant" } } }, "description": "Created" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Create Applicant", "tags": ["Core Resources | Applicants"] } }, "/applicants/{applicant_id}": { "delete": { "description": "Deletes a single applicant.\n", "operationId": "delete_applicant", "parameters": [ { "in": "path", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "204": { "description": "No Content" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Delete Applicant", "tags": ["Core Resources | Applicants"] }, "get": { "description": "Retrieves a single applicant. Returns an applicant object.\n", "operationId": "find_applicant", "parameters": [ { "in": "path", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/applicant" } } }, "description": "Applicant object" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve Applicant", "tags": ["Core Resources | Applicants"] }, "put": { "description": "Allows updating applicant's information before any checks is created.\n- Partial updates - Addresses and ID numbers present will replace existing ones - Same applicant validations to create applicant\n", "operationId": "update_applicant", "parameters": [ { "in": "path", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/applicant_updater" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/applicant" } } }, "description": "Applicant Object" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Update Applicant", "tags": ["Core Resources | Applicants"] } }, "/applicants/{applicant_id}/restore": { "post": { "description": "Restores a single applicant scheduled for deletion.\n", "operationId": "restore_applicant", "parameters": [ { "in": "path", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "204": { "description": "No Content" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Restore Applicant", "tags": ["Core Resources | Applicants"] } }, "/applicants/{applicant_id}/consents": { "get": { "description": "Retrieves consents for single applicant.\n", "operationId": "find_applicant_consents", "parameters": [ { "in": "path", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "description": "The applicant's consents", "items": { "$ref": "#/components/schemas/applicant_consent" }, "type": "array" } } }, "description": "Applicant Consents object" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve Applicant Consents", "tags": ["Core Resources | Applicants"] } }, "/workflow_runs": { "get": { "description": "Retrieves the Workflow Runs of the client. Returns a list of Workflow Run objects.\n", "operationId": "list_workflow_runs", "parameters": [ { "description": "The number of the page to be retrieved. If not specified, defaults to 1.", "in": "query", "name": "page", "schema": { "default": 1, "type": "integer" } }, { "description": "A list of comma separated status values to filter the results. Possible values are 'processing', 'awaiting_input', 'approved', 'declined', 'review', 'abandoned' and 'error'.", "in": "query", "name": "status", "schema": { "type": "string" } }, { "description": "A ISO-8601 date to filter results with a created date greater than (after) the one provided.", "in": "query", "name": "created_at_gt", "schema": { "format": "date", "type": "string" } }, { "description": "A ISO-8601 date to filter results with a created date less than (before) the one provided.", "in": "query", "name": "created_at_lt", "schema": { "format": "date", "type": "string" } }, { "description": "A string with the value 'desc' or 'asc' that allows to sort the returned list by the completed datetime either descending or ascending, respectively. If not specified, defaults to 'desc'.", "in": "query", "name": "sort", "schema": { "default": "desc", "enum": ["desc", "asc"], "type": "string" } }, { "description": "the applicant's id.", "in": "query", "name": "applicant_id", "required": false, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, { "description": "A list of tags to filter the results.", "in": "query", "name": "tags", "schema": { "items": { "type": "string" }, "type": "array" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/workflow_run" }, "title": "Workflow runs", "type": "array" } } }, "description": "An array of Workflow Run objects matching the query parameters." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List Workflow Runs", "tags": ["Core Resources | Workflow Runs"] }, "post": { "description": "Creates and starts a Workflow Run. Returns a Workflow Run object.\n", "operationId": "create_workflow_run", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/workflow_run_builder" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/workflow_run" } } }, "description": "A Workflow Run object." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Create a Workflow Run", "tags": ["Core Resources | Workflow Runs"] } }, "/workflow_runs/{workflow_run_id}": { "get": { "description": "A single workflow run can be retrieved by calling this endpoint with the unique identifier of the Workflow Run.\n", "operationId": "find_workflow_run", "parameters": [ { "description": "The unique identifier of the Workflow Run.", "in": "path", "name": "workflow_run_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/workflow_run" } } }, "description": "A Workflow Run object." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve Workflow Run", "tags": ["Core Resources | Workflow Runs"] } }, "/workflow_runs/{workflow_run_id}/signed_evidence_file": { "get": { "description": "Retrieves the signed evidence file for the designated Workflow Run\n", "operationId": "download_signed_evidence_file", "parameters": [ { "description": "Workflow Run ID", "in": "path", "name": "workflow_run_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "302": { "description": "Found", "headers": { "Location": { "description": "Link to the signed evidence file PDF.", "schema": { "format": "uri", "type": "string" } } } }, "200": { "content": { "application/pdf": { "schema": { "format": "binary", "type": "string" } } }, "description": "The signed evidence PDF binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve Workflow Run Evidence Summary File", "tags": ["Core Resources | Workflow Runs"] } }, "/workflow_runs/{workflow_run_id}/evidence_folder": { "get": { "description": "Retrieves the evidence folder for the designated Workflow Run\n", "operationId": "download_evidence_folder", "parameters": [ { "description": "Workflow Run ID", "in": "path", "name": "workflow_run_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "302": { "description": "Found", "headers": { "Location": { "description": "Link to the evidence folder.", "schema": { "format": "uri", "type": "string" } } } }, "200": { "content": { "application/zip": { "schema": { "format": "binary", "type": "string" } } }, "description": "The evidence folder binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve Workflow Run Evidence Folder", "tags": ["Core Resources | Workflow Runs"] } }, "/documents": { "get": { "description": "All documents belonging to an applicant can be listed from this endpoint", "operationId": "list_documents", "parameters": [ { "in": "query", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Documents_list" } } }, "description": "List of Documents" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List documents", "tags": ["Core Resources | Documents"] }, "post": { "description": "Documents are uploaded using this endpoint. Along with the file upload the relevant document type must be specified. Documents must be uploaded as a multipart form. The valid file types are: jpg, png and pdf. The file size must be between 2KB and 3MB.\n", "operationId": "upload_document", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/document_uploader" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/document" } } }, "description": "A document" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Upload a document", "tags": ["Core Resources | Documents"] } }, "/documents/{document_id}": { "get": { "description": "A single document can be retrieved by calling this endpoint with the document's unique identifier.\n", "operationId": "find_document", "parameters": [ { "in": "path", "name": "document_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/document" } } }, "description": "A document" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve document", "tags": ["Core Resources | Documents"] } }, "/documents/{document_id}/download": { "get": { "description": "Downloads specific documents belonging to an applicant. If successful, the response will be the binary data representing the image.\n", "operationId": "download_document", "parameters": [ { "in": "path", "name": "document_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } } }, "description": "The document binary data" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Download document", "tags": ["Core Resources | Documents"] } }, "/documents/{document_id}/nfc_face": { "get": { "description": "Downloads digital photos extracted from specific documents belonging to an applicant. If successful, the response will be the binary data representing the image.\n", "operationId": "download_nfc_face", "parameters": [ { "in": "path", "name": "document_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } } }, "description": "The image binary data" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Download NFC face", "tags": ["Core Resources | Documents"] } }, "/documents/{document_id}/video/download": { "get": { "description": "Downloads a document video. If successful, the response will be the binary data representing the video.\n", "operationId": "download_document_video", "parameters": [ { "in": "path", "name": "document_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } } }, "description": "The document's video binary data" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Download document video", "tags": ["Core Resources | Documents"] } }, "/signing_documents": { "get": { "description": "All signing documents belonging to an applicant can be listed from this endpoint", "operationId": "list_signing_documents", "parameters": [ { "in": "query", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Signing_Documents_list" } } }, "description": "List of Signing Documents" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List signing documents", "tags": ["Core Resources | Signing documents"] }, "post": { "description": "Signing documents are uploaded using this endpoint. Signing documents must be uploaded as a multipart form. The only valid file type is pdf. The file size must be between 2KB and 3MB.\n", "operationId": "upload_signing_document", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/signing_document_uploader" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/signing_document" } } }, "description": "A signing document" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Upload a signing document", "tags": ["Core Resources | Signing documents"] } }, "/signing_documents/{signing_document_id}": { "get": { "description": "A single signing document can be retrieved by calling this endpoint with the signing document's unique identifier.\n", "operationId": "find_signing_document", "parameters": [ { "in": "path", "name": "signing_document_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/signing_document" } } }, "description": "A signing document" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve signing document", "tags": ["Core Resources | Signing documents"] } }, "/signing_documents/{signing_document_id}/download": { "get": { "description": "Downloads specific signing documents belonging to an applicant. If successful, the response will be the binary data representing the pdf.\n", "operationId": "download_signing_document", "parameters": [ { "in": "path", "name": "signing_document_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } } }, "description": "The signing document binary data" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Download signing document", "tags": ["Core Resources | Signing documents"] } }, "/live_photos": { "get": { "description": "Lists the live photos that belong to an applicant.\n", "operationId": "list_live_photos", "parameters": [ { "description": "The id of the applicant the live photos belong to.", "in": "query", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Live_Photos_list" } } }, "description": "An array of live photos" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List live photos", "tags": ["Core Resources | Live photos"] }, "post": { "description": "You can upload live photos to this endpoint. Like document upload, files must be uploaded as a multipart form. Valid file types are jpg, png and pdf. The file size must be between 32KB and 10MB. Live photos are validated at the point of upload to check that they contain exactly one face. This validation can be disabled by setting the advanced_validation argument to false.\n", "operationId": "upload_live_photo", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/live_photo_uploader" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/live_photo" } } }, "description": "The Live Photo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Upload live photo", "tags": ["Core Resources | Live photos"] } }, "/live_photos/{live_photo_id}": { "get": { "description": "Retrieves a single live photo. Returns a live photo object.\n", "operationId": "find_live_photo", "parameters": [ { "description": "The live photo's unique identifier.", "in": "path", "name": "live_photo_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/live_photo" } } }, "description": "A live photo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve live photo", "tags": ["Core Resources | Live photos"] } }, "/live_photos/{live_photo_id}/download": { "get": { "description": "Live photos are downloaded using this endpoint.", "operationId": "download_live_photo", "parameters": [ { "description": "The live photo's unique identifier.", "in": "path", "name": "live_photo_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } } }, "description": "The live photo's binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Download live photo", "tags": ["Core Resources | Live photos"] } }, "/live_videos": { "get": { "description": "Lists all the live videos that belong to an applicant.\n", "operationId": "list_live_videos", "parameters": [ { "description": "The id of the applicant the live videos belong to.", "in": "query", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Live_Videos_list" } } }, "description": "An array of live videos" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List live videos", "tags": ["Core Resources | Live videos"] } }, "/live_videos/{live_video_id}": { "get": { "description": "Retrieves a single live video. Returns the corresponding live video object.\n", "operationId": "find_live_video", "parameters": [ { "description": "The live video's unique identifier.", "in": "path", "name": "live_video_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/live_video" } } }, "description": "A live video" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve live video", "tags": ["Core Resources | Live videos"] } }, "/live_videos/{live_video_id}/download": { "get": { "description": "Live videos are downloaded using this endpoint.", "operationId": "download_live_video", "parameters": [ { "description": "The live video's unique identifier.", "in": "path", "name": "live_video_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } } }, "description": "The live video's binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Download live video", "tags": ["Core Resources | Live videos"] } }, "/live_videos/{live_video_id}/frame": { "get": { "description": "Returns the binary data representing a single frame from a live video.", "operationId": "download_live_video_frame", "parameters": [ { "description": "The live video's unique identifier.", "in": "path", "name": "live_video_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } } }, "description": "The live video frame's binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Download live video frame", "tags": ["Core Resources | Live videos"] } }, "/workflow_runs/{workflow_run_id}/tasks": { "get": { "description": "The tasks of a Workflow can be retrieved by calling this endpoint with the unique identifier of the Workflow Run.\n", "operationId": "list_tasks", "parameters": [ { "description": "The unique identifier of the Workflow Run to which the Tasks belong.", "in": "path", "name": "workflow_run_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/TaskItem" }, "title": "Tasks", "type": "array" } } }, "description": "An array of subset Task objects that were already started or completed, ordered by the created_at field, in ascending order." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List Tasks", "tags": ["Core Resources | Tasks"] } }, "/workflow_runs/{workflow_run_id}/tasks/{task_id}": { "get": { "description": "A single task can be retrieved by calling this endpoint with the unique identifier of the Task and Workflow Run.\n", "operationId": "find_task", "parameters": [ { "description": "The unique identifier of the Workflow Run to which the Task belongs.", "in": "path", "name": "workflow_run_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, { "description": "The identifier of the Task you want to retrieve.", "in": "path", "name": "task_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/task" } } }, "description": "A Task object." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve Task", "tags": ["Core Resources | Tasks"] } }, "/workflow_runs/{workflow_run_id}/tasks/{task_id}/complete": { "post": { "description": "Completes a Send / Receive Data Task.\n", "operationId": "complete_task", "parameters": [ { "description": "The unique identifier of the Workflow Run to which the Task belongs.", "in": "path", "name": "workflow_run_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, { "description": "The identifier of the Task you want to complete.", "in": "path", "name": "task_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/complete_task_builder" } } }, "required": true }, "responses": { "200": { "description": "An empty response body." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Complete Task", "tags": ["Core Resources | Tasks"] } }, "/motion_captures": { "get": { "description": "Lists all the motion captures that belong to an applicant.\n", "operationId": "list_motion_captures", "parameters": [ { "description": "The id of the applicant the motion captures belong to.", "in": "query", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Motion_Captures_list" } } }, "description": "An array of motion captures" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List motion captures", "tags": ["Core Resources | Motion captures"] } }, "/motion_captures/{motion_capture_id}": { "get": { "description": "Retrieves a single motion capture. Returns the corresponding motion capture object.\n", "operationId": "find_motion_capture", "parameters": [ { "description": "The motion capture's unique identifier.", "in": "path", "name": "motion_capture_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/motion_capture" } } }, "description": "A motion capture" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve motion capture", "tags": ["Core Resources | Motion captures"] } }, "/motion_captures/{motion_capture_id}/download": { "get": { "description": "Motion captures are downloaded using this endpoint.", "operationId": "download_motion_capture", "parameters": [ { "description": "The motion capture's unique identifier.", "in": "path", "name": "motion_capture_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } } }, "description": "The motion capture's binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Download motion capture", "tags": ["Core Resources | Motion captures"] } }, "/motion_captures/{motion_capture_id}/frame": { "get": { "description": "Instead of the whole capture binary, a single frame can be downloaded using this endpoint. Returns the binary data representing the frame.", "operationId": "download_motion_capture_frame", "parameters": [ { "description": "The motion capture's unique identifier.", "in": "path", "name": "motion_capture_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } } }, "description": "The motion capture frame's binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Download motion capture frame", "tags": ["Core Resources | Motion captures"] } }, "/biometric_tokens/{user_id}": { "delete": { "description": "Invalidates every biometric token associated with the supplied customer user ID.\n", "operationId": "invalidate_biometric_tokens", "parameters": [ { "description": "Customer user ID whose biometric tokens will be invalidated.", "in": "path", "name": "user_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Invalidated_biometric_tokens_response" } } }, "description": "Biometric tokens invalidated" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Invalidate biometric tokens", "tags": ["Core Resources | Biometric tokens"] }, "get": { "description": "Returns the biometric tokens associated with the supplied customer user ID.\n", "operationId": "list_biometric_tokens", "parameters": [ { "description": "Customer user ID that owns the biometric tokens.", "in": "path", "name": "user_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Biometric_tokens_response" } } }, "description": "Biometric tokens belonging to the user" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List biometric tokens", "tags": ["Core Resources | Biometric tokens"] } }, "/biometric_tokens/{user_id}/{token_uuid}": { "delete": { "description": "Invalidates a biometric token.\n", "operationId": "invalidate_biometric_token", "parameters": [ { "description": "Customer user ID that owns the biometric token.", "in": "path", "name": "user_id", "required": true, "schema": { "type": "string" } }, { "description": "Biometric token UUID.", "in": "path", "name": "token_uuid", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Invalidated_biometric_token_response" } } }, "description": "Biometric token invalidated" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Invalidate biometric token", "tags": ["Core Resources | Biometric tokens"] }, "get": { "description": "Returns a biometric token's details.\n", "operationId": "find_biometric_token", "parameters": [ { "description": "Customer user ID that owns the biometric token.", "in": "path", "name": "user_id", "required": true, "schema": { "type": "string" } }, { "description": "Biometric token UUID.", "in": "path", "name": "token_uuid", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Biometric_token_response" } } }, "description": "The requested biometric token" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve biometric token", "tags": ["Core Resources | Biometric tokens"] }, "put": { "description": "Updates a biometric token's status.\n", "operationId": "update_biometric_token", "parameters": [ { "description": "Customer user ID that owns the biometric token.", "in": "path", "name": "user_id", "required": true, "schema": { "type": "string" } }, { "description": "Biometric token UUID.", "in": "path", "name": "token_uuid", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/biometric_token_updater" } } }, "description": "Biometric token update payload.", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Updated_biometric_token_response" } } }, "description": "Biometric token updated" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Update biometric token", "tags": ["Core Resources | Biometric tokens"] } }, "/watchlist_monitors": { "get": { "description": "List all available monitors for an applicant\n", "operationId": "list_watchlist_monitors", "parameters": [ { "description": "The id of the applicant the watchlist monitors belong to. If omitted, all monitors for the account will be listed.", "in": "query", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, { "description": "Whether to also include deleted (inactive) monitors.", "in": "query", "name": "include_deleted", "schema": { "default": false, "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Watchlist_monitors_list" } } }, "description": "An array of watchlist monitors" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List monitors", "tags": ["Core Resources | Monitors"] }, "post": { "description": "Creates a new monitor for the applicant\n", "operationId": "create_watchlist_monitor", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/watchlist_monitor_builder" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/watchlist_monitor" } } }, "description": "Created" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Create monitor", "tags": ["Core Resources | Monitors"] } }, "/watchlist_monitors/{monitor_id}": { "delete": { "description": "Deactivates the given monitor\n", "operationId": "delete_watchlist_monitor", "parameters": [ { "in": "path", "name": "monitor_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "204": { "description": "No Content" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Delete monitor", "tags": ["Core Resources | Monitors"] }, "get": { "description": "Retrieves a single monitor\n", "operationId": "find_watchlist_monitor", "parameters": [ { "description": "The watchlist monitor's unique identifier.", "in": "path", "name": "monitor_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/watchlist_monitor" } } }, "description": "A watchlist monitor" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve monitor", "tags": ["Core Resources | Monitors"] } }, "/watchlist_monitors/{monitor_id}/matches": { "get": { "description": "List match IDs on this monitor, as well as their enabled/disabled status\n", "operationId": "list_watchlist_monitor_matches", "parameters": [ { "in": "path", "name": "monitor_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/watchlist_monitor_matches_list" } } }, "description": "An array of watchlist monitors" } }, "summary": "List matches (BETA)", "tags": ["Core Resources | Monitors"] }, "patch": { "description": "Update the status of the given matches\n", "operationId": "update_watchlist_monitor_match", "parameters": [ { "in": "path", "name": "monitor_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/watchlist_monitor_matches_updater" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/watchlist_monitor_matches_list" } } }, "description": "An array of watchlist monitors" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Set match status (BETA)", "tags": ["Core Resources | Monitors"] } }, "/watchlist_monitors/{monitor_id}/new_report": { "post": { "description": "Triggers a new check with an updated report to be generated by the monitor, as if the monitor had received an update.\n", "operationId": "force_report_creation_from_watchlist_monitor", "parameters": [ { "in": "path", "name": "monitor_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "201": { "description": "Created", "headers": { "Location": { "description": "Link to the newly generated report.", "schema": { "type": "string" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Force new report creation (BETA)", "tags": ["Core Resources | Monitors"] } }, "/complyadvantage_watchlists/alerts/{alert_id}/risks": { "get": { "description": "Retrieves the detailed risks associated with a watchlist mesh alert.\n", "operationId": "list_watchlist_mesh_alert_risks", "parameters": [ { "description": "The unique identifier of the alert whose risks you want to retrieve.", "in": "path", "name": "alert_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, { "description": "The page of results to retrieve.", "in": "query", "name": "page", "required": false, "schema": { "default": 1, "type": "integer" } }, { "description": "The number of risks to return per page.", "in": "query", "name": "per_page", "required": false, "schema": { "default": 25, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/watchlist_mesh_alert_risk" }, "title": "Watchlist alert risks", "type": "array" } } }, "description": "An array of watchlist alert risks.", "headers": { "X-Total-Count": { "description": "The total number of risks associated with the alert.", "schema": { "type": "integer" } } } }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve watchlist mesh alert risks", "tags": ["Core Resources | ComplyAdvantage Watchlists"] } }, "/id_photos": { "get": { "description": "Lists the ID photos that belong to an applicant.\n", "operationId": "list_id_photos", "parameters": [ { "description": "The id of the applicant the ID photos belong to.", "in": "query", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Id_Photos_list" } } }, "description": "An array of ID photos" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List ID photos", "tags": ["Core Resources | ID Photos"] }, "post": { "description": "You can upload ID photos to this endpoint. Like document upload, files must be uploaded as a multipart form. Valid file types are jpg, png and pdf. The file size must be between 32KB and 10MB.\n", "operationId": "upload_id_photo", "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/id_photo_uploader" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/id_photo" } } }, "description": "The ID photo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Upload ID photo", "tags": ["Core Resources | ID Photos"] } }, "/id_photos/{id_photo_id}": { "get": { "description": "Retrieves a single ID photo. Returns a ID photo object.\n", "operationId": "find_id_photo", "parameters": [ { "description": "The ID photo's unique identifier.", "in": "path", "name": "id_photo_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/id_photo" } } }, "description": "A ID photo" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve ID photo", "tags": ["Core Resources | ID Photos"] } }, "/id_photos/{id_photo_id}/download": { "get": { "description": "ID photos are downloaded using this endpoint.", "operationId": "download_id_photo", "parameters": [ { "description": "The ID photo's unique identifier.", "in": "path", "name": "id_photo_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "*/*": { "schema": { "format": "binary", "type": "string" } } }, "description": "The ID photo's binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Download ID photo", "tags": ["Core Resources | ID Photos"] } }, "/qualified_electronic_signature/documents": { "get": { "description": "Retrieves the signed document or application form depending on the file_id provided.\n", "operationId": "download_qes_document", "parameters": [ { "description": "The unique identifier of the Workflow Run for which you want to retrieve the signed document.", "in": "query", "name": "workflow_run_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, { "description": "The unique identifier of the file which you want to retrieve.", "in": "query", "name": "file_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "302": { "description": "Found", "headers": { "Location": { "description": "Pre-signed URL to download the file.", "schema": { "format": "uri", "type": "string" } } } }, "200": { "content": { "application/pdf": { "schema": { "format": "binary", "type": "string" } } }, "description": "The signed document PDF binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieves the signed document or application form", "tags": ["Core Resources | Qualified Electronic Signature"] } }, "/advanced_electronic_signature/documents": { "get": { "description": "Retrieves the signed document or signing transaction receipt depending on the id provided.\n", "operationId": "download_aes_document", "parameters": [ { "description": "The unique identifier of the Workflow Run for which you want to retrieve the signed document.", "in": "query", "name": "workflow_run_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, { "description": "The unique identifier of the file which you want to retrieve.", "in": "query", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "302": { "description": "Found", "headers": { "Location": { "description": "Pre-signed URL to download the file.", "schema": { "format": "uri", "type": "string" } } } }, "200": { "content": { "application/pdf": { "schema": { "format": "binary", "type": "string" } } }, "description": "The signed document PDF binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieves the signed document or signing transaction receipt", "tags": ["Core Resources | Advanced Electronic Signature"] } }, "/simple_electronic_signature/documents": { "get": { "description": "Retrieves the signed document or signing transaction receipt depending on the id provided.\n", "operationId": "download_ses_document", "parameters": [ { "description": "The unique identifier of the Workflow Run for which you want to retrieve the signed document.", "in": "query", "name": "workflow_run_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, { "description": "The unique identifier of the file which you want to retrieve.", "in": "query", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "302": { "description": "Found", "headers": { "Location": { "description": "Pre-signed URL to download the file.", "schema": { "format": "uri", "type": "string" } } } }, "200": { "content": { "application/pdf": { "schema": { "format": "binary", "type": "string" } } }, "description": "The signed document PDF binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieves the signed document or signing transaction receipt", "tags": ["Core Resources | Simple Electronic Signature"] } }, "/workflow_runs/{workflow_run_id}/timeline_file": { "post": { "description": "Triggers the generation of the Timeline File for the designated Workflow Run.\n", "operationId": "create_timeline_file", "parameters": [ { "description": "The unique identifier of the Workflow Run.", "in": "path", "name": "workflow_run_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/timeline_file_reference" } } }, "description": "A Timeline File reference." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Create Timeline File for Workflow Run", "tags": ["Core Resources | Timeline Files"] } }, "/workflow_runs/{workflow_run_id}/timeline_file/{timeline_file_id}": { "get": { "description": "Retrieves the Timeline File for the designated Workflow Run.\n", "operationId": "find_timeline_file", "parameters": [ { "description": "The unique identifier of the Workflow Run.", "in": "path", "name": "workflow_run_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, { "description": "The unique identifier for the Timefile File.", "in": "path", "name": "timeline_file_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "302": { "description": "Found", "headers": { "Location": { "description": "Link to the Timeline File.", "schema": { "format": "uri", "type": "string" } } } }, "200": { "content": { "application/pdf": { "schema": { "format": "binary", "type": "string" } } }, "description": "The Timeline File PDF binary data." }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve Timeline File for Workflow Run", "tags": ["Core Resources | Timeline Files"] } }, "/passkeys/{username}": { "delete": { "description": "Removes every passkey for the username.\n", "operationId": "delete_passkeys", "parameters": [ { "description": "Username whose passkeys will be deleted.", "in": "path", "name": "username", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "All passkeys deleted" }, "404": { "description": "Passkey not found" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Delete passkeys", "tags": ["Core Resources | Passkeys"] }, "get": { "description": "Returns every passkey registered under the supplied username.\n", "operationId": "list_passkeys", "parameters": [ { "description": "Username that owns the passkeys.", "in": "path", "name": "username", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Passkeys_list" } } }, "description": "Passkeys belonging to the username" }, "404": { "description": "Passkey not found" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List passkeys", "tags": ["Core Resources | Passkeys"] } }, "/passkeys/{username}/{passkey_id}": { "delete": { "description": "Deletes a passkey.\n", "operationId": "delete_passkey", "parameters": [ { "description": "Username that owns the passkey.", "in": "path", "name": "username", "required": true, "schema": { "type": "string" } }, { "description": "Passkey ID.", "in": "path", "name": "passkey_id", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Passkey deleted" }, "404": { "description": "Passkey not found" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Delete passkey", "tags": ["Core Resources | Passkeys"] }, "get": { "description": "Returns a passkey's details.\n", "operationId": "find_passkey", "parameters": [ { "description": "Username that owns the passkey.", "in": "path", "name": "username", "required": true, "schema": { "type": "string" } }, { "description": "Passkey ID.", "in": "path", "name": "passkey_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/passkey" } } }, "description": "The requested passkey" }, "404": { "description": "Passkey not found" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve passkey", "tags": ["Core Resources | Passkeys"] }, "put": { "description": "Updates a passkey's state.\n", "operationId": "update_passkey", "parameters": [ { "description": "Username that owns the passkey.", "in": "path", "name": "username", "required": true, "schema": { "type": "string" } }, { "description": "Passkey ID.", "in": "path", "name": "passkey_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/passkey_updater" } } }, "description": "Passkey update payload.", "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/passkey" } } }, "description": "Passkey updated" }, "400": { "description": "Invalid request body" }, "404": { "description": "Passkey not found" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Update passkey", "tags": ["Core Resources | Passkeys"] } }, "/ping": { "get": { "description": "Run a health check on the Onfido API\n", "operationId": "ping", "responses": { "200": { "content": { "text/plain": { "schema": { "type": "string" } } }, "description": "Regional base URL is operational" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Ping", "tags": ["Other Endpoints | Ping"] } }, "/webhooks": { "get": { "description": "Lists all webhooks you've created.\n", "operationId": "list_webhooks", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Webhooks_list" } } }, "description": "A list of webhooks" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List webhooks", "tags": ["Other Endpoints | Webhooks"] }, "post": { "callbacks": { "webhookEvent": { "{$request.body#/url}": { "post": { "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/webhook_event" } } }, "required": true }, "responses": { "default": { "description": "Your server should acknowledge success by responding with an HTTP 20x response within 10 seconds." } } } } } }, "description": "Registers a webhook. Returns a webhook object.\n", "operationId": "create_webhook", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/webhook_builder" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/webhook" } } }, "description": "Created" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Register webhook", "tags": ["Other Endpoints | Webhooks"] } }, "/webhooks/{webhook_id}": { "delete": { "description": "Deletes a webhook.\n", "operationId": "delete_webhook", "parameters": [ { "in": "path", "name": "webhook_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "204": { "description": "Webhook deleted" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Delete a webhook", "tags": ["Other Endpoints | Webhooks"] }, "get": { "description": "Retrieves a single webhook. Returns a webhook object.\n", "operationId": "find_webhook", "parameters": [ { "in": "path", "name": "webhook_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/webhook" } } }, "description": "Webhook object" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve a Webhook", "tags": ["Other Endpoints | Webhooks"] }, "put": { "description": "Edits a webhook. Returns the updated webhook object.\n", "operationId": "update_webhook", "parameters": [ { "in": "path", "name": "webhook_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/webhook_updater" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/webhook" } } }, "description": "Webhook Object" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Edit a webhook", "tags": ["Other Endpoints | Webhooks"] } }, "/webhooks/resend": { "post": { "description": "Resends events to all webhooks registered with a matching environment in your account.\n", "operationId": "resend_webhooks", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/webhook_resend" } } }, "required": true }, "responses": { "204": { "description": "Webhooks are resent for the respective checks" }, "422": { "description": "Request was received but it could not be processed" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Resends webhooks", "tags": ["Other Endpoints | Webhooks"] } }, "/addresses/pick": { "get": { "description": "Search for addresses by postcode\n", "operationId": "find_addresses", "parameters": [ { "in": "query", "name": "postcode", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Addresses_list" } } }, "description": "A list of addresses" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Address Picker", "tags": ["Other Endpoints | Address Picker"] } }, "/sdk_token": { "post": { "description": "Generates an SDK token. Returns a token object containing the SDK token.\n", "operationId": "generate_sdk_token", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sdk_token_builder" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/sdk_token" } } }, "description": "Generated" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Generate a SDK token", "tags": ["Other Endpoints | Generate SDK Token"] } }, "/repeat_attempts/{report_id}": { "get": { "description": "Returns all repeat attempts for a given Document report\n", "operationId": "list_repeat_attempts", "parameters": [ { "in": "path", "name": "report_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/repeat_attempts_list" } } }, "description": "Repeat attempts object" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve repeat attempts", "tags": ["Other Endpoints | Repeat attempts"] } }, "/extractions": { "post": { "description": "Extract information from a document\n", "operationId": "extract", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/extract_request" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/extraction" } } }, "description": "Extraction result" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error_1" } } }, "description": "Unprocessable Entity" } }, "summary": "Autofill", "tags": ["Other Endpoints | Autofill"] } }, "/results_feedback": { "post": { "description": "Create Feedback on checks and reports\n", "operationId": "post_results_feedback", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/results_feedback" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/results_feedback" } } }, "description": "Created feedback" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Fraud reporting (ALPHA)", "tags": ["Other Endpoints | Fraud reporting (ALPHA)"] } }, "/checks": { "get": { "description": "Retrieves a single check. Returns a check object.\n", "operationId": "list_checks", "parameters": [ { "in": "query", "name": "applicant_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Checks_list" } } }, "description": "An array of checks" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve Checks", "tags": ["Other Endpoints | Checks"] }, "post": { "description": "Initiates a check for an applicant, which can contain one or more reports. Returns a check object.\n", "operationId": "create_check", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/check_builder" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/check" } } }, "description": "Created" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Create a check", "tags": ["Other Endpoints | Checks"] } }, "/checks/{check_id}": { "get": { "description": "Retrieves a single check. Returns a check object.\n", "operationId": "find_check", "parameters": [ { "in": "path", "name": "check_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/check" } } }, "description": "Check object" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve a Check", "tags": ["Other Endpoints | Checks"] } }, "/checks/{check_id}/resume": { "post": { "description": "Resumes a paused check.\n", "operationId": "resume_check", "parameters": [ { "in": "path", "name": "check_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "204": { "description": "No Content" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Resume a Check", "tags": ["Other Endpoints | Checks"] } }, "/checks/{check_id}/download": { "get": { "description": "Downloads a PDF of a check with a given check ID. Returns the binary data representing the PDF.\n", "operationId": "download_check", "parameters": [ { "in": "path", "name": "check_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/pdf": { "schema": { "format": "binary", "type": "string" } } }, "description": "The check PDF binary data" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Download check", "tags": ["Other Endpoints | Checks"] } }, "/reports": { "get": { "description": "All the reports belonging to a particular check can be listed from this endpoint.\n", "operationId": "list_reports", "parameters": [ { "in": "query", "name": "check_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Reports_list" } } }, "description": "List of Reports" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "List reports", "tags": ["Other Endpoints | Reports"] } }, "/reports/{report_id}": { "get": { "description": "A single report can be retrieved using this endpoint with the corresponding unique identifier.\n", "operationId": "find_report", "parameters": [ { "in": "path", "name": "report_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/report" } } }, "description": "Report object" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Retrieve report", "tags": ["Other Endpoints | Reports"] } }, "/reports/{report_id}/resume": { "post": { "description": "Resumes a single paused report.\n", "operationId": "resume_report", "parameters": [ { "in": "path", "name": "report_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "204": { "description": "No Content" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Resume report", "tags": ["Other Endpoints | Reports"] } }, "/reports/{report_id}/cancel": { "post": { "description": "Cancels single paused reports.\n", "operationId": "cancel_report", "parameters": [ { "in": "path", "name": "report_id", "required": true, "schema": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } } ], "responses": { "204": { "description": "No Content" }, "default": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" } }, "summary": "Cancel report", "tags": ["Other Endpoints | Reports"] } } }, "components": { "responses": { "default_error": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unexpected error" }, "document_extraction_error": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error_1" } } }, "description": "Unprocessable Entity" } }, "schemas": { "applicant": { "allOf": [ { "$ref": "#/components/schemas/applicant_shared" }, { "$ref": "#/components/schemas/applicant_response" } ] }, "applicant_builder": { "allOf": [ { "$ref": "#/components/schemas/applicant_shared" }, { "$ref": "#/components/schemas/applicant_request" }, { "$ref": "#/components/schemas/applicant_create" } ] }, "applicant_updater": { "allOf": [ { "$ref": "#/components/schemas/applicant_shared" }, { "$ref": "#/components/schemas/applicant_request" }, { "$ref": "#/components/schemas/applicant_update" } ] }, "applicant_consent": { "properties": { "name": { "$ref": "#/components/schemas/applicant_consent_name" }, "granted": { "type": "boolean" }, "granted_at": { "description": "The date and time when this applicant consent was granted, if not granted the value is nil.", "format": "date-time", "nullable": true, "type": "string" } }, "required": ["granted", "granted_at", "name"], "type": "object" }, "applicant_consent_name": { "enum": [ "privacy_notices_read", "ssn_verification", "phone_number_verification" ], "type": "string" }, "workflow_run": { "allOf": [ { "$ref": "#/components/schemas/workflow_run_shared" }, { "$ref": "#/components/schemas/workflow_run_response" } ] }, "workflow_run_builder": { "allOf": [ { "$ref": "#/components/schemas/workflow_run_shared" }, { "$ref": "#/components/schemas/workflow_run_request" } ] }, "document": { "allOf": [ { "$ref": "#/components/schemas/document_shared" }, { "$ref": "#/components/schemas/document_response" } ] }, "document_uploader": { "allOf": [ { "$ref": "#/components/schemas/document_shared" }, { "$ref": "#/components/schemas/document_request" } ], "required": ["applicant_id", "file", "type"] }, "signing_document": { "allOf": [ { "$ref": "#/components/schemas/signing_document_shared" }, { "$ref": "#/components/schemas/signing_document_response" } ] }, "signing_document_uploader": { "allOf": [ { "$ref": "#/components/schemas/signing_document_shared" }, { "$ref": "#/components/schemas/signing_document_request" } ], "required": ["applicant_id", "file"] }, "live_photo": { "allOf": [ { "$ref": "#/components/schemas/live_photo_response" } ] }, "live_photo_uploader": { "allOf": [ { "$ref": "#/components/schemas/live_photo_request" } ], "required": ["applicant_id", "file"] }, "live_video": { "properties": { "id": { "description": "The unique identifier for the video.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "created_at": { "description": "The date and time at which the video was uploaded.", "format": "date-time", "type": "string" }, "href": { "description": "The uri of this resource.", "type": "string" }, "download_href": { "description": "The uri that can be used to download the video.", "type": "string" }, "file_name": { "description": "The name of the uploaded file.", "type": "string" }, "file_size": { "description": "The size of the file in bytes.", "type": "integer" }, "file_type": { "description": "The file type of the uploaded file.", "type": "string", "example": "png" }, "challenge": { "description": "Challenge the end user was asked to perform during the video recording.", "items": { "additionalProperties": true, "type": "object" }, "type": "array" } }, "type": "object" }, "task_id": { "description": "The identifier for the Task.", "example": "profile_123", "pattern": "^[0-9a-z_-]+$", "type": "string" }, "task_def_id": { "description": "The identifier for the Task Definition.", "example": "task_123", "pattern": "^[0-9a-z_-]+$", "type": "string" }, "task": { "properties": { "id": { "$ref": "#/components/schemas/task_id" }, "workflow_run_id": { "description": "The workflow run id the task belongs to.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "task_def_id": { "$ref": "#/components/schemas/task_def_id" }, "task_def_version": { "description": "The task definition version.", "nullable": true, "type": "string" }, "input": { "description": "Input object with the fields used by the Task to execute.", "type": "object" }, "output": { "description": "Value field (it can be an Object, List, etc.) with the fields produced by the Task execution.", "nullable": true, "type": "object" }, "created_at": { "description": "The date and time when the Task was created.", "format": "date-time", "type": "string" }, "updated_at": { "description": "The date and time when the Task was last updated.", "format": "date-time", "type": "string" } }, "type": "object" }, "complete_task_builder": { "properties": { "data": { "$ref": "#/components/schemas/Complete_Task_Data_Builder" } }, "required": ["data"], "type": "object" }, "motion_capture": { "properties": { "id": { "description": "The unique identifier for the motion capture.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "created_at": { "description": "The date and time at which the motion capture was uploaded.", "format": "date-time", "type": "string" }, "href": { "description": "The uri of this resource.", "type": "string" }, "download_href": { "description": "The uri that can be used to download the motion capture.", "type": "string" }, "file_name": { "description": "The name of the uploaded file.", "type": "string" }, "file_size": { "description": "The size of the file in bytes.", "type": "integer" }, "file_type": { "description": "The file type of the uploaded file.", "type": "string", "example": "png" } }, "type": "object" }, "biometric_token": { "description": "Biometric token.", "properties": { "uuid": { "description": "The biometric token's unique identifier.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "data": { "$ref": "#/components/schemas/biometric_token_data" } }, "required": ["data", "uuid"], "title": "Biometric token", "type": "object" }, "invalidated_biometric_token_summary": { "description": "Invalidated biometric tokens response payload.", "properties": { "deleted_items": { "$ref": "#/components/schemas/invalidated_biometric_token_summary_deleted_items" } }, "required": ["deleted_items"], "title": "Invalidated biometric tokens summary", "type": "object" }, "biometric_token_updater": { "properties": { "status": { "description": "Desired biometric token status value.", "enum": ["approved", "declined"], "type": "string" } }, "required": ["status"], "title": "Biometric token updater", "type": "object" }, "watchlist_monitor": { "allOf": [ { "$ref": "#/components/schemas/watchlist_monitor_shared" }, { "$ref": "#/components/schemas/watchlist_monitor_response" } ] }, "watchlist_monitor_builder": { "allOf": [ { "$ref": "#/components/schemas/watchlist_monitor_shared" } ] }, "watchlist_monitor_matches_list": { "properties": { "matches": { "items": { "$ref": "#/components/schemas/Watchlist_monitor_match" }, "type": "array" } }, "required": ["matches"], "title": "Watchlist monitor matches list", "type": "object" }, "watchlist_monitor_matches_updater": { "properties": { "enable": { "items": { "description": "Match ID to enable.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "type": "array" }, "disable": { "items": { "description": "Match ID to disable.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "type": "array" } }, "type": "object" }, "watchlist_mesh_alert_risk": { "allOf": [ { "$ref": "#/components/schemas/watchlist_mesh_alert_risk_1" } ] }, "id_photo": { "allOf": [ { "$ref": "#/components/schemas/id_photo_response" } ] }, "id_photo_uploader": { "allOf": [ { "$ref": "#/components/schemas/id_photo_request" } ], "required": ["applicant_id", "file"] }, "timeline_file_reference": { "properties": { "workflow_timeline_file_id": { "description": "The unique identifier for the Timefile File that will be created.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "href": { "description": "Link to access the Timefile File that will be created.", "type": "string" } }, "required": ["href", "workflow_timeline_file_id"], "type": "object" }, "passkey": { "properties": { "id": { "description": "Passkey identifier.", "type": "string" }, "application_domain": { "description": "domain that the passkey is registered to, the rpId.", "type": "string" }, "state": { "description": "Current passkey state.", "enum": ["ACTIVE", "INACTIVE"], "type": "string" }, "created_at": { "description": "Timestamp when the passkey was created.", "format": "date-time", "type": "string" }, "last_used_at": { "description": "Timestamp when the passkey was last used.", "format": "date-time", "type": "string" } }, "required": ["application_domain", "created_at", "id", "state"], "title": "Passkey", "type": "object" }, "passkey_updater": { "properties": { "state": { "description": "Desired passkey state value.", "enum": ["ACTIVE", "INACTIVE"], "type": "string" } }, "required": ["state"], "title": "Passkey updater", "type": "object" }, "webhook": { "allOf": [ { "$ref": "#/components/schemas/webhook_shared" }, { "$ref": "#/components/schemas/webhook_response" } ] }, "webhook_builder": { "allOf": [ { "$ref": "#/components/schemas/webhook_shared" }, { "$ref": "#/components/schemas/webhook_create" } ] }, "webhook_event": { "properties": { "payload": { "$ref": "#/components/schemas/webhook_event_payload" } }, "type": "object" }, "webhook_event_object_status": { "description": "The current state of the object, if available.", "enum": [ "processing", "awaiting_input", "awaiting_client_input", "approved", "declined", "review", "abandoned", "error", "started", "cancelled", "completed", "awaiting_data", "awaiting_approval", "complete", "withdrawn", "in_progress", "awaiting_applicant", "paused", "reopened" ], "example": "complete", "type": "string" }, "webhook_event_resource_status": { "description": "The current state of the reference, if available.", "enum": [ "processing", "awaiting_input", "awaiting_client_input", "approved", "declined", "review", "abandoned", "error", "started", "cancelled", "completed" ], "example": "completed", "type": "string" }, "webhook_updater": { "allOf": [ { "$ref": "#/components/schemas/webhook_shared" }, { "$ref": "#/components/schemas/webhook_update" } ] }, "webhook_resend": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Webhooks_resend_item" }, "title": "Webhooks resend list", "type": "array" } }, "type": "object" }, "address": { "allOf": [ { "$ref": "#/components/schemas/address_shared" } ] }, "sdk_token_builder": { "allOf": [ { "$ref": "#/components/schemas/sdk_token_request" } ] }, "sdk_token": { "allOf": [ { "$ref": "#/components/schemas/sdk_token_response" } ] }, "repeat_attempts_list": { "properties": { "report_id": { "description": "The unique identifier of the completed Document report.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "repeat_attempts": { "description": "An array of repeat attempt objects. If no repeat attempts were found, the array will be empty. The number of objects returned can increase over time if more matches are received.\n", "items": { "$ref": "#/components/schemas/repeat_attempts_list_repeat_attempts_inner" }, "type": "array" }, "attempts_count": { "description": "The total number of attempts using the same document, including the current report under assessment.", "type": "integer" }, "attempts_clear_rate": { "description": "A number between 0 and 1 which indicates the proportion of attempts that have been cleared, including the current report under assessment.", "format": "float", "maximum": 1, "minimum": 0, "type": "number" }, "unique_mismatches_count": { "description": "The number of unique entries in the repeat_attempts field for which at least one of the fields is a mismatch.", "type": "integer" } }, "required": ["repeat_attempts"], "type": "object" }, "extraction": { "properties": { "document_id": { "description": "The unique identifier of the uploaded document.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "document_classification": { "$ref": "#/components/schemas/extraction_document_classification" }, "extracted_data": { "$ref": "#/components/schemas/extraction_extracted_data" } }, "type": "object" }, "results_feedback": { "properties": { "expected_result": { "description": "The expected result for the check or report.", "enum": ["clear", "consider"], "type": "string" }, "check_id": { "description": "The ID of the check (only if report_id is not provided).", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "report_id": { "description": "The ID of the check (only if check_id is not provided).", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "feedback_notes": { "description": "Any additional information or feedback.", "type": "string" } }, "type": "object" }, "check": { "allOf": [ { "$ref": "#/components/schemas/check_shared" }, { "$ref": "#/components/schemas/check_response" } ] }, "check_builder": { "allOf": [ { "$ref": "#/components/schemas/check_shared" }, { "$ref": "#/components/schemas/check_request" } ] }, "report": { "discriminator": { "mapping": { "document": "#/components/schemas/document_report", "document_video": "#/components/schemas/document_video_report", "document_video_with_address_information": "#/components/schemas/document_video_with_address_information_report", "document_with_address_information": "#/components/schemas/document_with_address_information_report", "document_with_driving_licence_information": "#/components/schemas/document_with_driving_licence_information_report", "document_with_driver_verification": "#/components/schemas/document_with_driver_verification_report", "facial_similarity_photo": "#/components/schemas/facial_similarity_photo_report", "facial_similarity_photo_fully_auto": "#/components/schemas/facial_similarity_photo_fully_auto_report", "facial_similarity_video": "#/components/schemas/facial_similarity_video_report", "facial_similarity_motion": "#/components/schemas/facial_similarity_motion_report", "known_faces": "#/components/schemas/known_faces_report", "identity_enhanced": "#/components/schemas/identity_enhanced_report", "watchlist_aml": "#/components/schemas/watchlist_aml_report", "watchlist_enhanced": "#/components/schemas/watchlist_enhanced_report", "watchlist_standard": "#/components/schemas/watchlist_standard_report", "watchlist_peps_only": "#/components/schemas/watchlist_peps_only_report", "watchlist_sanctions_only": "#/components/schemas/watchlist_sanctions_only_report", "proof_of_address": "#/components/schemas/proof_of_address_report", "us_driving_licence": "#/components/schemas/us_driving_licence_report", "device_intelligence": "#/components/schemas/device_intelligence_report", "india_pan": "#/components/schemas/india_pan_report" }, "propertyName": "name" }, "oneOf": [ { "$ref": "#/components/schemas/document_report" }, { "$ref": "#/components/schemas/document_video_report" }, { "$ref": "#/components/schemas/document_video_with_address_information_report" }, { "$ref": "#/components/schemas/document_with_address_information_report" }, { "$ref": "#/components/schemas/document_with_driving_licence_information_report" }, { "$ref": "#/components/schemas/document_with_driver_verification_report" }, { "$ref": "#/components/schemas/facial_similarity_photo_report" }, { "$ref": "#/components/schemas/facial_similarity_photo_fully_auto_report" }, { "$ref": "#/components/schemas/facial_similarity_video_report" }, { "$ref": "#/components/schemas/facial_similarity_motion_report" }, { "$ref": "#/components/schemas/known_faces_report" }, { "$ref": "#/components/schemas/identity_enhanced_report" }, { "$ref": "#/components/schemas/watchlist_aml_report" }, { "$ref": "#/components/schemas/watchlist_enhanced_report" }, { "$ref": "#/components/schemas/watchlist_standard_report" }, { "$ref": "#/components/schemas/watchlist_peps_only_report" }, { "$ref": "#/components/schemas/watchlist_sanctions_only_report" }, { "$ref": "#/components/schemas/proof_of_address_report" }, { "$ref": "#/components/schemas/us_driving_licence_report" }, { "$ref": "#/components/schemas/device_intelligence_report" }, { "$ref": "#/components/schemas/india_pan_report" } ] }, "applicant_shared": { "properties": { "email": { "description": "The applicant's email address. Required if doing a US check, or a UK check for which `applicant_provides_data` is `true`.", "type": "string", "example": "jane.doe@example.com" }, "dob": { "description": "The applicant's date of birth", "format": "date", "type": "string" }, "id_numbers": { "items": { "$ref": "#/components/schemas/id_number" }, "type": "array" }, "phone_number": { "description": "The applicant's phone number", "type": "string", "example": "+44 7911 123456" } }, "type": "object" }, "applicant_response": { "properties": { "first_name": { "$ref": "#/components/schemas/applicant_first_name" }, "last_name": { "$ref": "#/components/schemas/applicant_last_name" }, "id": { "description": "The unique identifier for the applicant.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "created_at": { "description": "The date and time when this applicant was created.", "format": "date-time", "type": "string" }, "delete_at": { "description": "The date and time when this applicant is scheduled to be deleted.", "format": "date-time", "type": "string" }, "href": { "description": "The uri of this resource.", "type": "string" }, "sandbox": { "type": "boolean" }, "address": { "$ref": "#/components/schemas/address" }, "location": { "$ref": "#/components/schemas/location" } }, "required": ["id"], "type": "object" }, "applicant_first_name": { "description": "The applicant's first name", "pattern": "^[^!#$%*=<>;{}\"]*$", "type": "string", "example": "Jane" }, "applicant_last_name": { "description": "The applicant's surname", "pattern": "^[^!#$%*=<>;{}\"]*$", "type": "string", "example": "Doe" }, "applicant_request": { "properties": { "consents": { "description": "The applicant's consents", "items": { "$ref": "#/components/schemas/applicant_consent_builder" }, "type": "array" }, "address": { "$ref": "#/components/schemas/address_builder" }, "location": { "$ref": "#/components/schemas/location_builder" } }, "type": "object" }, "applicant_consent_builder": { "properties": { "name": { "$ref": "#/components/schemas/applicant_consent_name" }, "granted": { "type": "boolean" } }, "required": ["granted", "name"], "type": "object" }, "applicant_create": { "properties": { "first_name": { "$ref": "#/components/schemas/applicant_first_name" }, "last_name": { "$ref": "#/components/schemas/applicant_last_name" } }, "required": ["first_name", "last_name"] }, "applicant_update": { "properties": { "first_name": { "$ref": "#/components/schemas/applicant_first_name" }, "last_name": { "$ref": "#/components/schemas/applicant_last_name" } } }, "workflow_run_shared": { "properties": { "applicant_id": { "description": "The unique identifier for the Applicant.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "workflow_id": { "description": "The unique identifier for the Workflow.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "tags": { "description": "Tags or labels assigned to the workflow run.", "items": { "maxLength": 128, "minLength": 1, "type": "string" }, "maxItems": 30, "nullable": true, "type": "array" }, "customer_user_id": { "description": "Customer-provided user identifier.", "maxLength": 256, "type": "string", "example": "customer-12345" }, "link": { "allOf": [ { "$ref": "#/components/schemas/workflow_run_link" } ], "description": "Object for the configuration of the Workflow Run link.", "type": "object" }, "created_at": { "description": "The date and time when the Workflow Run was created.", "format": "date-time", "type": "string" }, "updated_at": { "description": "The date and time when the Workflow Run was last updated.", "format": "date-time", "type": "string" } }, "required": ["applicant_id", "workflow_id"], "type": "object" }, "workflow_run_link": { "properties": { "url": { "description": "Link to access the Workflow Run without the need to integrate with Onfido's SDKs.", "type": "string", "example": "https://example.com/webhooks/onfido" }, "completed_redirect_url": { "description": "When the interactive section of the Workflow Run has completed successfully, the user will be redirected to this URL instead of seeing the default Onfido 'thank you' page.", "nullable": true, "type": "string" }, "expired_redirect_url": { "description": "When the link has expired, the user will be immediately redirected to this URL instead of seeing the default Onfido error message.", "nullable": true, "type": "string" }, "expires_at": { "description": "Date and time when the link will expire.", "format": "date-time", "nullable": true, "type": "string" }, "language": { "description": "The code for the language when the workflow run is acessed using the link.", "enum": [ "en_US", "de_DE", "es_ES", "fr_FR", "it_IT", "pt_PT", "nl_NL" ], "nullable": true, "type": "string" } } }, "workflow_run_response": { "properties": { "id": { "description": "The unique identifier for the Workflow Run.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "workflow_version_id": { "description": "The identifier for the Workflow version.", "type": "integer" }, "dashboard_url": { "description": "The URL for viewing the Workflow Run results on your Onfido Dashboard.", "type": "string" }, "status": { "allOf": [ { "$ref": "#/components/schemas/workflow_run_status" } ], "description": "The status of the Workflow Run." }, "output": { "description": "Output object contains all of the properties configured on the Workflow version.", "type": "object" }, "reasons": { "description": "The reasons the Workflow Run outcome was reached. Configurable when creating the Workflow version.", "items": { "type": "string" }, "type": "array" }, "error": { "allOf": [ { "$ref": "#/components/schemas/workflow_run_error" } ], "description": "Error object. Only set when the Workflow Run status is 'error'.", "type": "object" }, "sdk_token": { "description": "Client token to use when loading this workflow run in the Onfido SDK.", "nullable": true, "type": "string" } }, "required": ["id"], "type": "object" }, "workflow_run_status": { "enum": [ "processing", "awaiting_input", "awaiting_client_input", "approved", "declined", "review", "abandoned", "error" ], "type": "string" }, "workflow_run_error": { "properties": { "type": { "description": "The type of error.", "type": "string" }, "message": { "description": "A textual description of the error.", "type": "string" } }, "type": "object" }, "workflow_run_request": { "properties": { "custom_data": { "additionalProperties": true, "description": "Object with Custom Input Data to be used in the Workflow Run.", "type": "object" } }, "type": "object" }, "document_shared": { "properties": { "file_type": { "description": "The file type of the uploaded file", "type": "string", "example": "png" }, "type": { "allOf": [ { "$ref": "#/components/schemas/document_types" } ], "description": "The type of document", "type": "string" }, "side": { "description": "The side of the document, if applicable. The possible values are front and back", "enum": ["front", "back"], "type": "string" }, "issuing_country": { "allOf": [ { "$ref": "#/components/schemas/country_codes" } ], "description": "The issuing country of the document, a 3-letter ISO code.", "type": "string", "example": "GBR" }, "applicant_id": { "description": "The ID of the applicant whose document is being uploaded.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, "type": "object" }, "document_response": { "properties": { "id": { "description": "The unique identifier for the document", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "created_at": { "description": "The date and time at which the document was uploaded", "format": "date-time", "type": "string" }, "href": { "description": "The uri of this resource", "type": "string" }, "download_href": { "description": "The uri that can be used to download the document", "type": "string" }, "file_name": { "description": "The name of the uploaded file", "type": "string" }, "file_size": { "description": "The size of the file in bytes", "type": "integer" } }, "required": ["id"], "type": "object" }, "document_request": { "properties": { "file": { "description": "The file to be uploaded.", "format": "binary", "type": "string" }, "validate_image_quality": { "description": "Defaults to false. When true the submitted image will undergo an image quality validation which may take up to 5 seconds.", "type": "boolean" }, "location": { "$ref": "#/components/schemas/location_builder" } }, "type": "object" }, "signing_document_shared": { "properties": { "applicant_id": { "description": "The ID of the applicant whose signing document is being uploaded.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, "type": "object" }, "signing_document_response": { "properties": { "id": { "description": "The unique identifier for the signing document", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "created_at": { "description": "The date and time at which the signing document was uploaded", "format": "date-time", "type": "string" }, "href": { "description": "The uri of this resource", "type": "string" }, "download_href": { "description": "The uri that can be used to download the signing document", "type": "string" }, "file_type": { "description": "The file type of the uploaded file", "type": "string", "example": "png" }, "file_name": { "description": "The name of the uploaded file", "type": "string" }, "file_size": { "description": "The size of the file in bytes", "type": "integer" } }, "required": ["id"], "type": "object" }, "signing_document_request": { "properties": { "file": { "description": "The file to be uploaded.", "format": "binary", "type": "string" } }, "type": "object" }, "live_photo_response": { "properties": { "id": { "description": "The unique identifier for the photo.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "created_at": { "description": "The date and time at which the photo was uploaded.", "format": "date-time", "type": "string" }, "href": { "description": "The uri of this resource.", "type": "string" }, "download_href": { "description": "The uri that can be used to download the photo.", "type": "string" }, "file_name": { "description": "The name of the uploaded file.", "type": "string" }, "file_type": { "description": "The file type of the uploaded file.", "type": "string", "example": "png" }, "file_size": { "description": "The size of the file in bytes.", "type": "integer" } }, "required": ["id"], "type": "object" }, "live_photo_request": { "properties": { "applicant_id": { "description": "The ID of the applicant whose live photo is being uploaded.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "file": { "description": "The file to be uploaded.", "format": "binary", "type": "string" }, "advanced_validation": { "default": true, "description": "Validates that the live photo contains exactly one face.", "type": "boolean" } }, "type": "object" }, "watchlist_monitor_shared": { "properties": { "applicant_id": { "description": "The ID for the applicant associated with the monitor.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "report_name": { "description": "The name of the report type the monitor creates.", "enum": ["watchlist_standard", "watchlist_aml"], "type": "string" }, "tags": { "description": "A list of tags associated with this monitor. These tags will be applied to each check this monitor creates.", "items": { "type": "string" }, "type": "array" } }, "required": ["applicant_id", "report_name"], "type": "object" }, "watchlist_monitor_response": { "properties": { "id": { "description": "The unique identifier for the monitor.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "created_at": { "description": "The date and time at which the monitor was created.", "format": "date-time", "type": "string" }, "deleted_at": { "description": "The date and time at which the monitor was deleted. If the monitor is still active, this field will be null.", "format": "date-time", "type": "string" }, "is_sandbox": { "default": false, "description": "Indicates whether the object was created in the sandbox or not.", "type": "boolean" } }, "required": ["id"], "type": "object" }, "watchlist_mesh_alert_risk_1": { "properties": { "created_at": { "description": "The date and time at which the risk record was created.", "format": "date-time", "type": "string" }, "decision": { "allOf": [ { "$ref": "#/components/schemas/watchlist_mesh_risk_decision" } ], "description": "The review decision currently applied to the risk." }, "previous_decision": { "allOf": [ { "$ref": "#/components/schemas/watchlist_mesh_risk_decision" } ], "description": "The previous review decision, if one exists.", "nullable": true }, "detail": { "allOf": [ { "$ref": "#/components/schemas/watchlist_mesh_risk_detail" } ], "description": "Additional details about the risk." }, "identifier": { "description": "The unique identifier of the risk record.", "type": "string" }, "type": { "description": "The type of risk returned for the alert.", "type": "string" }, "updated_by": { "description": "The identifier of the user or system that last updated the risk decision.", "nullable": true, "type": "string" }, "updated_at": { "description": "The date and time at which the risk record was last updated.", "format": "date-time", "nullable": true, "type": "string" } }, "type": "object" }, "watchlist_mesh_risk_decision": { "enum": [ "NOT_REVIEWED", "IN_REVIEW", "FALSE_POSITIVE", "TRUE_POSITIVE" ], "type": "string" }, "watchlist_mesh_risk_detail": { "properties": { "change_type": { "description": "The type of change that triggered the risk, if available.", "nullable": true, "type": "string" }, "configuration_identifier": { "description": "The identifier of the screening configuration associated with the risk.", "format": "uuid", "nullable": true, "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "profile": { "allOf": [ { "$ref": "#/components/schemas/watchlist_mesh_profile" } ], "description": "The matched profile associated with the risk.", "nullable": true }, "added_mentions": { "allOf": [ { "$ref": "#/components/schemas/watchlist_mesh_added_mentions" } ], "description": "Newly added mentions associated with the risk.", "nullable": true } }, "type": "object" }, "watchlist_mesh_profile": { "properties": { "identifier": { "nullable": true, "type": "string" }, "match_types": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "match_score": { "description": "The match score assigned to the profile.", "type": "number" }, "matching_name": { "nullable": true, "type": "string" }, "person": { "allOf": [ { "$ref": "#/components/schemas/watchlist_mesh_person" } ], "nullable": true }, "risk_indicators": { "allOf": [ { "$ref": "#/components/schemas/watchlist_mesh_risk_indicators" } ], "nullable": true } }, "type": "object" }, "watchlist_mesh_person": { "properties": { "associates": { "items": { "$ref": "#/components/schemas/watchlist_mesh_associate" }, "nullable": true, "type": "array" }, "dates_of_birth": { "items": { "$ref": "#/components/schemas/watchlist_mesh_date_value" }, "nullable": true, "type": "array" }, "dates_of_death": { "items": { "$ref": "#/components/schemas/watchlist_mesh_date_value" }, "nullable": true, "type": "array" }, "images": { "items": { "$ref": "#/components/schemas/watchlist_mesh_image" }, "nullable": true, "type": "array" }, "names": { "items": { "$ref": "#/components/schemas/watchlist_mesh_name" }, "nullable": true, "type": "array" }, "places_of_birth": { "items": { "type": "string" }, "nullable": true, "type": "array" } }, "type": "object" }, "watchlist_mesh_associate": { "properties": { "name": { "nullable": true, "type": "string" }, "type": { "nullable": true, "type": "string" } }, "type": "object" }, "watchlist_mesh_date_value": { "properties": { "source": { "nullable": true, "type": "string" }, "value": { "nullable": true, "type": "string", "example": "AB123456C" } }, "type": "object" }, "watchlist_mesh_image": { "properties": { "source": { "nullable": true, "type": "string" }, "url": { "nullable": true, "type": "string", "example": "https://example.com/webhooks/onfido" } }, "type": "object" }, "watchlist_mesh_name": { "properties": { "name": { "nullable": true, "type": "string" }, "type": { "nullable": true, "type": "string" } }, "type": "object" }, "watchlist_mesh_risk_indicators": { "properties": { "aml_types": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "lists": { "items": { "$ref": "#/components/schemas/watchlist_mesh_lists" }, "nullable": true, "type": "array" }, "media": { "items": { "$ref": "#/components/schemas/watchlist_mesh_media" }, "nullable": true, "type": "array" }, "peps": { "items": { "$ref": "#/components/schemas/watchlist_mesh_pep" }, "nullable": true, "type": "array" }, "sanctions": { "items": { "$ref": "#/components/schemas/watchlist_mesh_sanctions" }, "nullable": true, "type": "array" } }, "type": "object" }, "watchlist_mesh_lists": { "properties": { "aml_types": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "country_codes": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "fields": { "items": { "$ref": "#/components/schemas/watchlist_mesh_field" }, "nullable": true, "type": "array" }, "identifier": { "nullable": true, "type": "string" }, "listing_ended_utc": { "nullable": true, "type": "string" }, "listing_started_utc": { "nullable": true, "type": "string" }, "name": { "nullable": true, "type": "string" }, "related_urls": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "url": { "nullable": true, "type": "string", "example": "https://example.com/webhooks/onfido" } }, "type": "object" }, "watchlist_mesh_field": { "properties": { "name": { "nullable": true, "type": "string" }, "tag": { "nullable": true, "type": "string" }, "value": { "nullable": true, "type": "string", "example": "AB123456C" } }, "type": "object" }, "watchlist_mesh_media": { "properties": { "identifier": { "nullable": true, "type": "string" }, "publishing_date": { "nullable": true, "type": "string" }, "snippet": { "nullable": true, "type": "string" }, "title": { "nullable": true, "type": "string" }, "url": { "nullable": true, "type": "string", "example": "https://example.com/webhooks/onfido" } }, "type": "object" }, "watchlist_mesh_pep": { "properties": { "aml_types": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "active_end_dates": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "active_start_dates": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "country_codes": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "fields": { "items": { "$ref": "#/components/schemas/watchlist_mesh_field" }, "nullable": true, "type": "array" }, "identifier": { "nullable": true, "type": "string" }, "listing_ended_utc": { "nullable": true, "type": "string" }, "listing_started_utc": { "nullable": true, "type": "string" }, "name": { "nullable": true, "type": "string" }, "political_parties": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "political_positions": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "political_regions": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "related_urls": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "url": { "nullable": true, "type": "string", "example": "https://example.com/webhooks/onfido" } }, "type": "object" }, "watchlist_mesh_sanctions": { "properties": { "aml_types": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "country_codes": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "fields": { "items": { "$ref": "#/components/schemas/watchlist_mesh_field" }, "nullable": true, "type": "array" }, "identifier": { "nullable": true, "type": "string" }, "listing_ended_utc": { "nullable": true, "type": "string" }, "listing_started_utc": { "nullable": true, "type": "string" }, "name": { "nullable": true, "type": "string" }, "related_urls": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "url": { "nullable": true, "type": "string", "example": "https://example.com/webhooks/onfido" } }, "type": "object" }, "watchlist_mesh_added_mentions": { "properties": { "added_aml_types": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "added_snippets": { "items": { "type": "string" }, "nullable": true, "type": "array" }, "added_listings": { "items": { "type": "string" }, "nullable": true, "type": "array" } }, "type": "object" }, "id_photo_response": { "properties": { "id": { "description": "The unique identifier for the photo.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "created_at": { "description": "The date and time at which the photo was uploaded.", "format": "date-time", "type": "string" }, "href": { "description": "The uri of this resource.", "type": "string" }, "download_href": { "description": "The uri that can be used to download the photo.", "type": "string" }, "file_name": { "description": "The name of the uploaded file.", "type": "string" }, "file_type": { "description": "The file type of the uploaded file.", "type": "string", "example": "png" }, "file_size": { "description": "The size of the file in bytes.", "type": "integer" } }, "required": ["id"], "type": "object" }, "id_photo_request": { "properties": { "applicant_id": { "description": "The ID of the applicant whose ID photo is being uploaded.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "file": { "description": "The file to be uploaded.", "format": "binary", "type": "string" } }, "type": "object" }, "webhook_shared": { "properties": { "enabled": { "description": "Determine if the webhook is active.", "type": "boolean" }, "events": { "description": "The events that will be published to the webhook. If the events parameter is omitted all the events will be subscribed.\n", "items": { "$ref": "#/components/schemas/webhook_event_type" }, "type": "array" }, "environments": { "description": "The environments from which the webhook will receive events. Allowed values are \u201csandbox\u201d and \u201clive\u201d. If the environments parameter is omitted the webhook will receive events from both environments.\n", "items": { "type": "string" }, "type": "array" }, "payload_version": { "description": "Webhook version used to control the payload object when sending webhooks.", "type": "integer" }, "oauth_enabled": { "description": "Determines if the webhook will fetch OAuth access tokens to send in the Authorization header.", "type": "boolean" }, "oauth_server_url": { "description": "The url to fetch the OAuth access token using client credentials grant.", "type": "string" }, "oauth_server_client_id": { "description": "The client id to authenticate the client credentials grant.", "type": "string" }, "oauth_server_client_secret": { "description": "The client secret to authenticate the client credentials grant.", "type": "string" }, "oauth_server_scope": { "description": "The scopes to be sent when requesting the access token.", "type": "string" } }, "type": "object" }, "webhook_event_type": { "enum": [ "audit_log.created", "watchlist_monitor.matches_updated", "workflow_run.completed", "workflow_task.started", "workflow_task.completed", "check.started", "check.reopened", "check.withdrawn", "check.completed", "check.form_completed", "report.withdrawn", "report.resumed", "report.cancelled", "report.awaiting_approval", "report.completed", "workflow_timeline_file.created", "workflow_run_evidence_folder.created" ], "type": "string" }, "webhook_response": { "properties": { "id": { "description": "The unique identifier of the webhook.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "name": { "description": "Name of the webhook.", "type": "string" }, "url": { "$ref": "#/components/schemas/webhook_url" }, "token": { "description": "Webhook secret token used to sign the webhook's payload.", "type": "string" }, "href": { "description": "The API endpoint to retrieve the webhook.", "type": "string" } }, "required": ["id"], "type": "object" }, "webhook_url": { "description": "The url that will listen to notifications (must be https).", "type": "string" }, "webhook_create": { "properties": { "name": { "description": "Name of the webhook.", "type": "string" }, "url": { "$ref": "#/components/schemas/webhook_url" } }, "required": ["url"] }, "webhook_event_resource_type": { "enum": [ "check", "report", "audit_log", "workflow_run", "workflow_task", "watchlist_monitor", "workflow_timeline_file", "workflow_run_evidence_folder" ], "type": "string" }, "webhook_update": { "properties": { "name": { "description": "Name of the webhook.", "type": "string" }, "url": { "$ref": "#/components/schemas/webhook_url" } } }, "address_shared": { "properties": { "flat_number": { "description": "The flat number of this address", "type": "string", "example": "3" }, "building_number": { "description": "The building number of this address", "type": "string", "example": "29" }, "building_name": { "description": "The building name of this address", "type": "string", "example": "Albert Court" }, "street": { "description": "The street of the applicant's address", "type": "string", "example": "Second Street" }, "sub_street": { "description": "The sub-street of the applicant's address", "type": "string", "example": "" }, "town": { "description": "The town of the applicant's address", "type": "string", "example": "London" }, "postcode": { "description": "The postcode or ZIP of the applicant's address", "type": "string", "example": "SW4 6EH" }, "country": { "allOf": [ { "$ref": "#/components/schemas/country_codes" } ], "description": "The 3 character ISO country code of this address. For example, GBR is the country code for the United Kingdom", "type": "string" }, "state": { "description": "The address state. US states must use the USPS abbreviation (see also ISO 3166-2:US), for example AK, CA, or TX.", "type": "string", "example": "TX" }, "line1": { "description": "Line 1 of the applicant's address", "nullable": true, "pattern": "^[^!$%^*=<>]*$", "type": "string", "example": "29 Second Street" }, "line2": { "description": "Line 2 of the applicant's address", "nullable": true, "pattern": "^[^!$%^*=<>]*$", "type": "string", "example": "Albert Court" }, "line3": { "description": "Line 3 of the applicant's address", "nullable": true, "pattern": "^[^!$%^*=<>]*$", "type": "string", "example": "" } }, "required": ["country", "postcode"], "type": "object" }, "sdk_token_request": { "properties": { "applicant_id": { "description": "The unique identifier of the applicant", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "referrer": { "description": "The referrer URL pattern", "type": "string", "example": "https://*.example.com/*" }, "application_id": { "description": "The application ID (iOS or Android)", "type": "string", "example": "com.example.app" }, "cross_device_url": { "description": "The URL to be used by the Web SDK for the cross device flow.", "type": "string" } }, "required": ["applicant_id"], "type": "object" }, "sdk_token_response": { "properties": { "token": { "description": "The generated SDK token", "type": "string" } }, "required": ["token"], "type": "object" }, "country_codes": { "enum": [ "ABW", "AFG", "AGO", "AIA", "ALA", "ALB", "AND", "ARE", "ARG", "ARM", "ASM", "ATA", "ATF", "ATG", "AUS", "AUT", "AZE", "BDI", "BEL", "BEN", "BES", "BFA", "BGD", "BGR", "BHR", "BHS", "BIH", "BLM", "BLR", "BLZ", "BMU", "BOL", "BRA", "BRB", "BRN", "BTN", "BVT", "BWA", "CAF", "CAN", "CCK", "CHE", "CHL", "CHN", "CIV", "CMR", "COD", "COG", "COK", "COL", "COM", "CPV", "CRI", "CUB", "CUW", "CXR", "CYM", "CYP", "CZE", "DEU", "DJI", "DMA", "DNK", "DOM", "DZA", "ECU", "EGY", "ERI", "ESH", "ESP", "EST", "ETH", "FIN", "FJI", "FLK", "FRA", "FRO", "FSM", "GAB", "GBR", "GEO", "GGY", "GHA", "GIB", "GIN", "GLP", "GMB", "GNB", "GNQ", "GRC", "GRD", "GRL", "GTM", "GUF", "GUM", "GUY", "HKG", "HMD", "HND", "HRV", "HTI", "HUN", "IDN", "IMN", "IND", "IOT", "IRL", "IRN", "IRQ", "ISL", "ISR", "ITA", "JAM", "JEY", "JOR", "JPN", "KAZ", "KEN", "KGZ", "KHM", "KIR", "KNA", "KOR", "KWT", "LAO", "LBN", "LBR", "LBY", "LCA", "LIE", "LKA", "LSO", "LTU", "LUX", "LVA", "MAC", "MAF", "MAR", "MCO", "MDA", "MDG", "MDV", "MEX", "MHL", "MKD", "MLI", "MLT", "MMR", "MNE", "MNG", "MNP", "MOZ", "MRT", "MSR", "MTQ", "MUS", "MWI", "MYS", "MYT", "NAM", "NCL", "NER", "NFK", "NGA", "NIC", "NIU", "NLD", "NOR", "NPL", "NRU", "NZL", "OMN", "PAK", "PAN", "PCN", "PER", "PHL", "PLW", "PNG", "POL", "PRI", "PRK", "PRT", "PRY", "PSE", "PYF", "QAT", "REU", "RKS", "ROU", "RUS", "RWA", "SAU", "SDN", "SEN", "SGP", "SGS", "SHN", "SJM", "SLB", "SLE", "SLV", "SMR", "SOM", "SPM", "SRB", "SSD", "STP", "SUR", "SVK", "SVN", "SWE", "SWZ", "SXM", "SYC", "SYR", "TCA", "TCD", "TGO", "THA", "TJK", "TKL", "TKM", "TLS", "TON", "TTO", "TUN", "TUR", "TUV", "TWN", "TZA", "UGA", "UKR", "UMI", "URY", "USA", "UZB", "VAT", "VCT", "VEN", "VGB", "VIR", "VNM", "VUT", "WLF", "WSM", "YEM", "ZAF", "ZMB", "ZWE" ], "type": "string" }, "document_types": { "enum": [ "passport", "driving_licence", "national_identity_card", "residence_permit", "passport_card", "tax_id", "visa", "voter_id", "residence_status_document", "postal_identity_card", "social_security_card", "work_permit", "asylum_registration_card", "national_health_insurance_card", "municipality_identity_card", "private_operators_card", "proof_of_citizenship", "service_id_card", "immigration_status_document", "indigenous_card", "vehicle_registration_card", "certificate_of_naturalisation", "professional_qualification_card", "consular_id", "international_driving_licence", "home_office_letter", "birth_certificate", "vehicle_registration_certificate", "form_for_affixing_the_visa", "identification_number_document", "adoption_certificate", "bank_building_society_statement", "bank_statement", "benefit_letters", "cbt", "certificate_of_sponsorship", "character_reference", "civil_partnership_certificate", "council_tax", "credit_card_statement", "deed_poll", "divorce_absolute_decree", "educational_statement", "electricity_bill", "gas_bill", "government_letter", "internet_bill", "marriage_certificate", "motorcycle_insurance", "national_insurance_card", "naturalisation_certificate", "non_uk_driving_licence", "p45_p60", "payslip", "phone_bill", "professional_identification_card", "right_to_work_share_code_result", "statement_fact", "t4_student_university_term_dates_evidence", "uk_biometric_residence_permit", "uk_driving_licence", "unknown", "utility_bill", "utility_bill_electric", "utility_bill_gas", "utility_bill_other", "water_bill", "address_certificate", "general_letter", "insurance_statement", "pension_property_statement_letter", "mortgage_statement", "mobile_phone_bill", "identity_document_with_address", "exchange_house_statement", "accommodation_tenancy_certificate", "diplomatic_id", "travel_document" ], "type": "string" }, "check_shared": { "properties": { "webhook_ids": { "description": "An array of webhook ids describing which webhooks to trigger for this check.", "items": { "type": "string" }, "type": "array" }, "applicant_id": { "description": "The ID of the applicant to do the check on.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "applicant_provides_data": { "description": "Send an applicant form to applicant to complete to proceed with check. Defaults to false.\n", "type": "boolean" }, "tags": { "description": "Array of tags being assigned to this check.", "items": { "type": "string" }, "type": "array" }, "redirect_uri": { "description": "For checks where `applicant_provides_data` is `true`, redirect to this URI when the applicant has submitted their data.", "type": "string" }, "privacy_notices_read_consent_given": { "type": "boolean" } }, "required": ["applicant_id"], "type": "object" }, "check_response": { "properties": { "id": { "description": "The unique identifier for the check.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "created_at": { "description": "The date and time when this check was created.", "format": "date-time", "type": "string" }, "href": { "description": "The uri of this resource.", "type": "string" }, "status": { "$ref": "#/components/schemas/check_status" }, "result": { "description": "The overall result of the check, based on the results of the constituent reports.", "enum": ["clear", "consider"], "type": "string" }, "form_uri": { "description": "A link to the applicant form, if `applicant_provides_data` is `true`.", "type": "string" }, "results_uri": { "description": "A link to the corresponding results page on the Onfido dashboard.", "type": "string" }, "report_ids": { "description": "An array of report ids.", "items": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "type": "array" }, "sandbox": { "description": "Indicates whether the object was created in the sandbox or not.", "type": "boolean" }, "paused": { "type": "boolean" }, "version": { "example": "3.6", "type": "string" } }, "required": ["id"], "type": "object" }, "check_status": { "description": "The current state of the check in the checking process.", "enum": [ "in_progress", "awaiting_applicant", "complete", "withdrawn", "paused", "reopened" ], "type": "string" }, "check_request": { "properties": { "report_names": { "description": "An array of report names (strings).", "items": { "$ref": "#/components/schemas/report_name" }, "type": "array" }, "document_ids": { "description": "Optional. An array of document ids, for use with Document reports only. If omitted, the Document report will use the most recently uploaded document by default.", "items": { "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "type": "array" }, "applicant_provides_data": { "default": false, "description": "Send an applicant form to applicant to complete to proceed with check. Defaults to false.", "type": "boolean" }, "asynchronous": { "default": true, "description": "Defaults to `true`. If set to `false`, you will only receive a response when all reports in your check have completed.\n", "type": "boolean" }, "suppress_form_emails": { "description": "For checks where `applicant_provides_data` is `true`, applicant form will not be automatically sent if `suppress_form_emails` is set to `true`. You can manually send the form at any time after the check has been created, using the link found in the form_uri attribute of the check object. Write-only. Defaults to false.\n", "type": "boolean" }, "sub_result": { "description": "Triggers responses for particular sub-results for sandbox Document reports.", "type": "string" }, "consider": { "description": "Array of names of particular reports to return consider as their results. This is a feature available in sandbox testing", "items": { "$ref": "#/components/schemas/report_name" }, "type": "array" }, "us_driving_licence": { "$ref": "#/components/schemas/us_driving_licence_builder" }, "report_configuration": { "$ref": "#/components/schemas/report_configuration" } }, "required": ["report_names"], "type": "object" }, "document_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "$ref": "#/components/schemas/document_report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/document_breakdown" }, "properties": { "$ref": "#/components/schemas/document_properties" } }, "type": "object" } ] }, "document_video_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "$ref": "#/components/schemas/document_report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/document_breakdown" }, "properties": { "$ref": "#/components/schemas/document_properties" } }, "type": "object" } ] }, "document_video_with_address_information_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "$ref": "#/components/schemas/document_report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/document_breakdown" }, "properties": { "$ref": "#/components/schemas/document_properties" } }, "type": "object" } ] }, "document_with_address_information_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "$ref": "#/components/schemas/document_report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/document_breakdown" }, "properties": { "$ref": "#/components/schemas/document_properties" } }, "type": "object" } ] }, "document_with_driving_licence_information_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "$ref": "#/components/schemas/document_report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/document_breakdown" }, "properties": { "$ref": "#/components/schemas/Document_Properties_with_Driving_Licence_Information" } }, "type": "object" } ] }, "document_with_driver_verification_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "$ref": "#/components/schemas/document_report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/document_breakdown" }, "properties": { "$ref": "#/components/schemas/document_with_driver_verification_report_allOf_properties" } }, "type": "object" } ] }, "facial_similarity_photo_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "$ref": "#/components/schemas/facial_similarity_report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown" }, "properties": { "$ref": "#/components/schemas/facial_similarity_photo_properties" } }, "type": "object" } ] }, "facial_similarity_photo_fully_auto_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "$ref": "#/components/schemas/facial_similarity_report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/facial_similarity_photo_fully_auto_breakdown" }, "properties": { "$ref": "#/components/schemas/facial_similarity_photo_fully_auto_properties" } }, "type": "object" } ] }, "facial_similarity_video_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "$ref": "#/components/schemas/facial_similarity_report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/facial_similarity_video_breakdown" }, "properties": { "$ref": "#/components/schemas/facial_similarity_video_properties" } }, "type": "object" } ] }, "facial_similarity_motion_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "$ref": "#/components/schemas/facial_similarity_report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/facial_similarity_motion_breakdown" }, "properties": { "$ref": "#/components/schemas/facial_similarity_motion_properties" } }, "type": "object" } ] }, "known_faces_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/known_faces_breakdown" }, "properties": { "$ref": "#/components/schemas/known_faces_properties" } }, "type": "object" } ] }, "identity_enhanced_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/identity_enhanced_breakdown" }, "properties": { "$ref": "#/components/schemas/identity_enhanced_properties" } }, "type": "object" } ] }, "watchlist_aml_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/watchlist_aml_breakdown" }, "properties": { "$ref": "#/components/schemas/watchlist_aml_properties" } }, "type": "object" } ] }, "watchlist_enhanced_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/watchlist_enhanced_breakdown" }, "properties": { "$ref": "#/components/schemas/watchlist_enhanced_properties" } }, "type": "object" } ] }, "watchlist_standard_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/watchlist_standard_breakdown" }, "properties": { "$ref": "#/components/schemas/watchlist_standard_properties" } }, "type": "object" } ] }, "watchlist_peps_only_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/watchlist_standard_breakdown" }, "properties": { "$ref": "#/components/schemas/watchlist_standard_properties" } }, "type": "object" } ] }, "watchlist_sanctions_only_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/watchlist_standard_breakdown" }, "properties": { "$ref": "#/components/schemas/watchlist_standard_properties" } }, "type": "object" } ] }, "proof_of_address_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/proof_of_address_breakdown" }, "properties": { "$ref": "#/components/schemas/proof_of_address_properties" } }, "type": "object" } ] }, "us_driving_licence_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/us_driving_licence_breakdown" }, "properties": { "$ref": "#/components/schemas/document_properties" } }, "type": "object" } ] }, "device_intelligence_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/device_intelligence_breakdown" }, "properties": { "$ref": "#/components/schemas/device_intelligence_properties" } }, "type": "object" } ] }, "india_pan_report": { "allOf": [ { "$ref": "#/components/schemas/report_shared" }, { "properties": { "breakdown": { "$ref": "#/components/schemas/india_pan_report_allOf_breakdown" }, "properties": { "$ref": "#/components/schemas/india_pan_report_allOf_properties" } }, "type": "object" } ] }, "id_number": { "properties": { "type": { "description": "Type of ID number.", "enum": [ "ssn", "social_insurance", "tax_id", "identity_card", "driving_license", "driving_licence", "share_code", "voter_id", "passport", "other" ], "type": "string" }, "value": { "description": "Value of ID number", "type": "string", "example": "AB123456C" }, "state_code": { "description": "Two letter code of issuing state (state-issued driving licenses only)", "type": "string", "example": "CA" } }, "type": "object" }, "location": { "allOf": [ { "$ref": "#/components/schemas/location_shared" } ] }, "address_builder": { "allOf": [ { "$ref": "#/components/schemas/address_shared" } ] }, "location_builder": { "allOf": [ { "$ref": "#/components/schemas/location_shared" } ] }, "report_name": { "enum": [ "document", "document_video", "document_video_with_address_information", "document_with_address_information", "document_with_driving_licence_information", "document_with_driver_verification", "facial_similarity_photo", "facial_similarity_photo_fully_auto", "facial_similarity_video", "facial_similarity_motion", "known_faces", "identity_enhanced", "watchlist_aml", "watchlist_enhanced", "watchlist_standard", "watchlist_peps_only", "watchlist_sanctions_only", "proof_of_address", "us_driving_licence", "device_intelligence", "india_pan" ], "type": "string" }, "us_driving_licence_builder": { "allOf": [ { "$ref": "#/components/schemas/us_driving_licence_shared" } ] }, "report_configuration": { "deprecated": true, "description": "Defines configuration options for facial similarity checks used to distinguish between onboarding and reverification scenarios.\n", "properties": { "facial_similarity_photo": { "$ref": "#/components/schemas/report_configuration_facial_similarity" }, "facial_similarity_photo_fully_auto": { "$ref": "#/components/schemas/report_configuration_facial_similarity" }, "facial_similarity_video": { "$ref": "#/components/schemas/report_configuration_facial_similarity" }, "facial_similarity_motion": { "$ref": "#/components/schemas/report_configuration_facial_similarity" } }, "type": "object" }, "report_configuration_facial_similarity": { "properties": { "use_case": { "description": "You should set it to \"reverification\" on a post-onboarding scenario (e.g. ongoing authentication).\n", "enum": ["onboarding", "reverification"], "type": "string" } }, "type": "object" }, "report_shared": { "properties": { "id": { "description": "The unique identifier for the report. Read-only.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "created_at": { "description": "The date and time at which the report was first initiated. Read-only.", "format": "date-time", "type": "string" }, "href": { "description": "The API endpoint to retrieve the report. Read-only.", "type": "string" }, "status": { "$ref": "#/components/schemas/report_status" }, "result": { "$ref": "#/components/schemas/report_result" }, "sub_result": { "$ref": "#/components/schemas/report_sub_result" }, "check_id": { "description": "The ID of the check to which the report belongs. Read-only.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "name": { "$ref": "#/components/schemas/report_name" } }, "required": ["id", "name"] }, "report_status": { "description": "The current state of the report in the checking process. Read-only.", "enum": [ "awaiting_data", "awaiting_approval", "cancelled", "complete", "withdrawn" ], "type": "string" }, "report_result": { "description": "The result of the report. Read-only.", "enum": ["clear", "consider", "unidentified"], "type": "string" }, "report_sub_result": { "description": "The sub_result of the report. It gives a more detailed result for document reports only, and will be null otherwise. Read-only.", "enum": ["clear", "rejected", "suspected", "caution"], "type": "string" }, "document_report_shared": { "properties": { "documents": { "description": "Array of objects with document ids that were used in the Onfido engine.", "items": { "$ref": "#/components/schemas/report_document" }, "type": "array" } }, "type": "object" }, "report_document": { "properties": { "id": { "description": "ID of uploaded document to use.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, "required": ["id"], "type": "object" }, "document_breakdown": { "properties": { "data_comparison": { "$ref": "#/components/schemas/document_breakdown_data_comparison" }, "data_validation": { "$ref": "#/components/schemas/document_breakdown_data_validation" }, "image_integrity": { "$ref": "#/components/schemas/document_breakdown_image_integrity" }, "visual_authenticity": { "$ref": "#/components/schemas/document_breakdown_visual_authenticity" }, "data_consistency": { "$ref": "#/components/schemas/document_breakdown_data_consistency" }, "police_record": { "$ref": "#/components/schemas/document_breakdown_police_record" }, "compromised_document": { "$ref": "#/components/schemas/document_breakdown_compromised_document" }, "age_validation": { "$ref": "#/components/schemas/document_breakdown_age_validation" }, "issuing_authority": { "$ref": "#/components/schemas/document_breakdown_issuing_authority" } }, "type": "object" }, "document_properties": { "properties": { "date_of_birth": { "format": "date", "type": "string" }, "date_of_expiry": { "format": "date", "type": "string" }, "personal_number": { "type": "string" }, "document_numbers": { "items": { "$ref": "#/components/schemas/document_properties_document_numbers_inner" }, "type": "array" }, "document_type": { "type": "string" }, "first_name": { "type": "string", "example": "Jane" }, "middle_name": { "type": "string", "example": "Mary" }, "last_name": { "type": "string", "example": "Doe" }, "gender": { "type": "string" }, "issuing_country": { "type": "string", "example": "GBR" }, "nationality": { "type": "string" }, "issuing_state": { "type": "string" }, "issuing_date": { "format": "date", "type": "string" }, "valid_from": { "format": "date", "type": "string" }, "categorisation": { "type": "string" }, "mrz_line1": { "type": "string" }, "mrz_line2": { "type": "string" }, "mrz_line3": { "type": "string" }, "address": { "type": "string" }, "place_of_birth": { "type": "string" }, "spouse_name": { "type": "string" }, "widow_name": { "type": "string" }, "alias_name": { "type": "string" }, "issuing_authority": { "type": "string" }, "remarks": { "type": "string" }, "civil_state": { "type": "string" }, "expatriation": { "type": "string" }, "father_name": { "type": "string" }, "mother_name": { "type": "string" }, "religion": { "type": "string" }, "type_of_permit": { "type": "string" }, "version_number": { "type": "string" }, "document_subtype": { "type": "string" }, "profession": { "type": "string" }, "security_document_number": { "type": "string" }, "tax_number": { "type": "string" }, "nist_identity_evidence_strength": { "enum": [ "superior", "strong", "fair", "weak", "unacceptable", "unspecified_identity_evidence_strength" ], "type": "string" }, "has_issuance_confirmation": { "enum": ["true", "false", "unspecified"], "type": "string" }, "real_id_compliance": { "type": "boolean" }, "security_tier": { "enum": [ "tier_1", "tier_2", "tier_3", "tier_4", "tier_5", "unspecified_security_tier" ], "type": "string" }, "address_lines": { "$ref": "#/components/schemas/document_properties_address_lines" }, "barcode": { "items": { "$ref": "#/components/schemas/document_properties_barcode_inner" }, "type": "array" }, "nfc": { "$ref": "#/components/schemas/document_properties_nfc" }, "document_classification": { "$ref": "#/components/schemas/document_properties_document_classification" }, "extracted_data": { "$ref": "#/components/schemas/document_properties_extracted_data" } }, "type": "object" }, "document_properties_with_driving_licence_information": { "properties": { "driving_licence_information": { "items": { "$ref": "#/components/schemas/Document_Properties_Driving_Licence_Information_Item" }, "type": "array" } }, "type": "object" }, "facial_similarity_report_shared": { "properties": { "documents": { "description": "Array of objects with document ids that were used in the Onfido engine.", "items": { "$ref": "#/components/schemas/report_document" }, "type": "array" }, "live_photos": { "description": "Array of objects with live photo ids that were used in the Onfido engine.", "items": { "$ref": "#/components/schemas/facial_similarity_report_media" }, "type": "array" }, "live_videos": { "description": "Array of objects with live video ids that were used in the Onfido engine.", "items": { "$ref": "#/components/schemas/facial_similarity_report_media" }, "type": "array" }, "motion_captures": { "description": "Array of objects with motion capture ids that were used in the Onfido engine.", "items": { "$ref": "#/components/schemas/facial_similarity_report_media" }, "type": "array" }, "id_photos": { "description": "Array of objects with id photo ids that were used in the Onfido engine.", "items": { "$ref": "#/components/schemas/facial_similarity_report_media" }, "type": "array" } } }, "facial_similarity_report_media": { "properties": { "id": { "description": "ID of uploaded biometric media to use.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, "required": ["id"], "type": "object" }, "facial_similarity_photo_breakdown": { "properties": { "face_comparison": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_face_comparison" }, "image_integrity": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_image_integrity" }, "visual_authenticity": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_visual_authenticity" } }, "type": "object" }, "facial_similarity_photo_properties": { "properties": { "score": { "description": "A floating point number between 0 and 1. The closer the score is to 0, the more likely\nit is to be a spoof (i.e. photos of printed photos, or photos of digital screens).\nConversely, the closer it is to 1, the less likely it is to be a spoof.\n", "format": "float", "type": "number" } }, "type": "object" }, "facial_similarity_photo_fully_auto_breakdown": { "properties": { "face_comparison": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_face_comparison" }, "image_integrity": { "$ref": "#/components/schemas/facial_similarity_photo_fully_auto_breakdown_image_integrity" }, "visual_authenticity": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_visual_authenticity" } }, "type": "object" }, "facial_similarity_photo_fully_auto_properties": { "properties": { "score": { "description": "A floating point number between 0 and 1. The closer the score is to 0, the more likely\nit is to be a spoof (i.e. photos of printed photos, or photos of digital screens).\nConversely, the closer it is to 1, the less likely it is to be a spoof.\n", "format": "float", "type": "number" } }, "type": "object" }, "facial_similarity_video_breakdown": { "properties": { "face_comparison": { "$ref": "#/components/schemas/facial_similarity_video_breakdown_face_comparison" }, "image_integrity": { "$ref": "#/components/schemas/facial_similarity_video_breakdown_image_integrity" }, "visual_authenticity": { "$ref": "#/components/schemas/facial_similarity_video_breakdown_visual_authenticity" } }, "type": "object" }, "facial_similarity_video_properties": { "properties": { "score": { "description": "A floating point number between 0 and 1. The closer the score is to 0, the more likely\nit is to be a spoof (i.e. videos of digital screens, masks or print-outs).\nConversely, the closer it is to 1, the less likely it is to be a spoof.\n", "format": "float", "type": "number" } }, "type": "object" }, "facial_similarity_motion_breakdown": { "properties": { "face_comparison": { "$ref": "#/components/schemas/facial_similarity_motion_breakdown_face_comparison" }, "image_integrity": { "$ref": "#/components/schemas/facial_similarity_motion_breakdown_image_integrity" }, "visual_authenticity": { "$ref": "#/components/schemas/facial_similarity_motion_breakdown_visual_authenticity" } }, "type": "object" }, "facial_similarity_motion_properties": { "properties": { "score": { "description": "A floating point number between 0 and 1. The closer the score is to 0, the more likely\nit is to be a spoof (i.e. videos of digital screens, masks or print-outs).\nConversely, the closer it is to 1, the less likely it is to be a spoof.\n", "format": "float", "type": "number" } }, "type": "object" }, "known_faces_breakdown": { "properties": { "previously_seen_faces": { "$ref": "#/components/schemas/known_faces_breakdown_previously_seen_faces" }, "image_integrity": { "$ref": "#/components/schemas/known_faces_breakdown_image_integrity" } }, "type": "object" }, "known_faces_properties": { "properties": { "matches": { "description": "Returns any matching applicant IDs as entries inside a matches array under a properties bag.", "items": { "$ref": "#/components/schemas/known_faces_properties_matches_inner" }, "type": "array" } }, "type": "object" }, "identity_enhanced_breakdown": { "properties": { "sources": { "$ref": "#/components/schemas/identity_enhanced_breakdown_sources" }, "address": { "$ref": "#/components/schemas/identity_enhanced_breakdown_address" }, "date_of_birth": { "$ref": "#/components/schemas/identity_enhanced_breakdown_date_of_birth" }, "mortality": { "$ref": "#/components/schemas/identity_enhanced_breakdown_mortality" }, "ssn": { "$ref": "#/components/schemas/idr_ssn_breakdown" }, "ssn1": { "$ref": "#/components/schemas/idr_ssn_breakdown" } }, "type": "object" }, "identity_enhanced_properties": { "properties": { "matched_address": { "description": "Returns address number which has been matched.", "type": "number" }, "matched_addresses": { "description": "Returns array of sources which contain matched addresses for the corresponding address number.", "items": { "$ref": "#/components/schemas/identity_enhanced_properties_matched_addresses_inner" }, "type": "array" } }, "type": "object" }, "watchlist_aml_breakdown": { "properties": { "sanction": { "$ref": "#/components/schemas/watchlist_aml_breakdown_sanction" }, "politically_exposed_person": { "$ref": "#/components/schemas/watchlist_aml_breakdown_politically_exposed_person" }, "legal_and_regulatory_warnings": { "$ref": "#/components/schemas/watchlist_aml_breakdown_legal_and_regulatory_warnings" }, "adverse_media": { "$ref": "#/components/schemas/watchlist_aml_breakdown_adverse_media" } }, "type": "object" }, "watchlist_aml_properties": { "properties": { "records": { "deprecated": true, "description": "Returns any matches including, but not limited to, name and date of birth of match, aliases and associates, and relevant events and sources.", "items": { "type": "object" }, "type": "array" } }, "type": "object" }, "watchlist_enhanced_breakdown": { "properties": { "politically_exposed_person": { "$ref": "#/components/schemas/watchlist_aml_breakdown_politically_exposed_person" }, "sanction": { "$ref": "#/components/schemas/watchlist_aml_breakdown_sanction" }, "adverse_media": { "$ref": "#/components/schemas/watchlist_aml_breakdown_adverse_media" }, "monitored_lists": { "$ref": "#/components/schemas/watchlist_aml_breakdown_legal_and_regulatory_warnings" } }, "type": "object" }, "watchlist_enhanced_properties": { "properties": { "records": { "description": "Returns any matches including, but not limited to, name and date of birth of match, aliases and associates, and relevant events and sources.", "items": { "$ref": "#/components/schemas/watchlist_enhanced_properties_records_inner" }, "type": "array" } }, "type": "object" }, "watchlist_standard_breakdown": { "properties": { "sanction": { "$ref": "#/components/schemas/watchlist_aml_breakdown_sanction" }, "politically_exposed_person": { "$ref": "#/components/schemas/watchlist_aml_breakdown_politically_exposed_person" }, "legal_and_regulatory_warnings": { "$ref": "#/components/schemas/watchlist_aml_breakdown_legal_and_regulatory_warnings" } }, "type": "object" }, "watchlist_standard_properties": { "properties": { "records": { "deprecated": true, "description": "Returns any matches including, but not limited to, name and date of birth of match, aliases and associates, and relevant events and sources.", "items": { "type": "object" }, "type": "array" } }, "type": "object" }, "proof_of_address_breakdown": { "properties": { "data_comparison": { "$ref": "#/components/schemas/proof_of_address_breakdown_data_comparison" }, "document_classification": { "$ref": "#/components/schemas/proof_of_address_breakdown_document_classification" }, "image_integrity": { "$ref": "#/components/schemas/proof_of_address_breakdown_image_integrity" } }, "type": "object" }, "proof_of_address_properties": { "properties": { "address": { "description": "This property provides the address on the document.", "type": "string" }, "document_type": { "description": "This property provides the document type according to the set of supported documents.", "enum": [ "bank_building_society_statement", "utility_bill", "council_tax", "benefit_letters", "mortgage_statement", "mobile_phone_bill", "general_letter", "insurance_statement", "pension_property_statement_letter", "identity_document_with_address", "exchange_house_statement", "accommodation_tenancy_certificate", "address_certificate", "electricity_bill", "gas_bill", "internet_bill", "phone_bill", "water_bill" ], "type": "string" }, "first_names": { "description": "This property provides the first names on the document, including any initials and middle names.", "type": "string" }, "last_names": { "description": "This property provided the last names on the document.", "type": "string" }, "issue_date": { "description": "This property provides the issue date of the document.", "format": "date", "type": "string" }, "issuer": { "description": "This property provides the document issuer (e.g. HSBC, British Gas).", "type": "string" }, "summary_period_start": { "description": "This property provides the summary period start date.", "format": "date", "type": "string" }, "summary_period_end": { "description": "This property provides the summary period end date.", "format": "date", "type": "string" } }, "type": "object" }, "us_driving_licence_breakdown": { "properties": { "document": { "$ref": "#/components/schemas/us_driving_licence_breakdown_document" }, "address": { "$ref": "#/components/schemas/us_driving_licence_breakdown_address" }, "personal": { "$ref": "#/components/schemas/us_driving_licence_breakdown_personal" } }, "type": "object" }, "device_intelligence_breakdown": { "properties": { "device": { "$ref": "#/components/schemas/device_intelligence_breakdown_device" } }, "type": "object" }, "device_intelligence_properties": { "properties": { "device": { "$ref": "#/components/schemas/device_intelligence_properties_device" }, "ip": { "$ref": "#/components/schemas/device_intelligence_properties_ip" }, "geolocation": { "$ref": "#/components/schemas/device_intelligence_properties_geolocation" } }, "type": "object" }, "location_shared": { "properties": { "ip_address": { "description": "The applicant's ip address.", "type": "string", "example": "127.0.0.1" }, "country_of_residence": { "allOf": [ { "$ref": "#/components/schemas/country_codes" } ], "description": "The applicant's country of residence in 3-letter ISO code.", "example": "GBR" } }, "type": "object" }, "us_driving_licence_shared": { "description": "An object that contains all accepted fields for the Driver's License Data Verification report.", "properties": { "id_number": { "description": "Driving licence ID number", "type": "string", "example": "D1234567" }, "issue_state": { "description": "Two letter code of issuing state (state-issued driving licenses only)", "pattern": "^[A-Z]{2}$", "type": "string", "example": "CA" }, "address_line_1": { "description": "Line 1 of the address", "type": "string", "example": "100 Main Street" }, "address_line_2": { "description": "Line 2 of the address", "type": "string", "example": "Apt 4B" }, "city": { "description": "The city of the owner's address", "type": "string", "example": "San Francisco" }, "date_of_birth": { "description": "Date of birth in yyyy-mm-dd format", "format": "date", "type": "string" }, "document_category": { "description": "Document category.", "enum": ["driver license", "driver permit", "id card"], "type": "string" }, "expiration_date": { "description": "Expiration date of the driving licence in yyyy-mm-dd format", "format": "date", "type": "string" }, "eye_color_code": { "description": "Eye color code.", "enum": [ "BLK", "BLU", "BRO", "DIC", "GRY", "GRN", "HAZ", "MAR", "PNK" ], "type": "string" }, "first_name": { "description": "The owner's first name", "type": "string", "example": "Jane" }, "gender": { "enum": ["Male", "Female"], "readOnly": true, "type": "string" }, "issue_date": { "description": "Issue date in yyyy-mm-dd format", "format": "date", "type": "string" }, "last_name": { "description": "The owner's surname", "type": "string", "example": "Doe" }, "middle_name": { "description": "The owner's middle name", "type": "string", "example": "Mary" }, "name_suffix": { "description": "The owner's name suffix", "type": "string", "example": "Jr" }, "postal_code": { "description": "The postcode or ZIP of the owner's address", "type": "string", "example": "94105" }, "state": { "description": "2-characters state code", "example": "CA", "pattern": "^[A-Z]{2}$", "type": "string" }, "weight_measure": { "description": "Weight in pounds", "type": "integer" } }, "required": ["id_number", "issue_state"], "type": "object" }, "document_IQ_reasons": { "properties": { "dark_photo": { "description": "When an image of the document is too dark to be able to see data points.", "type": "string" }, "glare_on_photo": { "description": "When there is light reflecting on the document causing glare to obstruct data points.", "type": "string" }, "blurred_photo": { "description": "When data points are blurred and no reference can be made elsewhere in the document or if the data points are too blurry and 'they could be something else'.", "type": "string" }, "covered_photo": { "description": "When data points have been covered either by the applicant or by another object such as a sticker.", "type": "string" }, "other_photo_issue": { "description": "Any other reason not listed, such as when holograms are obscuring data points.", "type": "string" }, "damaged_document": { "description": "When a document is damaged and we are unable to make out data points.", "type": "string" }, "incorrect_side": { "description": "When the incorrect side of a document has been uploaded, and we have not received the front.", "type": "string" }, "cut_off_document": { "description": "When data points are not included in the image due to the document being cut off.", "type": "string" }, "no_document_in_image": { "description": "If no document has been uploaded or there is a blank image.", "type": "string" }, "two_documents_uploaded": { "description": "When 2 different documents are submitted in the same check.", "type": "string" } }, "type": "object" }, "document_CDQ_reasons": { "properties": { "obscured_data_points": { "description": "When data points are obscured to the point that we cannot confirm if the fonts match the expected ones.", "type": "string" }, "obscured_security_features": { "description": "When a critical security feature is obscured. This can also refer to when the holder's wet signature, necessary for the document to be valid, is not present.", "type": "string" }, "abnormal_document_features": { "description": "One of 3 reasons (1) OCR Assisted Scans (i.e. when you're able to move the mouse and highlight part of text), (2) Severely Washed out Background, (3) Overlapping Text.", "type": "string" }, "watermarks_digital_text_overlay": { "description": "Any digital text or electronic watermarks on the document.", "type": "string" }, "corner_removed": { "description": "If the corner has been physically cut off. This can be found on some documents that are no longer valid.", "type": "string" }, "punctured_document": { "description": "A punched hole is present.", "type": "string" }, "missing_back": { "description": "When the back of a document is needed for processing, but is not available.", "type": "string" }, "digital_document": { "description": "When a document has been published digitally, there aren't enough security features to review so we cannot perform a full fraud assessment.", "type": "string" } }, "type": "object" }, "document_ODP_reasons": { "properties": { "photo_of_screen": { "description": "When the applicant's document is on a physical screen or device.", "type": "string" }, "screenshot": { "description": "When the applicant has used their mobile phone, tablet, or computer to take a photo within the device.", "type": "string" }, "document_on_printed_paper": { "description": "When the applicant has previously captured an image of the document, printed it out, and has now taken a photo of this print out to upload.", "type": "string" }, "scan": { "description": "When the document has clearly been captured using a scanner and there are visible indicators of this", "type": "string" } }, "type": "object" }, "photo_reasons": { "properties": { "digital_tampering": { "description": "Flags when evidence is found that the image was manipulated by Photoshop, or other software.", "type": "string" }, "fake_webcam": { "description": "Flags when evidence is found that a fake webcam was used.", "type": "string" }, "time_of_capture": { "description": "Flags when evidence is found that the live photo was taken more than 24 hours before live photo upload.", "type": "string" }, "emulator": { "description": "Flags when evidence is found that an Android emulator was used.", "type": "string" }, "reasons": { "description": "Additional comma separated details such as the exact digital tampering software used, or the name of the fake webcam.", "type": "string" } }, "type": "object" }, "photo_auto_reasons": { "properties": { "digital_tampering": { "description": "Flags when evidence is found that the image was manipulated by Photoshop, or other software.", "type": "string" }, "fake_webcam": { "description": "Flags when evidence is found that a fake webcam was used.", "type": "string" }, "time_of_capture": { "description": "Flags when evidence is found that the live photo was taken more than 24 hours before live photo upload.", "type": "string" }, "emulator": { "description": "Flags when evidence is found that an Android emulator was used.", "type": "string" }, "reasons": { "description": "Additional comma separated details such as the exact digital tampering software used, or the name of the fake webcam.", "type": "string" } }, "type": "object" }, "video_reasons": { "properties": { "fake_webcam": { "description": "Flags when evidence is found that a fake webcam was used.", "type": "string" }, "challenge_reuse": { "description": "Flags when evidence is found that the video was uploaded in an attempt to circumvent the randomness of the speaking and head turn challenges", "type": "string" }, "emulator": { "description": "Flags when evidence is found that an Android emulator was used.", "type": "string" }, "reasons": { "description": "Additional comma separated details such as the name of the fake webcam.", "type": "string" } }, "type": "object" }, "idr_ssn_breakdown": { "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/idr_ssn_breakdown_breakdown" } }, "type": "object" }, "Applicants_list": { "properties": { "applicants": { "items": { "$ref": "#/components/schemas/applicant" }, "type": "array" } }, "required": ["applicants"], "title": "Applicants list", "type": "object" }, "ErrorProperties": { "properties": { "type": { "type": "string" }, "message": { "type": "string" }, "fields": { "additionalProperties": true, "type": "object" } }, "title": "ErrorProperties", "type": "object" }, "Error": { "properties": { "error": { "$ref": "#/components/schemas/ErrorProperties" } }, "title": "Error", "type": "object" }, "Documents_list": { "properties": { "documents": { "items": { "$ref": "#/components/schemas/document" }, "type": "array" } }, "required": ["documents"], "title": "Documents list", "type": "object" }, "Signing_Documents_list": { "properties": { "signing_documents": { "items": { "$ref": "#/components/schemas/signing_document" }, "type": "array" } }, "required": ["signing_documents"], "title": "Signing Documents list", "type": "object" }, "Live_Photos_list": { "properties": { "live_photos": { "items": { "$ref": "#/components/schemas/live_photo" }, "type": "array" } }, "required": ["live_photos"], "title": "Live Photos list", "type": "object" }, "Live_Videos_list": { "properties": { "live_videos": { "items": { "$ref": "#/components/schemas/live_video" }, "type": "array" } }, "required": ["live_videos"], "title": "Live Videos list", "type": "object" }, "TaskItem": { "properties": { "id": { "$ref": "#/components/schemas/task_id" }, "workflow_run_id": { "description": "The workflow run id the task belongs to.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "task_def_id": { "$ref": "#/components/schemas/task_def_id" }, "task_def_version": { "description": "The task definition version.", "nullable": true, "type": "string" }, "created_at": { "description": "The date and time when the Task was created.", "format": "date-time", "type": "string" }, "updated_at": { "description": "The date and time when the Task was last updated.", "format": "date-time", "type": "string" } }, "title": "TaskItem", "type": "object" }, "Motion_Captures_list": { "properties": { "motion_captures": { "items": { "$ref": "#/components/schemas/motion_capture" }, "type": "array" } }, "required": ["motion_captures"], "title": "Motion Captures list", "type": "object" }, "Biometric_tokens_response": { "properties": { "biometric_tokens": { "items": { "$ref": "#/components/schemas/biometric_token" }, "type": "array" } }, "required": ["biometric_tokens"], "title": "Biometric tokens response", "type": "object" }, "Invalidated_biometric_tokens_response": { "properties": { "biometric_tokens": { "$ref": "#/components/schemas/invalidated_biometric_token_summary" } }, "required": ["biometric_tokens"], "title": "Invalidated biometric tokens response", "type": "object" }, "Biometric_token_response": { "properties": { "biometric_token": { "$ref": "#/components/schemas/biometric_token" } }, "required": ["biometric_token"], "title": "Biometric token response", "type": "object" }, "Updated_biometric_token_response": { "properties": { "biometric_token": { "$ref": "#/components/schemas/biometric_token" } }, "required": ["biometric_token"], "title": "Updated biometric token response", "type": "object" }, "Invalidated_biometric_token_response": { "properties": { "biometric_tokens": { "$ref": "#/components/schemas/invalidated_biometric_token_summary" } }, "required": ["biometric_tokens"], "title": "Invalidated biometric token response", "type": "object" }, "Watchlist_monitors_list": { "properties": { "monitors": { "items": { "$ref": "#/components/schemas/watchlist_monitor" }, "type": "array" } }, "required": ["monitors"], "title": "Watchlist monitors list", "type": "object" }, "Id_Photos_list": { "properties": { "id_photos": { "items": { "$ref": "#/components/schemas/id_photo" }, "type": "array" } }, "required": ["id_photos"], "title": "Id Photos list", "type": "object" }, "Passkeys_list": { "properties": { "passkeys": { "items": { "$ref": "#/components/schemas/passkey" }, "type": "array" } }, "required": ["passkeys"], "title": "Passkeys list", "type": "object" }, "Webhooks_list": { "properties": { "webhooks": { "items": { "$ref": "#/components/schemas/webhook" }, "type": "array" } }, "required": ["webhooks"], "title": "Webhooks list", "type": "object" }, "Addresses_list": { "properties": { "addresses": { "items": { "$ref": "#/components/schemas/address" }, "type": "array" } }, "required": ["address"], "title": "Addresses list", "type": "object" }, "extract_request": { "properties": { "document_id": { "description": "The unique identifier of the uploaded document to run extraction on", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, "required": ["document_id"], "type": "object" }, "ErrorProperties_1": { "properties": { "type": { "type": "string" }, "message": { "type": "string" } }, "title": "ErrorProperties", "type": "object" }, "Error_1": { "properties": { "document_id": { "description": "The unique identifier of the uploaded document", "type": "string" }, "error": { "$ref": "#/components/schemas/ErrorProperties_1" } }, "title": "Error", "type": "object" }, "Checks_list": { "properties": { "checks": { "items": { "$ref": "#/components/schemas/check" }, "type": "array" } }, "required": ["checks"], "title": "Checks list", "type": "object" }, "Reports_list": { "properties": { "reports": { "items": { "$ref": "#/components/schemas/report" }, "type": "array" } }, "required": ["reports"], "title": "Reports list", "type": "object" }, "Complete_Task_Data_Builder": { "description": "The Task completion payload.", "oneOf": [ { "items": { "type": "object" }, "type": "array" }, { "type": "object" } ], "title": "Complete Task Data Builder" }, "biometric_token_data": { "description": "Token metadata.", "properties": { "inserted_at": { "description": "Timestamp indicating when the biometric token was created.", "format": "date-time", "type": "string" }, "media_type": { "description": "Type of media associated with the biometric token.", "type": "string" }, "status": { "description": "Current biometric token status.", "enum": [ "awaiting_input", "processing", "error", "abandoned", "review", "declined", "approved" ], "type": "string" } }, "required": ["inserted_at", "media_type", "status"], "type": "object" }, "invalidated_biometric_token_summary_deleted_items": { "description": "Summary of invalidated biometric token items.", "properties": { "count": { "description": "Number of invalidated biometric tokens.", "type": "integer" } }, "required": ["count"], "type": "object" }, "Watchlist_monitor_match": { "properties": { "id": { "description": "Monitor ID", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "enabled": { "description": "Monitor status", "type": "boolean" } }, "title": "Watchlist monitor match", "type": "object" }, "webhook_event_payload_object": { "description": "The object affected by this event.", "properties": { "id": { "description": "The unique identifier of the resource.", "type": "string" }, "status": { "$ref": "#/components/schemas/webhook_event_object_status" }, "started_at_iso8601": { "description": "The date and time when the operation was started, if available.", "example": "2019-10-28T14:55:09Z", "format": "date-time", "type": "string" }, "completed_at_iso8601": { "description": "The date and time when the operation was completed, if available.", "example": "2019-10-28T15:00:39Z", "format": "date-time", "type": "string" }, "href": { "description": "The uri of the resource.", "type": "string" } }, "required": ["id"], "type": "object" }, "webhook_event_payload_resource": { "description": "The resource affected by this event.", "properties": { "id": { "description": "The identifier of the resource.", "example": "profile_4f4b2", "type": "string" }, "applicant_id": { "description": "The unique identifier for the Applicant.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "status": { "$ref": "#/components/schemas/webhook_event_resource_status" }, "created_at": { "description": "The date and time when the resource was created.", "example": "2022-12-05T16:41:43Z", "format": "date-time", "type": "string" }, "updated_at": { "description": "The date and time when the resource was last updated.", "example": "2022-12-19T16:41:44Z", "format": "date-time", "type": "string" }, "dashboard_url": { "description": "The URL for viewing the resource on Onfido Dashboard.", "example": "https://dashboard.onfido.com/results/36a56899-d617-4988-85bf-b76640861bf5", "type": "string" }, "workflow_id": { "description": "The unique identifier for the Workflow.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "workflow_run_id": { "example": "2f152409-d6c4-4711-8750-48517f99a8d6", "format": "uuid", "type": "string" }, "workflow_version_id": { "description": "The identifier for the Workflow version.", "example": 0, "type": "integer" }, "task_def_id": { "$ref": "#/components/schemas/task_def_id" }, "task_def_version": { "description": "The task definition version.", "nullable": true, "type": "string" }, "input": { "description": "Input object with the fields used by the Task execution.", "type": "object" }, "output": { "description": "Value field (it can be an Object, List, etc.) with the fields produced by the Task execution.", "nullable": true, "type": "object" }, "reasons": { "description": "The reasons the Workflow Run outcome was reached. Configurable when creating the Workflow Version.", "items": { "type": "string" }, "type": "array" }, "tags": { "description": "A list of tags associated with the Workflow Run.", "items": { "type": "string" }, "type": "array" }, "link": { "allOf": [ { "$ref": "#/components/schemas/workflow_run_link" } ], "description": "Object for the configuration of the Workflow Run link.", "type": "object" }, "error": { "allOf": [ { "$ref": "#/components/schemas/workflow_run_error" } ], "description": "Error object that details why a Workflow Run is in Error status.", "type": "object" }, "customer_user_id": { "description": "Customer-provided user identifier.", "maxLength": 256, "type": "string", "example": "customer-12345" }, "timeline_file_download_url": { "description": "Pre-signed URL to download the timeline file for the Workflow Run.", "example": "https://example.com/workflow-api/timeline_abc123.pdf?expires=1234567890&signature=abcd1234", "type": "string" } }, "type": "object" }, "webhook_event_payload": { "properties": { "resource_type": { "allOf": [ { "$ref": "#/components/schemas/webhook_event_resource_type" } ], "description": "Indicates the resource affected by this event.", "example": "workflow_task", "type": "string" }, "action": { "allOf": [ { "$ref": "#/components/schemas/webhook_event_type" } ], "description": "The event that triggered this webhook.", "example": "workflow_task.completed", "type": "string" }, "object": { "$ref": "#/components/schemas/webhook_event_payload_object" }, "resource": { "$ref": "#/components/schemas/webhook_event_payload_resource" } }, "required": ["event", "resource_id", "resource_type"], "type": "object" }, "Webhooks_resend_item": { "properties": { "resource_id": { "description": "ID of the resource whose webhooks are to be retriggered.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "event": { "allOf": [ { "$ref": "#/components/schemas/webhook_event_type" } ], "description": "The events that should retrigger webhooks. Accepts values check.completed.", "example": "check.completed", "type": "string" } }, "required": ["event", "resource_id"], "title": "Webhooks resend item", "type": "object" }, "repeat_attempts_list_repeat_attempts_inner": { "properties": { "report_id": { "description": "The unique identifier of the matching Document report.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "applicant_id": { "description": "The unique identifier of the applicant for the matching Document report.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "date_of_birth": { "description": "Whether the dates of birth are exactly the same or are different.", "enum": ["match", "mismatch"], "type": "string" }, "names": { "description": "Whether the names are exactly the same or are different.", "enum": ["match", "mismatch"], "type": "string" }, "result": { "description": "The report result of this attempt.", "enum": ["clear", "consider"], "type": "string" }, "created_at": { "description": "When the matching report was created.", "format": "date-time", "type": "string" }, "completed_at": { "description": "When the matching report was completed.", "format": "date-time", "type": "string" } }, "type": "object" }, "extraction_document_classification": { "properties": { "issuing_country": { "allOf": [ { "$ref": "#/components/schemas/country_codes" } ], "description": "Document country in 3-letter ISO code.", "type": "string", "example": "GBR" }, "document_type": { "allOf": [ { "$ref": "#/components/schemas/document_types" } ], "description": "Type of document.", "type": "string" }, "issuing_state": { "description": "The state that issued the document (if available).", "type": "string" }, "subtype": { "description": "The document subtype (if available).", "enum": [ "SPE", "ali", "alien", "com", "commercial", "dom", "domestic", "full", "not_full", "full driving licence", "heavy_vehicle", "learner", "minor (u21 or u18)", "mot", "mul", "provisional", "provisional driving licence", "ser", "spe", "special", "standard", "tem", "u21" ], "type": "string" }, "version": { "description": "The document issuing version (if available).", "type": "string" } }, "type": "object" }, "extraction_extracted_data": { "properties": { "document_number": { "description": "The official document number.", "type": "string" }, "first_name": { "description": "First name.", "type": "string", "example": "Jane" }, "last_name": { "description": "Last name.", "type": "string", "example": "Doe" }, "full_name": { "description": "Full name.", "type": "string" }, "spouse_name": { "description": "Spouse name (French documents only).", "type": "string" }, "widow_name": { "description": "Widow name (French documents only).", "type": "string" }, "alias_name": { "description": "Alias name (French documents only).", "type": "string" }, "gender": { "description": "Gender (Valid values are Male and Female).", "enum": ["Male", "Female"], "type": "string" }, "date_of_birth": { "description": "Date of birth in YYYY-MM-DD format.", "format": "date", "type": "string" }, "date_of_expiry": { "description": "Date of expiry in YYYY-MM-DD format.", "format": "date", "type": "string" }, "expiry_date": { "description": "Date of expiry in YYYY-MM-DD format.", "format": "date", "type": "string" }, "nationality": { "description": "Nationality in 3-letter ISO code.", "pattern": "^[A-Z]{3}$", "type": "string" }, "mrz_line_1": { "description": "Line 1 of the MRZ code.", "type": "string" }, "mrz_line_2": { "description": "Line 2 of the MRZ code.", "type": "string" }, "mrz_line_3": { "description": "Line 3 of the MRZ code.", "type": "string" }, "address_1": { "description": "Line 1 of the address.", "type": "string" }, "address_2": { "description": "Line 2 of the address.", "type": "string" }, "address_3": { "description": "Line 3 of the address.", "type": "string" }, "address_4": { "description": "Line 4 of the address.", "type": "string" }, "address_5": { "description": "Line 5 of the address.", "type": "string" }, "issuing_authority": { "description": "Issuing authority.", "type": "string" }, "issuing_country": { "allOf": [ { "$ref": "#/components/schemas/country_codes" } ], "description": "Document country in 3-letter ISO code.", "type": "string", "example": "GBR" }, "document_type": { "allOf": [ { "$ref": "#/components/schemas/document_types" } ], "description": "Type of document.", "type": "string" }, "place_of_birth": { "description": "Place of birth.", "type": "string" }, "issuing_state": { "description": "The state that issued the document.", "type": "string" }, "issuing_date": { "description": "Issuing date in YYYY-MM-DD format.", "format": "date", "type": "string" }, "personal_number": { "description": "The owner's unique identification number.", "type": "string" } }, "type": "object" }, "Document_Properties_with_Driving_Licence_Information": { "allOf": [ { "$ref": "#/components/schemas/document_properties" }, { "$ref": "#/components/schemas/document_properties_with_driving_licence_information" } ], "title": "Document Properties with Driving Licence Information" }, "document_with_driver_verification_report_allOf_properties_allOf_vehicle_class_details_inner": { "properties": { "category": { "description": "Vehicle class/category", "type": "string" }, "codes": { "description": "Special conditions driver must meet", "type": "string" }, "obtainment_date": { "description": "Category obtainment date", "format": "date", "type": "string" }, "expiry_date": { "description": "Category expiry date", "format": "date", "type": "string" } }, "type": "object" }, "document_with_driver_verification_report_allOf_properties_allOf_passenger_vehicle": { "description": "Normalised data for passenger cars", "properties": { "is_qualified": { "description": "Whether they are qualified for a passenger car, such as a \u201cB\u201d class in the UK", "type": "boolean" }, "obtainment_date": { "description": "Date the class qualification was obtained", "format": "date", "type": "string" }, "expiry_date": { "description": "Date the class qualification expires, which may be different to doc expiry", "format": "date", "type": "string" } }, "type": "object" }, "document_with_driver_verification_report_allOf_properties": { "allOf": [ { "$ref": "#/components/schemas/document_properties" }, { "properties": { "drivers_licence": { "description": "True for **non-restricted** driving licences", "type": "boolean" }, "restricted_licence": { "description": "True for **limited/restricted** driving license, including learner's permits", "type": "boolean" }, "raw_licence_category": { "description": "Underlying, non-normalised, licence category (e.g. \"Junior operators license\")", "type": "string" }, "raw_vehicle_classes": { "description": "Comma-separated vehicle classes that the user is qualified for", "type": "string" }, "manual_transmission_restriction": { "description": "True if the user is not qualified to drive a manual transmission", "type": "boolean" }, "vehicle_class_details": { "description": "Detailed classes/categories information", "items": { "$ref": "#/components/schemas/document_with_driver_verification_report_allOf_properties_allOf_vehicle_class_details_inner" }, "type": "array" }, "passenger_vehicle": { "$ref": "#/components/schemas/document_with_driver_verification_report_allOf_properties_allOf_passenger_vehicle" } }, "type": "object" } ] }, "india_pan_report_allOf_breakdown_device_breakdown_pan_valid": { "properties": { "result": { "type": "string" } }, "type": "object" }, "india_pan_report_allOf_breakdown_device_breakdown": { "properties": { "pan_valid": { "$ref": "#/components/schemas/india_pan_report_allOf_breakdown_device_breakdown_pan_valid" }, "name_match": { "$ref": "#/components/schemas/india_pan_report_allOf_breakdown_device_breakdown_pan_valid" } }, "type": "object" }, "india_pan_report_allOf_breakdown_device": { "properties": { "breakdown": { "$ref": "#/components/schemas/india_pan_report_allOf_breakdown_device_breakdown" } }, "type": "object" }, "india_pan_report_allOf_breakdown": { "properties": { "device": { "$ref": "#/components/schemas/india_pan_report_allOf_breakdown_device" } }, "type": "object" }, "india_pan_report_allOf_properties_device": { "properties": { "pan": { "description": "The applicant's PAN (10 digit alphanumeric number).", "type": "string" }, "full_name": { "description": "The applicant's full name.", "type": "string" } }, "type": "object" }, "india_pan_report_allOf_properties": { "properties": { "device": { "$ref": "#/components/schemas/india_pan_report_allOf_properties_device" } }, "type": "object" }, "document_breakdown_data_comparison_breakdown_issuing_country": { "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_data_comparison_breakdown": { "properties": { "issuing_country": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "gender": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "date_of_expiry": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "last_name": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "document_type": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "document_numbers": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "first_name": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "date_of_birth": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "document_breakdown_data_comparison": { "description": "Asserts whether data on the document is consistent with data provided when creating an applicant through the API.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown" } }, "type": "object" }, "document_breakdown_data_validation_breakdown_document_expiration": { "description": "If this is flagged, the document has expired.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_data_validation_breakdown_expiry_date": { "description": "If this is flagged, the expiration date has the incorrect format.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_data_validation_breakdown": { "properties": { "gender": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "date_of_birth": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "document_numbers": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "document_expiration": { "$ref": "#/components/schemas/document_breakdown_data_validation_breakdown_document_expiration" }, "expiry_date": { "$ref": "#/components/schemas/document_breakdown_data_validation_breakdown_expiry_date" }, "mrz": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "barcode": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "document_breakdown_data_validation": { "description": "Asserts whether algorithmically validatable elements are correct.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/document_breakdown_data_validation_breakdown" } }, "type": "object" }, "document_breakdown_image_integrity_breakdown_image_quality": { "description": "Asserts whether the quality of the image was sufficient for processing.", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/document_IQ_reasons" } }, "type": "object" }, "document_breakdown_image_integrity_breakdown_supported_document": { "description": "Asserts whether the submitted document is supported.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_image_integrity_breakdown_colour_picture": { "description": "Asserts whether the image was a colour one.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_image_integrity_breakdown_conclusive_document_quality": { "description": "Asserts if the document was of enough quality to be able to perform a fraud inspection.", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/document_CDQ_reasons" } }, "type": "object" }, "document_breakdown_image_integrity_breakdown": { "properties": { "image_quality": { "$ref": "#/components/schemas/document_breakdown_image_integrity_breakdown_image_quality" }, "supported_document": { "$ref": "#/components/schemas/document_breakdown_image_integrity_breakdown_supported_document" }, "colour_picture": { "$ref": "#/components/schemas/document_breakdown_image_integrity_breakdown_colour_picture" }, "conclusive_document_quality": { "$ref": "#/components/schemas/document_breakdown_image_integrity_breakdown_conclusive_document_quality" } }, "type": "object" }, "document_breakdown_image_integrity": { "description": "Asserts if the document is of sufficient quality to verify.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/document_breakdown_image_integrity_breakdown" } }, "type": "object" }, "document_breakdown_visual_authenticity_breakdown_fonts": { "description": "Fonts in the document don't match the expected ones.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_visual_authenticity_breakdown_picture_face_integrity": { "description": "The pictures of the person identified on the document show signs of tampering or alteration.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_visual_authenticity_breakdown_template": { "description": "The document doesn't match the expected template for the document type and country it is from.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_visual_authenticity_breakdown_security_features": { "description": "Security features expected on the document are missing or wrong.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_visual_authenticity_breakdown_original_document_present": { "description": "The document was not present when the photo was taken.", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/document_ODP_reasons" } }, "type": "object" }, "document_breakdown_visual_authenticity_breakdown_digital_tampering": { "description": "Indication of digital tampering in the image.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_visual_authenticity_breakdown_other": { "description": "This sub-breakdown is returned for backward compatibility reasons. Its value will be consider when at least one of the other breakdowns is consider, and clear when all the other breakdowns are clear.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_visual_authenticity_breakdown_face_detection": { "description": "No face was detected on the document.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_visual_authenticity_breakdown": { "properties": { "fonts": { "$ref": "#/components/schemas/document_breakdown_visual_authenticity_breakdown_fonts" }, "picture_face_integrity": { "$ref": "#/components/schemas/document_breakdown_visual_authenticity_breakdown_picture_face_integrity" }, "template": { "$ref": "#/components/schemas/document_breakdown_visual_authenticity_breakdown_template" }, "security_features": { "$ref": "#/components/schemas/document_breakdown_visual_authenticity_breakdown_security_features" }, "original_document_present": { "$ref": "#/components/schemas/document_breakdown_visual_authenticity_breakdown_original_document_present" }, "digital_tampering": { "$ref": "#/components/schemas/document_breakdown_visual_authenticity_breakdown_digital_tampering" }, "other": { "$ref": "#/components/schemas/document_breakdown_visual_authenticity_breakdown_other" }, "face_detection": { "$ref": "#/components/schemas/document_breakdown_visual_authenticity_breakdown_face_detection" } }, "type": "object" }, "document_breakdown_visual_authenticity": { "description": "Asserts whether visual, non-textual, elements are correct given the type of document.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/document_breakdown_visual_authenticity_breakdown" } }, "type": "object" }, "document_breakdown_data_consistency_breakdown": { "properties": { "date_of_expiry": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "document_numbers": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "issuing_country": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "document_type": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "date_of_birth": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "gender": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "first_name": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "nationality": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "last_name": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "multiple_data_sources_present": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "document_breakdown_data_consistency": { "description": "Asserts whether data represented in multiple places on the document is consistent.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/document_breakdown_data_consistency_breakdown" } }, "type": "object" }, "document_breakdown_police_record": { "description": "Asserts whether the document had been identified as lost, stolen or otherwise compromised.", "properties": { "result": { "type": "string" } }, "type": "object" }, "document_breakdown_compromised_document_breakdown": { "properties": { "document_database": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "repeat_attempts": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "document_breakdown_compromised_document": { "description": "Asserts whether the image of the document has been found in our internal database or if it was used in a suspicious way.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/document_breakdown_compromised_document_breakdown" } }, "type": "object" }, "document_breakdown_age_validation_breakdown": { "properties": { "minimum_accepted_age": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "document_breakdown_age_validation": { "description": "Asserts whether the age calculated from the document's date of birth data point is greater than or equal to the minimum accepted age.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/document_breakdown_age_validation_breakdown" } }, "type": "object" }, "document_breakdown_issuing_authority_breakdown_nfc_active_authentication": { "description": "Asserts whether the document NFC chip is original or cloned.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_issuing_authority_breakdown_nfc_passive_authentication": { "description": "Asserts whether the document NFC chip data was tampered.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "document_breakdown_issuing_authority_breakdown": { "properties": { "nfc_active_authentication": { "$ref": "#/components/schemas/document_breakdown_issuing_authority_breakdown_nfc_active_authentication" }, "nfc_passive_authentication": { "$ref": "#/components/schemas/document_breakdown_issuing_authority_breakdown_nfc_passive_authentication" } }, "type": "object" }, "document_breakdown_issuing_authority": { "description": "Asserts whether data on the document matches the issuing authority data.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/document_breakdown_issuing_authority_breakdown" } }, "type": "object" }, "document_properties_document_numbers_inner": { "properties": { "value": { "type": "string", "example": "AB123456C" }, "type": { "type": "string" } }, "type": "object" }, "document_properties_address_lines": { "properties": { "street_address": { "type": "string" }, "state": { "type": "string", "example": "TX" }, "postal_code": { "type": "string", "example": "94105" }, "country": { "type": "string" }, "city": { "type": "string", "example": "San Francisco" }, "country_code": { "type": "string" } }, "type": "object" }, "document_properties_barcode_inner": { "properties": { "first_name": { "type": "string", "example": "Jane" }, "middle_name": { "type": "string", "example": "Mary" }, "last_name": { "type": "string", "example": "Doe" }, "document_type": { "type": "string" }, "date_of_expiry": { "format": "date", "type": "string" }, "date_of_birth": { "format": "date", "type": "string" }, "issuing_date": { "format": "date", "type": "string" }, "address_line_1": { "type": "string", "example": "100 Main Street" }, "address_line_2": { "type": "string", "example": "Apt 4B" }, "address_line_3": { "type": "string" }, "address_line_4": { "type": "string" }, "address_line_5": { "type": "string" }, "issuing_state": { "type": "string" }, "class": { "type": "string" }, "gender": { "type": "string" }, "issuing_country": { "type": "string", "example": "GBR" }, "document_number": { "type": "string" }, "real_id_classification": { "type": "string" } }, "type": "object" }, "document_properties_nfc": { "properties": { "document_type": { "type": "string" }, "issuing_country": { "type": "string", "example": "GBR" }, "full_name": { "type": "string" }, "document_number": { "type": "string" }, "nationality": { "type": "string" }, "date_of_birth": { "format": "date", "type": "string" }, "gender": { "type": "string" }, "date_of_expiry": { "format": "date", "type": "string" }, "personal_number": { "type": "string" }, "place_of_birth": { "type": "string" }, "address": { "type": "string" }, "issuing_date": { "format": "date", "type": "string" }, "issuing_authority": { "type": "string" } }, "type": "object" }, "document_properties_document_classification": { "properties": { "issuing_country": { "type": "string", "example": "GBR" }, "document_type": { "type": "string" }, "issuing_state": { "type": "string" } }, "type": "object" }, "document_properties_extracted_data": { "properties": { "document_number": { "type": "string" }, "date_of_birth": { "format": "date", "type": "string" }, "date_of_expiry": { "format": "date", "type": "string" }, "first_name": { "type": "string", "example": "Jane" }, "last_name": { "type": "string", "example": "Doe" }, "middle_name": { "type": "string", "example": "Mary" }, "full_name": { "type": "string" }, "spouse_name": { "type": "string" }, "widow_name": { "type": "string" }, "alias_name": { "type": "string" }, "gender": { "type": "string" }, "mrz_line1": { "type": "string" }, "mrz_line2": { "type": "string" }, "mrz_line3": { "type": "string" }, "nationality": { "type": "string" }, "address_line_1": { "type": "string", "example": "100 Main Street" }, "address_line_2": { "type": "string", "example": "Apt 4B" }, "address_line_3": { "type": "string" }, "address_line_4": { "type": "string" }, "address_line_5": { "type": "string" }, "issuing_authority": { "type": "string" } }, "type": "object" }, "Document_Properties_Driving_Licence_Information_Item": { "properties": { "category": { "type": "string" }, "obtainment_date": { "format": "date", "type": "string" }, "expiry_date": { "format": "date", "type": "string" }, "codes": { "type": "string" } }, "title": "Document Properties Driving Licence Information Item", "type": "object" }, "facial_similarity_photo_breakdown_face_comparison_breakdown_face_match_properties": { "properties": { "score": { "description": "A floating point number between 0 and 1 that expresses how similar the two faces are, where 1 is a perfect match.", "format": "float", "type": "number" }, "document_id": { "description": "The UUID for the document containing the extracted face that was used for face matching.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" } }, "type": "object" }, "facial_similarity_photo_breakdown_face_comparison_breakdown_face_match": { "description": "Contains a score value under the properties bag.", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_face_comparison_breakdown_face_match_properties" } }, "type": "object" }, "facial_similarity_photo_breakdown_face_comparison_breakdown": { "properties": { "face_match": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_face_comparison_breakdown_face_match" } }, "type": "object" }, "facial_similarity_photo_breakdown_face_comparison": { "description": "Asserts whether the face in the document matches the face in the live photo.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_face_comparison_breakdown" } }, "type": "object" }, "facial_similarity_photo_breakdown_image_integrity_breakdown_face_detected": { "description": "Asserts a single face of good enough quality has been found in both the document image and the live photo.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "facial_similarity_photo_breakdown_image_integrity_breakdown_source_integrity": { "description": "Asserts whether the live photo is trustworthy - i.e. not digitally tampered, from a fake webcam, or from other dubious sources.", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/photo_reasons" } }, "type": "object" }, "facial_similarity_photo_breakdown_image_integrity_breakdown": { "properties": { "face_detected": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_image_integrity_breakdown_face_detected" }, "source_integrity": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_image_integrity_breakdown_source_integrity" } }, "type": "object" }, "facial_similarity_photo_breakdown_image_integrity": { "description": "Asserts whether the quality and integrity of the uploaded files were sufficient to perform a face comparison.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_image_integrity_breakdown" } }, "type": "object" }, "facial_similarity_photo_breakdown_visual_authenticity_breakdown_spoofing_detection_properties": { "properties": { "score": { "description": "A floating point number between 0 and 1. The closer the score is to 0, the more likely it is to be a spoof.", "format": "float", "type": "number" } }, "type": "object" }, "facial_similarity_photo_breakdown_visual_authenticity_breakdown_spoofing_detection": { "description": "Contains a score value under the properties bag.", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_visual_authenticity_breakdown_spoofing_detection_properties" } }, "type": "object" }, "facial_similarity_photo_breakdown_visual_authenticity_breakdown": { "properties": { "spoofing_detection": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_visual_authenticity_breakdown_spoofing_detection" } }, "type": "object" }, "facial_similarity_photo_breakdown_visual_authenticity": { "description": "Asserts whether the person in the live photo is real and not a spoof.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_visual_authenticity_breakdown" } }, "type": "object" }, "facial_similarity_photo_fully_auto_breakdown_image_integrity_breakdown_source_integrity": { "description": "Asserts whether the live photo is trustworthy - i.e. not digitally tampered, from a fake webcam, or from other dubious sources.", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/photo_auto_reasons" } }, "type": "object" }, "facial_similarity_photo_fully_auto_breakdown_image_integrity_breakdown": { "properties": { "face_detected": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_image_integrity_breakdown_face_detected" }, "source_integrity": { "$ref": "#/components/schemas/facial_similarity_photo_fully_auto_breakdown_image_integrity_breakdown_source_integrity" } }, "type": "object" }, "facial_similarity_photo_fully_auto_breakdown_image_integrity": { "description": "Asserts whether the quality and integrity of the uploaded files were sufficient to perform a face comparison.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/facial_similarity_photo_fully_auto_breakdown_image_integrity_breakdown" } }, "type": "object" }, "facial_similarity_video_breakdown_face_comparison": { "description": "Asserts whether the face in the document matches the face in the live video.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_face_comparison_breakdown" } }, "readOnly": true, "type": "object" }, "facial_similarity_video_breakdown_image_integrity_breakdown_face_detected": { "description": "Asserts a single face of good enough quality has been found in both the document image and the live video.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "facial_similarity_video_breakdown_image_integrity_breakdown_source_integrity": { "description": "Asserts whether the live video is trustworthy - e.g. not from a fake webcam.", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/video_reasons" } }, "type": "object" }, "facial_similarity_video_breakdown_image_integrity_breakdown": { "properties": { "face_detected": { "$ref": "#/components/schemas/facial_similarity_video_breakdown_image_integrity_breakdown_face_detected" }, "source_integrity": { "$ref": "#/components/schemas/facial_similarity_video_breakdown_image_integrity_breakdown_source_integrity" } }, "type": "object" }, "facial_similarity_video_breakdown_image_integrity": { "description": "Asserts whether the quality and integrity of the uploaded files were sufficient to perform a face comparison.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/facial_similarity_video_breakdown_image_integrity_breakdown" } }, "readOnly": true, "type": "object" }, "facial_similarity_video_breakdown_visual_authenticity_breakdown_liveness_detected": { "description": "Asserts whether the numbers and head movements were correctly executed.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "facial_similarity_video_breakdown_visual_authenticity_breakdown_spoofing_detection": { "description": "Asserts whether the live video is not a spoof (such as videos of digital screens).", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_visual_authenticity_breakdown_spoofing_detection_properties" } }, "type": "object" }, "facial_similarity_video_breakdown_visual_authenticity_breakdown": { "properties": { "liveness_detected": { "$ref": "#/components/schemas/facial_similarity_video_breakdown_visual_authenticity_breakdown_liveness_detected" }, "spoofing_detection": { "$ref": "#/components/schemas/facial_similarity_video_breakdown_visual_authenticity_breakdown_spoofing_detection" } }, "type": "object" }, "facial_similarity_video_breakdown_visual_authenticity": { "description": "Asserts whether the person in the live video is real (not a spoof) and live.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/facial_similarity_video_breakdown_visual_authenticity_breakdown" } }, "readOnly": true, "type": "object" }, "facial_similarity_motion_breakdown_face_comparison": { "description": "Asserts whether the face in the document matches the face in the motion capture.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_face_comparison_breakdown" } }, "readOnly": true, "type": "object" }, "facial_similarity_motion_breakdown_image_integrity_breakdown_face_detected": { "description": "Asserts a single face of good enough quality has been found in both the document image and in the motion capture.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "facial_similarity_motion_breakdown_image_integrity_breakdown_source_integrity": { "description": "Asserts whether the motion capture is trustworthy - e.g. not from a fake webcam.", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/video_reasons" } }, "type": "object" }, "facial_similarity_motion_breakdown_image_integrity_breakdown": { "properties": { "face_detected": { "$ref": "#/components/schemas/facial_similarity_motion_breakdown_image_integrity_breakdown_face_detected" }, "source_integrity": { "$ref": "#/components/schemas/facial_similarity_motion_breakdown_image_integrity_breakdown_source_integrity" } }, "type": "object" }, "facial_similarity_motion_breakdown_image_integrity": { "description": "Asserts whether the quality and integrity of the uploaded files were sufficient to perform a face comparison.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/facial_similarity_motion_breakdown_image_integrity_breakdown" } }, "readOnly": true, "type": "object" }, "facial_similarity_motion_breakdown_visual_authenticity_breakdown_spoofing_detection": { "description": "Asserts whether the motion capture is not a spoof (such as videos of digital screens).", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/facial_similarity_photo_breakdown_visual_authenticity_breakdown_spoofing_detection_properties" } }, "type": "object" }, "facial_similarity_motion_breakdown_visual_authenticity_breakdown": { "properties": { "liveness_detected": { "$ref": "#/components/schemas/facial_similarity_video_breakdown_visual_authenticity_breakdown_liveness_detected" }, "spoofing_detection": { "$ref": "#/components/schemas/facial_similarity_motion_breakdown_visual_authenticity_breakdown_spoofing_detection" } }, "type": "object" }, "facial_similarity_motion_breakdown_visual_authenticity": { "description": "Asserts whether the person in the motion capture is real (not a spoof) and live.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/facial_similarity_motion_breakdown_visual_authenticity_breakdown" } }, "readOnly": true, "type": "object" }, "known_faces_breakdown_previously_seen_faces": { "description": "Asserts whether the applicant's most recent facial media (live photo or live video) matches any other live photos or live videos already in your Onfido account database.", "properties": { "result": { "type": "string" } }, "type": "object" }, "known_faces_breakdown_image_integrity": { "description": "Asserts whether the uploaded live photo or live video and the content contained within it were of sufficient quality to perform a face comparison.", "properties": { "result": { "type": "string" } }, "type": "object" }, "known_faces_properties_matches_inner": { "properties": { "applicant_id": { "description": "The applicant ID of the matched applicant.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "score": { "description": "A floating point number between 0 and 1 that expresses how similar the two faces are, where 1 is a perfect match.", "format": "float", "type": "number" }, "media_id": { "description": "The corresponding UUID for the media type.", "format": "uuid", "type": "string", "example": "00000000-0000-0000-0000-000000000000" }, "media_type": { "description": "The media type (for example live_photos or live_videos).", "type": "string" }, "suspected": { "description": "Indicates if match is suspected based on fuzzy name matching feature. Dependent on feature being active for account, otherwise defaults to true.", "type": "boolean" } }, "type": "object" }, "identity_enhanced_breakdown_sources_breakdown_total_sources_properties": { "properties": { "total_number_of_sources": { "example": "4", "type": "string" } }, "type": "object" }, "identity_enhanced_breakdown_sources_breakdown_total_sources": { "description": "The number of sources which produced a match to applicant details.", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/identity_enhanced_breakdown_sources_breakdown_total_sources_properties" } }, "type": "object" }, "identity_enhanced_breakdown_sources_breakdown": { "properties": { "total_sources": { "$ref": "#/components/schemas/identity_enhanced_breakdown_sources_breakdown_total_sources" } }, "type": "object" }, "identity_enhanced_breakdown_sources": { "description": "Asserts if any sources that an applicant's details have been verified against have produced a match.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/identity_enhanced_breakdown_sources_breakdown" } }, "type": "object" }, "identity_enhanced_breakdown_address_breakdown_credit_agencies_properties": { "properties": { "number_of_matches": { "example": "2", "type": "string" } }, "type": "object" }, "identity_enhanced_breakdown_address_breakdown_credit_agencies": { "description": "The number of address matches against credit agencies.", "properties": { "result": { "type": "string" }, "properties": { "$ref": "#/components/schemas/identity_enhanced_breakdown_address_breakdown_credit_agencies_properties" } }, "type": "object" }, "identity_enhanced_breakdown_address_breakdown_telephone_database": { "description": "Address match against telephone database.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "identity_enhanced_breakdown_address_breakdown_voting_register": { "description": "Address match against voting register.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "identity_enhanced_breakdown_address_breakdown": { "properties": { "credit_agencies": { "$ref": "#/components/schemas/identity_enhanced_breakdown_address_breakdown_credit_agencies" }, "telephone_database": { "$ref": "#/components/schemas/identity_enhanced_breakdown_address_breakdown_telephone_database" }, "voting_register": { "$ref": "#/components/schemas/identity_enhanced_breakdown_address_breakdown_voting_register" } }, "type": "object" }, "identity_enhanced_breakdown_address": { "description": "Asserts if the applicant's address matches any sources.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/identity_enhanced_breakdown_address_breakdown" } }, "type": "object" }, "identity_enhanced_breakdown_date_of_birth_breakdown_credit_agencies": { "description": "Date of birth match against credit agencies.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "identity_enhanced_breakdown_date_of_birth_breakdown_voting_register": { "description": "Date of birth match against voting register.", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "identity_enhanced_breakdown_date_of_birth_breakdown": { "properties": { "credit_agencies": { "$ref": "#/components/schemas/identity_enhanced_breakdown_date_of_birth_breakdown_credit_agencies" }, "voting_register": { "$ref": "#/components/schemas/identity_enhanced_breakdown_date_of_birth_breakdown_voting_register" } }, "type": "object" }, "identity_enhanced_breakdown_date_of_birth": { "description": "Asserts if the applicant's date of birth matches any sources.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/identity_enhanced_breakdown_date_of_birth_breakdown" } }, "type": "object" }, "identity_enhanced_breakdown_mortality": { "description": "Asserts if the applicant's details match any death records.", "properties": { "result": { "type": "string" } }, "type": "object" }, "identity_enhanced_properties_matched_addresses_inner": { "properties": { "id": { "description": "The address number.", "type": "number" }, "match_types": { "description": "Sources which contain matched addresses.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "watchlist_aml_breakdown_sanction": { "description": "Asserts if there are any records found in Government and International Organisations Sanctions Lists.", "properties": { "result": { "type": "string" } }, "type": "object" }, "watchlist_aml_breakdown_politically_exposed_person": { "description": "Asserts if there are any records found in the proprietary database of Politically Exposed Persons sourced from government lists, websites and other media sources.", "properties": { "result": { "type": "string" } }, "type": "object" }, "watchlist_aml_breakdown_legal_and_regulatory_warnings": { "description": "Asserts if there are any records found in Law-Enforcement and Regulatory bodies Monitored Lists (including Terrorism, Money Laundering and Most Wanted lists).", "properties": { "result": { "type": "string" } }, "type": "object" }, "watchlist_aml_breakdown_adverse_media": { "description": "Asserts if there are any records found of negative events reported by publicly and generally available media sources.", "properties": { "result": { "type": "string" } }, "type": "object" }, "watchlist_enhanced_properties_records_inner_address_inner": { "properties": { "address_line1": { "type": "string" }, "country": { "allOf": [ { "$ref": "#/components/schemas/country_codes" } ], "type": "string" }, "postal_code": { "type": "string", "example": "94105" }, "state_province": { "type": "string" }, "town": { "type": "string", "example": "London" }, "locator_type": { "type": "string" } }, "type": "object" }, "watchlist_enhanced_properties_records_inner_alias_inner": { "properties": { "alias_name": { "type": "string" }, "alias_type": { "type": "string" } }, "type": "object" }, "watchlist_enhanced_properties_records_inner_associate_inner": { "properties": { "entity_name": { "type": "string" }, "relationship_direction": { "type": "string" }, "relationship_type": { "type": "string" } }, "type": "object" }, "watchlist_enhanced_properties_records_inner_attribute_inner": { "properties": { "attribute_type": { "type": "string" }, "attribute_value": { "type": "string" } }, "type": "object" }, "watchlist_enhanced_properties_records_inner_event_inner_source": { "properties": { "source_date": { "format": "date", "type": "string" }, "source_format": { "type": "string" }, "source_name": { "type": "string" }, "source_url": { "type": "string" } }, "type": "object" }, "watchlist_enhanced_properties_records_inner_event_inner": { "properties": { "category": { "type": "string" }, "event_date": { "format": "date", "type": "string" }, "event_description": { "type": "string" }, "source": { "$ref": "#/components/schemas/watchlist_enhanced_properties_records_inner_event_inner_source" }, "sub_category": { "type": "string" } }, "type": "object" }, "watchlist_enhanced_properties_records_inner_source_inner": { "properties": { "source_headline": { "type": "string" }, "source_name": { "type": "string" }, "source_url": { "type": "string" }, "source_format": { "type": "string" } }, "type": "object" }, "watchlist_enhanced_properties_records_inner": { "properties": { "address": { "description": "All addresses on file.", "items": { "$ref": "#/components/schemas/watchlist_enhanced_properties_records_inner_address_inner" }, "type": "array" }, "alias": { "description": "Any names that the person is also known as.", "items": { "$ref": "#/components/schemas/watchlist_enhanced_properties_records_inner_alias_inner" }, "type": "array" }, "associate": { "description": "Any linked persons, for example family relatives or business partners.", "items": { "$ref": "#/components/schemas/watchlist_enhanced_properties_records_inner_associate_inner" }, "type": "array" }, "attribute": { "description": "Information about the person, for example hair color or nationality.", "items": { "$ref": "#/components/schemas/watchlist_enhanced_properties_records_inner_attribute_inner" }, "type": "array" }, "date_of_birth": { "description": "All the date of births on file.", "items": { "type": "string" }, "type": "array" }, "event": { "description": "Information about events that have occurred to the person, for example deportation or arrest.", "items": { "$ref": "#/components/schemas/watchlist_enhanced_properties_records_inner_event_inner" }, "type": "array" }, "full_name": { "description": "The name on file", "type": "string" }, "position": { "description": "The role, country and date of each position.", "items": { "type": "string" }, "type": "array" }, "source": { "description": "Details about where the information was obtained.", "items": { "$ref": "#/components/schemas/watchlist_enhanced_properties_records_inner_source_inner" }, "type": "array" } }, "type": "object" }, "proof_of_address_breakdown_data_comparison_breakdown": { "properties": { "address": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "first_name": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "last_name": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "proof_of_address_breakdown_data_comparison": { "description": "Asserts whether the first name, last name and address provided by the applicant match those on the PoA document.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/proof_of_address_breakdown_data_comparison_breakdown" } }, "type": "object" }, "proof_of_address_breakdown_document_classification_breakdown": { "properties": { "supported_document": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "proof_of_address_breakdown_document_classification": { "description": "Asserts whether the document is of a valid type as PoA.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/proof_of_address_breakdown_document_classification_breakdown" } }, "type": "object" }, "proof_of_address_breakdown_image_integrity_breakdown": { "properties": { "image_quality": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "proof_of_address_breakdown_image_integrity": { "description": "Asserts whether the quality of the uploaded document was sufficient to verify the address.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/proof_of_address_breakdown_image_integrity_breakdown" } }, "type": "object" }, "us_driving_licence_breakdown_document_breakdown": { "properties": { "category": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "expiration_date": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "issue_date": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "document_number": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "us_driving_licence_breakdown_document": { "description": "Asserts whether the document data provided matches a real driving license in the DMV driver's license database.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/us_driving_licence_breakdown_document_breakdown" } }, "type": "object" }, "us_driving_licence_breakdown_address_breakdown": { "properties": { "city": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "line_1": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "line_2": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "state_code": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "zip4": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "zip5": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "us_driving_licence_breakdown_address": { "description": "Asserts whether the address data provided matches a real driving license in the DMV driver's license database.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/us_driving_licence_breakdown_address_breakdown" } }, "type": "object" }, "us_driving_licence_breakdown_personal_breakdown": { "properties": { "first_name": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "name_suffix": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "height": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "weight": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "sex_code": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "eye_color": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "date_of_birth": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "last_name": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "middle_name": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "first_name_fuzzy": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "middle_name_fuzzy": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "last_name_fuzzy": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "middle_initial": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "us_driving_licence_breakdown_personal": { "description": "Asserts whether the personal data provided matches a real driving license in the DMV driver's license database.", "properties": { "result": { "type": "string" }, "breakdown": { "$ref": "#/components/schemas/us_driving_licence_breakdown_personal_breakdown" } }, "type": "object" }, "device_intelligence_breakdown_device_breakdown": { "properties": { "application_authenticity": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "device_integrity": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" }, "device_reputation": { "$ref": "#/components/schemas/document_breakdown_data_comparison_breakdown_issuing_country" } }, "type": "object" }, "device_intelligence_breakdown_device": { "description": "Asserts whether the device used to upload the media is trustworthy, i.e. it is a real, physical device.", "properties": { "breakdown": { "$ref": "#/components/schemas/device_intelligence_breakdown_device_breakdown" } }, "type": "object" }, "device_intelligence_properties_device": { "properties": { "sdk_version": { "description": "The SDK version that was used.", "type": "string" }, "sdk_source": { "description": "The SDK used to upload the media.", "enum": ["onfido-android-sdk", "onfido-ios-sdk", "onfido-web-sdk"], "type": "string" }, "authentication_type": { "description": "The token used to authenticate the request.", "enum": ["sdk_token", "mobile_token", "api_token"], "type": "string" }, "raw_model": { "description": "The model as set by the phone manufacturer (for Android and iOS) or the browser manufacturer (for Web). The model can be presented in name or number form depending on each manufacturer implementation.", "type": "string" }, "os": { "description": "The operating system of the device. The value came from manufacturer implementation (for Android and iOS) or browser's user agent (for Web).", "type": "string" }, "browser": { "description": "The browser name reported by the browser's user agent.", "type": "string" }, "emulator": { "description": "Whether the device is an emulator.", "type": "boolean" }, "randomized_device": { "description": "Whether the device is providing false randomized device and network information.", "type": "boolean" }, "number_of_ip_reuse_reports": { "description": "Counts the number of distinct document reports submitted in the last 24 hours that are associated with the applicant\u2019s IP address.", "type": "number" }, "number_of_suspected_ip_reuse_reports": { "description": "Counts the number of distinct document reports from the last 24 hours associated with the applicant\u2019s IP address that have a result of suspected and other document integrity or authenticity signals have been flagged.", "type": "number" }, "fake_network_request": { "description": "Whether device is using stolen security tokens to send the network information.", "type": "boolean" }, "ip_reputation": { "description": "Whether there is highly suspicious traffic related to the IP address. The risk depends on the overall ratio of clear checks on a given IP.", "enum": ["NOT_ENOUGH_DATA", "HIGH_RISK", "LOW_RISK"], "type": "string" }, "device_fingerprint_reuse": { "description": "The number of times the device was used to create a report for a new applicant. A value greater than 1 indicates potential device reuse.", "type": "number" }, "single_device_used": { "description": "Whether the document or biometric media were uploaded from a single device.", "nullable": true, "type": "boolean" }, "document_capture": { "description": "Whether the document media were live captured from the device camera.", "enum": ["live", "unknown_method"], "type": "string" }, "biometric_capture": { "description": "Whether the biometric media were live captured from the device camera.", "enum": ["live", "unknown_method"], "type": "string" } }, "type": "object" }, "device_intelligence_properties_ip": { "properties": { "address": { "description": "The IP address that uploaded the media.", "type": "string" } }, "type": "object" }, "device_intelligence_properties_geolocation": { "properties": { "city": { "description": "City location of the IP address.", "type": "string", "example": "San Francisco" }, "region": { "description": "Region location of the IP address.", "type": "string" }, "country": { "allOf": [ { "$ref": "#/components/schemas/country_codes" } ], "description": "Country location of the IP address in a three letter format.", "type": "string" } }, "type": "object" }, "idr_ssn_breakdown_breakdown_last_4_digits_match": { "description": "Last 4 digits of social security number match", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "idr_ssn_breakdown_breakdown_full_match": { "description": "Social security number fully matches", "properties": { "result": { "type": "string" }, "properties": { "type": "object" } }, "type": "object" }, "idr_ssn_breakdown_breakdown": { "properties": { "last_4_digits_match": { "$ref": "#/components/schemas/idr_ssn_breakdown_breakdown_last_4_digits_match" }, "full_match": { "$ref": "#/components/schemas/idr_ssn_breakdown_breakdown_full_match" } }, "type": "object" } }, "securitySchemes": { "Token": { "in": "header", "name": "Authorization", "type": "apiKey" }, "OAuth2ClientCredentials": { "flows": { "clientCredentials": { "scopes": { "all_scopes": "All scopes" }, "tokenUrl": "https://api.{region}.onfido.com/v3.6/oauth/token" } }, "type": "oauth2" } } } }