DefaultApi

All URIs are relative to https://api.onfido.com/v2

Method	HTTP request	Description
cancelReport	POST /checks/{check_id}/reports/{report_id}/cancel	This endpoint is for cancelling individual paused reports.
createApplicant	POST /applicants	Create Applicant
createCheck	POST /applicants/{applicant_id}/checks	Create a check
createWebhook	POST /webhooks	Create a webhook
destroyApplicant	DELETE /applicants/{applicant_id}	Delete Applicant
downloadDocument	GET /applicants/{applicant_id}/documents/{document_id}/download	Download a documents raw data
downloadLivePhoto	GET /live_photos/{live_photo_id}/download	Download live photo
findAddresses	GET /addresses/pick	Search for addresses by postcode
findApplicant	GET /applicants/{applicant_id}	Retrieve Applicant
findCheck	GET /applicants/{applicant_id}/checks/{check_id}	Retrieve a Check
findDocument	GET /applicants/{applicant_id}/documents/{document_id}	A single document can be retrieved by calling this endpoint with the document’s unique identifier.
findLivePhoto	GET /live_photos/{live_photo_id}	Retrieve live photo
findReport	GET /checks/{check_id}/reports/{report_id}	A single report can be retrieved using this endpoint with the corresponding unique identifier.
findReportTypeGroup	GET /report_type_groups/{report_type_group_id}	Retrieve single report type group object
findWebhook	GET /webhooks/{webhook_id}	Retrieve a Webhook
listApplicants	GET /applicants	List Applicants
listChecks	GET /applicants/{applicant_id}/checks	Retrieve Checks
listDocuments	GET /applicants/{applicant_id}/documents	List documents
listLivePhotos	GET /live_photos	List live photos
listReportTypeGroups	GET /report_type_groups	Retrieve all report type groups
listReports	GET /checks/{check_id}/reports	All the reports belonging to a particular check can be listed from this endpoint.
listWebhooks	GET /webhooks	List webhooks
restoreApplicant	POST /applicants/{applicant_id}/restore	Restore Applicant
resumeCheck	POST /checks/{check_id}/resume	Resume a Check
resumeReport	POST /checks/{check_id}/reports/{report_id}/resume	This endpoint is for resuming individual paused reports.
updateApplicant	PUT /applicants/{applicant_id}	Update Applicant
uploadDocument	POST /applicants/{applicant_id}/documents	Upload a document
uploadLivePhoto	POST /live_photos	Upload live photo

cancelReport

cancelReport(checkId, reportId)

This endpoint is for cancelling individual paused reports.

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String checkId = "checkId_example"; // String | 
String reportId = "reportId_example"; // String | 
try {
    apiInstance.cancelReport(checkId, reportId);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#cancelReport");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
checkId	String
reportId	String

Return type

null (empty response body)

createApplicant

Applicant createApplicant(data)

Create Applicant

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
Applicant data = new Applicant(); // Applicant | 
try {
    Applicant result = apiInstance.createApplicant(data);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#createApplicant");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
data	Applicant		[optional]

Return type

Applicant

createCheck

Check createCheck(applicantId, data)

Create a check

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | 
CheckCreationRequest data = new CheckCreationRequest(); // CheckCreationRequest | 
try {
    Check result = apiInstance.createCheck(applicantId, data);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#createCheck");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String
data	CheckCreationRequest		[optional]

Return type

Check

createWebhook

Webhook createWebhook(data)

Create a webhook

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
Webhook data = new Webhook(); // Webhook | 
try {
    Webhook result = apiInstance.createWebhook(data);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#createWebhook");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
data	Webhook		[optional]

Return type

Webhook

destroyApplicant

destroyApplicant(applicantId)

Delete Applicant

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | 
try {
    apiInstance.destroyApplicant(applicantId);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#destroyApplicant");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String

Return type

null (empty response body)

downloadDocument

File downloadDocument(applicantId, documentId)

Download a documents raw data

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | 
String documentId = "documentId_example"; // String | 
try {
    File result = apiInstance.downloadDocument(applicantId, documentId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#downloadDocument");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String
documentId	String

Return type

File

downloadLivePhoto

File downloadLivePhoto(livePhotoId)

Download live photo

Live photos are downloaded using this endpoint.

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String livePhotoId = "livePhotoId_example"; // String | The live photo’s unique identifier.
try {
    File result = apiInstance.downloadLivePhoto(livePhotoId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#downloadLivePhoto");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
livePhotoId	String	The live photo’s unique identifier.

Return type

File

findAddresses

GenericAddressesList findAddresses(postcode)

Search for addresses by postcode

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String postcode = "postcode_example"; // String | 
try {
    GenericAddressesList result = apiInstance.findAddresses(postcode);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#findAddresses");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
postcode	String

Return type

GenericAddressesList

findApplicant

Applicant findApplicant(applicantId)

Retrieve Applicant

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | 
try {
    Applicant result = apiInstance.findApplicant(applicantId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#findApplicant");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String

Return type

Applicant

findCheck

Check findCheck(applicantId, checkId)

Retrieve a Check

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | 
String checkId = "checkId_example"; // String | 
try {
    Check result = apiInstance.findCheck(applicantId, checkId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#findCheck");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String
checkId	String

Return type

Check

findDocument

Document findDocument(applicantId, documentId)

A single document can be retrieved by calling this endpoint with the document’s unique identifier.

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | 
String documentId = "documentId_example"; // String | 
try {
    Document result = apiInstance.findDocument(applicantId, documentId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#findDocument");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String
documentId	String

Return type

Document

findLivePhoto

LivePhoto findLivePhoto(livePhotoId)

Retrieve live photo

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String livePhotoId = "livePhotoId_example"; // String | The live photo’s unique identifier.
try {
    LivePhoto result = apiInstance.findLivePhoto(livePhotoId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#findLivePhoto");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
livePhotoId	String	The live photo’s unique identifier.

Return type

LivePhoto

findReport

Report findReport(checkId, reportId)

A single report can be retrieved using this endpoint with the corresponding unique identifier.

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String checkId = "checkId_example"; // String | 
String reportId = "reportId_example"; // String | 
try {
    Report result = apiInstance.findReport(checkId, reportId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#findReport");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
checkId	String
reportId	String

Return type

Report

findReportTypeGroup

ReportTypeGroup findReportTypeGroup(reportTypeGroupId)

Retrieve single report type group object

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String reportTypeGroupId = "reportTypeGroupId_example"; // String | 
try {
    ReportTypeGroup result = apiInstance.findReportTypeGroup(reportTypeGroupId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#findReportTypeGroup");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
reportTypeGroupId	String

Return type

ReportTypeGroup

findWebhook

Webhook findWebhook(webhookId)

Retrieve a Webhook

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String webhookId = "webhookId_example"; // String | 
try {
    Webhook result = apiInstance.findWebhook(webhookId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#findWebhook");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
webhookId	String

Return type

Webhook

listApplicants

ApplicantsList listApplicants(page, perPage, includeDeleted)

List Applicants

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
Integer page = 56; // Integer | The page to return. Defaults to the first page if omitted. The first page is `page=1`
Integer perPage = 56; // Integer | The number of objects per page. Defaults to 20 if omitted.
Boolean includeDeleted = true; // Boolean | Whether to also include applicants scheduled for deletion. Defaults to false if omitted.
try {
    ApplicantsList result = apiInstance.listApplicants(page, perPage, includeDeleted);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#listApplicants");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
page	Integer	The page to return. Defaults to the first page if omitted. The first page is `page=1`	[optional]
perPage	Integer	The number of objects per page. Defaults to 20 if omitted.	[optional]
includeDeleted	Boolean	Whether to also include applicants scheduled for deletion. Defaults to false if omitted.	[optional]

Return type

ApplicantsList

listChecks

ChecksList listChecks(applicantId, page, perPage)

Retrieve Checks

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | 
Integer page = 56; // Integer | The page to return. Defaults to the first page if omitted. The first page is `page=1`
Integer perPage = 56; // Integer | The number of objects per page. Defaults to 20 if omitted.
try {
    ChecksList result = apiInstance.listChecks(applicantId, page, perPage);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#listChecks");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String
page	Integer	The page to return. Defaults to the first page if omitted. The first page is `page=1`	[optional]
perPage	Integer	The number of objects per page. Defaults to 20 if omitted.	[optional]

Return type

ChecksList

listDocuments

DocumentsList listDocuments(applicantId)

List documents

All documents belonging to an applicant can be listed from this endpoint

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | 
try {
    DocumentsList result = apiInstance.listDocuments(applicantId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#listDocuments");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String

Return type

DocumentsList

listLivePhotos

LivePhotosList listLivePhotos(applicantId)

List live photos

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | The id of the applicant the live photos belongs to.
try {
    LivePhotosList result = apiInstance.listLivePhotos(applicantId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#listLivePhotos");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String	The id of the applicant the live photos belongs to.

Return type

LivePhotosList

listReportTypeGroups

ReportTypeGroupsList listReportTypeGroups()

Retrieve all report type groups

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
try {
    ReportTypeGroupsList result = apiInstance.listReportTypeGroups();
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#listReportTypeGroups");
    System.err.println(e.getResponseBody());
}

Parameters

This endpoint does not need any parameter.

Return type

ReportTypeGroupsList

listReports

ReportsList listReports(checkId)

All the reports belonging to a particular check can be listed from this endpoint.

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String checkId = "checkId_example"; // String | 
try {
    ReportsList result = apiInstance.listReports(checkId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#listReports");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
checkId	String

Return type

ReportsList

listWebhooks

WebhooksList listWebhooks()

List webhooks

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
try {
    WebhooksList result = apiInstance.listWebhooks();
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#listWebhooks");
    System.err.println(e.getResponseBody());
}

Parameters

This endpoint does not need any parameter.

Return type

WebhooksList

restoreApplicant

restoreApplicant(applicantId)

Restore Applicant

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | 
try {
    apiInstance.restoreApplicant(applicantId);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#restoreApplicant");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String

Return type

null (empty response body)

resumeCheck

resumeCheck(checkId)

Resume a Check

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String checkId = "checkId_example"; // String | 
try {
    apiInstance.resumeCheck(checkId);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#resumeCheck");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
checkId	String

Return type

null (empty response body)

resumeReport

resumeReport(checkId, reportId)

This endpoint is for resuming individual paused reports.

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String checkId = "checkId_example"; // String | 
String reportId = "reportId_example"; // String | 
try {
    apiInstance.resumeReport(checkId, reportId);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#resumeReport");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
checkId	String
reportId	String

Return type

null (empty response body)

updateApplicant

Applicant updateApplicant(applicantId, data)

Update Applicant

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | 
Applicant data = new Applicant(); // Applicant | 
try {
    Applicant result = apiInstance.updateApplicant(applicantId, data);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#updateApplicant");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String
data	Applicant		[optional]

Return type

Applicant

uploadDocument

Document uploadDocument(applicantId, type, side, file)

Upload a document

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.

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | 
String type = "type_example"; // String | 
String side = "side_example"; // String | 
File file = new File("/path/to/file.txt"); // File | 
try {
    Document result = apiInstance.uploadDocument(applicantId, type, side, file);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#uploadDocument");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Notes
applicantId	String
type	String
side	String	[optional]
file	File	[optional]

Return type

Document

uploadLivePhoto

LivePhoto uploadLivePhoto(applicantId, file, advancedValidation)

Upload live photo

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.

Example

// Import classes:
//import com.onfido.ApiClient;
//import com.onfido.ApiException;
//import com.onfido.Configuration;
//import com.onfido.auth.*;
//import com.onfido.api.DefaultApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Token
ApiKeyAuth Token = (ApiKeyAuth) defaultClient.getAuthentication("Token");
Token.setApiKey("token=" + "YOUR API KEY");
Token.setApiKeyPrefix("Token");

DefaultApi apiInstance = new DefaultApi();
String applicantId = "applicantId_example"; // String | The applicant_id to associate the live photo to.
File file = new File("/path/to/file.txt"); // File | The file to be uploaded.
Boolean advancedValidation = true; // Boolean | Validates that the live photo contains exactly one face.
try {
    LivePhoto result = apiInstance.uploadLivePhoto(applicantId, file, advancedValidation);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling DefaultApi#uploadLivePhoto");
    System.err.println(e.getResponseBody());
}

Parameters

Name	Type	Description	Notes
applicantId	String	The applicant_id to associate the live photo to.
file	File	The file to be uploaded.
advancedValidation	Boolean	Validates that the live photo contains exactly one face.	[optional]

Return type

LivePhoto

Uh oh!

FilesExpand file tree

DefaultApi.md

Latest commit

History

DefaultApi.md

File metadata and controls

DefaultApi

cancelReport

Example

Parameters

Return type

createApplicant

Example

Parameters

Return type

createCheck

Example

Parameters

Return type

createWebhook

Example

Parameters

Return type

destroyApplicant

Example

Parameters

Return type

downloadDocument

Example

Parameters

Return type

downloadLivePhoto

Example

Parameters

Return type

findAddresses

Example

Parameters

Return type

findApplicant

Example

Parameters

Return type

findCheck

Example

Parameters

Return type

findDocument

Example

Parameters

Return type

findLivePhoto

Example

Parameters

Return type

findReport

Example

Parameters

Return type

findReportTypeGroup

Example

Parameters

Return type

findWebhook

Example

Parameters

Return type

listApplicants

Example

Parameters

Return type

listChecks

Example

Parameters

Return type

listDocuments

Example

Parameters

Return type