Individuals

This page contains information about managing the participants of the applications.

Overview

The individual APIs focus on managing individual customers associated with an the applications.

The endpoints include:

• Retrieving individual details: Access the data related to a specific individual associated with an application, including personal details, completed mobile actions, and check details.

• Resending invites: Reissue an invitation by generating a new code and sending an email.

• Resetting individual data: Provides the ability to reset an individual. All information provided by the individual and check information will reset, and a new invite will be emailed.

• Generating individual reports: Retrieves the individual's PDF report that contains their information and check data in a structured format. This PDF should be stored on your system as a durable record of the verification results.

These information captured by the individual and the checks performed are determined by the application type they have been added to.

❗Please note that the terms individuals and customer are used interchangeably.

Retrieve Individual

The Retrieve Individual endpoint is primarily used for fetching data about an individual, including personal information, their current status in the application process, the results of any checks conducted, and a record of their accepted terms and conditions.

get

Generates and retrieves a detailed customer report for the specified individual.

Authorizations

Path parameters

idstringRequired

Header parameters

Content-TypestringRequiredDefault: application/json

AcceptstringRequiredDefault: application/json

Responses

200

Blob file

get

HTTPcURLJavaScriptPython

GET /api/v1/ext/individuals/{id}/report HTTP/1.1
Host: api.tiller-verify.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: application/json

200

Blob file

No content

Reset Individual

The Reset Individual endpoint will delete all information captured from the customer and all check data. The customer will also receive an email to confirming the reset with a new invite code.

This endpoint is useful when there is a need to clear previously submitted data for an individual, allowing them to restart or re-engage with the application process from a specific point.

post

Resets all data and status of an individual identified by their ID. A new invite code is emailed to the individual.

Authorizations

Path parameters

idstringRequired

Header parameters

Content-TypestringRequiredDefault: application/json

AcceptstringRequiredDefault: application/json

Body

objectOptional

Responses

200Success

application/json

post

HTTPcURLJavaScriptPython

POST /api/v1/ext/individuals/{id}/reset HTTP/1.1
Host: api.tiller-verify.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: application/json
Content-Length: 2

{}

200Success

{
  "id": 1,
  "name": "text",
  "reference": "text",
  "status": {
    "id": 1,
    "status": "text"
  },
  "mandate_type": {
    "id": 1,
    "name": "text",
    "code": "text",
    "description": "text"
  },
  "individuals": [
    {
      "id": 1,
      "email": "[e-mail]",
      "title": "text",
      "first_name": "text",
      "middle_name": "text",
      "last_name": "text",
      "date_of_birth": "2025-05-16",
      "gender": "male",
      "reference": "text",
      "status": {
        "id": 1,
        "status": "text"
      },
      "terms_accepted": true,
      "address": {
        "id": 1,
        "individual": 1,
        "flat_appartment_subbuilding": "text",
        "building_number": "text",
        "building_name": "text",
        "road_street": "text",
        "district": "text",
        "town_city": "text",
        "state_province_name": "text",
        "state_province_code": "text",
        "country_code": "text",
        "post_zip_code": "text",
        "date_from": "2025-05-16",
        "date_to": "2025-05-16"
      },
      "completed_actions": [
        {
          "id": 1,
          "name": "text",
          "title": "text"
        }
      ],
      "checks_in_review": 1,
      "checks_in_pending": 1,
      "checks_passed": 1,
      "checks": [
        {
          "id": 1,
          "status": {
            "id": 1,
            "status": "text"
          },
          "name": "text",
          "title": "text",
          "individual_checkfield_result": [
            {
              "id": 1,
              "individual": 1,
              "check_field": 1,
              "result": "text",
              "status": 1
            }
          ],
          "instance": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          }
        }
      ]
    }
  ],
  "archived": true,
  "available_actions": [
    {
      "id": 1,
      "name": "text",
      "title": "text"
    }
  ]
}

Retrieve Report

The Retrieve Report endpoint retrieves a detailed PDF report of the individual's application. These reports include the captured personal information, the verification status, the check results and comments collected against the individual. These reports should be downloaded and stored on your system.

❗A report can only be retrieved for an individual that have completed their verification process and are in the 'completed' state.

get

Generates and retrieves a detailed customer report for the specified individual.

Authorizations

Path parameters

idstringRequired

Header parameters

Content-TypestringRequiredDefault: application/json

AcceptstringRequiredDefault: application/json

Responses

200

Blob file

get

HTTPcURLJavaScriptPython

GET /api/v1/ext/individuals/{id}/report HTTP/1.1
Host: api.tiller-verify.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: application/json

200

Blob file

No content

Resend Invite

The Resend Invite endpoint resends invitation emails to individuals who have not yet completed their required mobile actions in the verification process. It serves as a tool for prompting and reminding individuals to complete the required mobile app steps.

Customers can also request a new invite code themselves through the mobile app.

post

Resends an invite code to an individual by email to continue with verification process.

Authorizations

Path parameters

idstringRequired

Header parameters

Content-TypestringRequiredDefault: application/json

AcceptstringRequiredDefault: application/json

Body

objectOptional

Responses

201Success

application/json

Responseobject

post

HTTPcURLJavaScriptPython

POST /api/v1/ext/individuals/{id}/invites/resend HTTP/1.1
Host: api.tiller-verify.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: application/json
Content-Length: 2

{}

201Success

{}