Skip to content
For LLMsView as Markdown·

Onfido

Identity verification and KYC checks with document and biometric analysis.

DetailValue
CategoryiGaming
Base URLhttps://api.onfido.com/v3.6
AuthenticationBearer Token
Endpoints6
Connector keyonfido

Using Onfido in a workflow

  1. Go to Connections and click New Connection.
  2. Pick Onfido from the marketplace.
  3. Enter your credentials (see Authentication above for what's expected).
  4. In a workflow, drop an API Call node and select this connection.
  5. Pick the operation you need from the Operation dropdown — the full list is below.

Available endpoints

EndpointSummary
POST /applicantsCreate an applicant
GET /applicants/{applicant_id}Get an applicant
POST /documentsUpload a document
POST /checksCreate a verification check
GET /checks/{check_id}Get check status
GET /reports/{report_id}Get a report

Each endpoint is documented in full below. Use the outline on the right to jump to one.

POST /applicants

Create an applicant

DetailValue
Operation IDkyc.createApplicant
MethodPOST
Path/applicants

Parameters

No parameters.

Request Body

FieldType
first_namestring
last_namestring
emailstring
dobstring

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Onfido connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.createApplicant.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Onfido API reference.

GET /applicants/{applicant_id}

Get an applicant

DetailValue
Operation IDkyc.getApplicant
MethodGET
Path/applicants/{applicant_id}

Parameters

NameLocationTypeRequired
applicant_idpathstringYes

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Onfido connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.getApplicant.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Onfido API reference.

POST /documents

Upload a document

DetailValue
Operation IDkyc.uploadDocument
MethodPOST
Path/documents

Parameters

No parameters.

Request Body

FieldType
applicant_idstring
typestring
filestring

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Onfido connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.uploadDocument.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Onfido API reference.

POST /checks

Create a verification check

DetailValue
Operation IDkyc.createCheck
MethodPOST
Path/checks

Parameters

No parameters.

Request Body

FieldType
applicant_idstring
report_namesarray

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Onfido connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.createCheck.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Onfido API reference.

GET /checks/{check_id}

Get check status

DetailValue
Operation IDkyc.getCheck
MethodGET
Path/checks/{check_id}

Parameters

NameLocationTypeRequired
check_idpathstringYes

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Onfido connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.getCheck.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Onfido API reference.

GET /reports/{report_id}

Get a report

DetailValue
Operation IDkyc.getReport
MethodGET
Path/reports/{report_id}

Parameters

NameLocationTypeRequired
report_idpathstringYes

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Onfido connection from the Connection dropdown.
  3. In the Operation dropdown, select kyc.getReport.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Onfido API reference.