Ctrlk
Book a DemoVerify Portal
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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
AuthorizationstringRequired
Path parameters
idstringRequired
Header parameters
Content-TypestringRequiredDefault: application/json
AcceptstringRequiredDefault: application/json
Responses
200

Blob file

No content
get/ext/individuals/{id}/report
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
AuthorizationstringRequired
Path parameters
idstringRequired
Header parameters
Content-TypestringRequiredDefault: application/json
AcceptstringRequiredDefault: application/json
Body
objectOptional
Responses
200Success
application/json
idintegerRead-onlyOptional
namestring · min: 1 · max: 150Required
referencestring · max: 150Required
archivedbooleanRead-onlyOptional
post/ext/individuals/{id}/reset
POST /api/v1/ext/individuals/{id}/reset HTTP/1.1
Host: api.tiller-verify.com
Authorization: YOUR_API_KEY
Accept: application/json
Content-Type: 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": "name@gmail.com",
      "title": "text",
      "first_name": "text",
      "middle_name": "text",
      "last_name": "text",
      "date_of_birth": "2026-01-01",
      "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": "2026-01-01",
        "date_to": "2026-01-01"
      },
      "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
AuthorizationstringRequired
Path parameters
idstringRequired
Header parameters
Content-TypestringRequiredDefault: application/json
AcceptstringRequiredDefault: application/json
Responses
200

Blob file

No content
get/ext/individuals/{id}/report
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
AuthorizationstringRequired
Path parameters
idstringRequired
Header parameters
Content-TypestringRequiredDefault: application/json
AcceptstringRequiredDefault: application/json
Body
objectOptional
Responses
201Success
application/json
objectOptional
post/ext/individuals/{id}/invites/resend
POST /api/v1/ext/individuals/{id}/invites/resend HTTP/1.1
Host: api.tiller-verify.com
Authorization: YOUR_API_KEY
Accept: application/json
Content-Type: application/json
Content-Length: 2

{}
201Success
{}

PreviousApplicationsNextReferences

Was this helpful?