Applications

This page contains information about managing applications/mandates.

Overview

The Applications API is designed to facilitate the management of Verify by Tiller applications and the individuals associated. It offers the following functionality:

• Create an application.

• Retrieve application details.

• Delete the application (and all associated individuals and check data).

• Archive the application (to help with record keeping).

❗The words 'application' and 'mandate' are used interchangeably.

Create application

The Application POST endpoint (/ext/applications) is designed for creating new verification applications. This endpoint initiates the verification process by creating an application and sending email invites to the individuals.

It requires application details, mandate type id (see References section), and information about the individuals. The endpoint ensures that each application is uniquely identified and processed, facilitating a structured and efficient verification workflow.

Creates a new application with one or more individuals specified details. The 'suppress_email_notification' field allows users to suppress all email notifications from Tiller. Set it to true to suppress, or false to allow notifications.

POSThttps://api.tiller-verify.com/api/v1/ext/applications

Authorization

Bearer

Header parameters

Body

application/json

namestring

The name of the application.

Example: "YOUR_APPLICATION_NAME"

referencestring

The unique reference for the mandate.

Example: "MANDATE_REFERENCE"

mandate_typeinteger

The ID of the mandate type.

Example: 1

suppress_email_notificationboolean

If set to true, it will suppress all email communications from Tiller.

Example: false

individualsarray of extapplications_individuals_1 (object)

List of individuals associated with the application.

Response

200

Body

application/json

idID

name*Name

reference*Reference

statusextapplications_status (object)

mandate_type*Mandate_type (object)

archivedArchived

available_actionsarray of inline_response_200_1_available_actions (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.tiller-verify.com/api/v1/ext/applications', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json",
      "Accept": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "name": "text",
  "reference": "text",
  "status": {
    "status": "text"
  },
  "mandate_type": {
    "name": "text",
    "code": "text",
    "description": "text"
  },
  "archived": false,
  "available_actions": [
    {
      "name": "text",
      "title": "text"
    }
  ]
}

Example request data:

application_data = {
        "name": "YOUR_APPLICATION_NAME", # A meaningful application name for your business
        "reference": "MANDATE_REFERENCE", # A unique mandate reference
        "mandate_type": 1, # Update ID from references list for your mandate type
        "individuals": [
            {
                "email": "CUSTOMER_EMAIL",
                "title": "Mr", # See references for full list
                "first_name": "FIRST_NAME",
                "middle_name": "", #Optional
                "last_name": "LAST_NAME",
                "date_of_birth": "1980-12-31", #Optional
                "gender": "male",
                "reference": "REFERENCE001" # A unique reference from your system
            } 
            # Additional individuals can be added to this list.
        ]
    }

Retrieve application

The Retrieve Application Endpoint (/ext/applications/{id}) allows you to fetch detailed information about a specific Verify by Tiller application using its unique identifier. This endpoint is useful in actively in monitoring the progress and status of an application, providing comprehensive insights into the progress of the mobile actions, individual checks, status updates, and other relevant data.

Retrieves details of a specific application identified by its ID.

GEThttps://api.tiller-verify.com/api/v1/ext/applications/{id}

Authorization

Bearer

Path parameters

id*string

Header parameters

Response

200

Body

application/json

idID

name*Name

reference*Reference

status*extapplications_status (object)

mandate_type*Mandate_type (object)

individuals*array of inline_response_200_2_individuals (object)

archivedArchived

available_actionsarray of inline_response_200_1_available_actions (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.tiller-verify.com/api/v1/ext/applications/{id}', {
    method: 'GET',
    headers: {
      "Content-Type": "application/json",
      "Accept": "application/json"
    },
});
const data = await response.json();

Response

200

{
  "name": "text",
  "reference": "text",
  "status": {
    "status": "text"
  },
  "mandate_type": {
    "name": "text",
    "code": "text",
    "description": "text"
  },
  "individuals": [
    {
      "email": "[e-mail]",
      "title": "text",
      "first_name": "text",
      "middle_name": "text",
      "last_name": "text",
      "date_of_birth": "2024-10-22",
      "gender": "male",
      "reference": "text",
      "status": {
        "status": "text"
      },
      "terms_accepted": false,
      "address": {
        "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": "2024-10-22",
        "date_to": "2024-10-22"
      },
      "completed_actions": [
        {
          "name": "text",
          "title": "text"
        }
      ],
      "checks": [
        {
          "status": {
            "status": "text"
          },
          "name": "text",
          "title": "text",
          "individual_checkfield_result": [
            {
              "result": "text"
            }
          ]
        }
      ]
    }
  ],
  "archived": false,
  "available_actions": [
    {
      "name": "text",
      "title": "text"
    }
  ]
}

Complete application

The Complete Application endpoint (/applications/{app_id}/complete) transitions an application from the "in review" status to "completed." This endpoint is used when the verification process for an application has been fully reviewed, or when it is determined that no further action is needed. Once an application is marked as completed it signifies that the verification process has reached its conclusion.

Moves an application from 'in review' to 'completed' status.

PATCHhttps://api.tiller-verify.com/api/v1/applications/{app_id}/complete

Authorization

Bearer

Path parameters

app_id*string

Header parameters

Response

200401404

The application has been successfully completed.

Body

application/json

messagestring

Example: "Application completed"

Request

JavaScriptCurlPython

const response = await fetch('https://api.tiller-verify.com/api/v1/applications/{app_id}/complete', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
});
const data = await response.json();

Response

200

{
  "message": "Application completed"
}

Reject application

The Reject Application endpoint (/applications/{app_id}/reject) is used to reject an application that is currently "in review." This endpoint plays a crucial role when it is determined that the application does not meet the required standards or the associated checks have failed. By rejecting an application, the system ensures that no further processing occurs and that the application is marked as invalid. This also allows tracking of rejected applications for auditing or reporting purposes.

Moves an application from 'in review' to 'rejected' status.

PATCHhttps://api.tiller-verify.com/api/v1/applications/{app_id}/reject

Authorization

Bearer

Path parameters

app_id*string

Header parameters

Response

200401404

The application has been successfully rejected.

Body

application/json

messagestring

Example: "Application rejected"

Request

JavaScriptCurlPython

const response = await fetch('https://api.tiller-verify.com/api/v1/applications/{app_id}/reject', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
});
const data = await response.json();

Response

200

{
  "message": "Application rejected"
}

Delete application

The Delete Application Endpoint (/ext/applications/{id}), accessible via an HTTP DELETE request, enables clients to permanently remove an application using its unique identifier.

This will delete the application and all individual data associated with that application. It ensures clients can efficiently manage their application records, removing those no longer needed or relevant. All applications are automatically deleted after eight weeks as per our privacy policy.

Deletes the application associated with the provided ID.

DELETEhttps://api.tiller-verify.com/api/v1/ext/applications/{id}

Path parameters

id*string

Response

204

Request

JavaScriptCurlPython

const response = await fetch('https://api.tiller-verify.com/api/v1/ext/applications/{id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Archive application

The Archive Application Endpoint (/ext/applications/{id}/archive), which is accessed through an HTTP PATCH request, provides a facility to archive an existing application by its unique identifier.

Archiving an application is a prudent way to manage no longer current records but might be needed for future reference. This functionality helps keep the active application pool manageable and relevant while ensuring that historical data is preserved. Archiving differs from deletion in that it preserves the data rather than removing it, allowing for retrieval and review as usual through the retrieve application endpoint.

Archives the specified application, changing its status but retaining its data.

PATCHhttps://api.tiller-verify.com/api/v1/ext/applications/{id}/archive

Authorization

Bearer

Path parameters

id*string

Header parameters

Body

application/json

object

Response

200

Body

application/json

idID

name*Name

reference*Reference

status*extapplications_status (object)

mandate_type*Mandate_type (object)

individuals*array of inline_response_200_2_individuals (object)

archivedArchived

available_actionsarray of inline_response_200_1_available_actions (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.tiller-verify.com/api/v1/ext/applications/{id}/archive', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json",
      "Accept": "application/json"
    },
});
const data = await response.json();

Response

200

{
  "name": "text",
  "reference": "text",
  "status": {
    "status": "text"
  },
  "mandate_type": {
    "name": "text",
    "code": "text",
    "description": "text"
  },
  "individuals": [
    {
      "email": "[e-mail]",
      "title": "text",
      "first_name": "text",
      "middle_name": "text",
      "last_name": "text",
      "date_of_birth": "2024-10-22",
      "gender": "male",
      "reference": "text",
      "status": {
        "status": "text"
      },
      "terms_accepted": false,
      "address": {
        "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": "2024-10-22",
        "date_to": "2024-10-22"
      },
      "completed_actions": [
        {
          "name": "text",
          "title": "text"
        }
      ],
      "checks": [
        {
          "status": {
            "status": "text"
          },
          "name": "text",
          "title": "text",
          "individual_checkfield_result": [
            {
              "result": "text"
            }
          ]
        }
      ]
    }
  ],
  "archived": false,
  "available_actions": [
    {
      "name": "text",
      "title": "text"
    }
  ]
}

An archived application will have the following attribute:

"archived": True

Accept check

The Accept Check endpoint (/check/{check_id}/accept) allows the manual acceptance of a verification check. This endpoint is used when a check needs to be marked as manually_accepted. This might occur in situations where the system requires human review before finalising the status of a check. Once a check is accepted, its status is updated, and the relevant data is persisted in the system. The process helps ensure that the system can account for exceptions where automated checks may not fully suffice.

The following body is required in the request:

payload = {
    "comment": "This is a comment for the approval of this check",
    "comment_for": "IndividualCheck",
    "reference": 123456
}

Accepts a check, setting its status to 'manually_accepted'.

PATCHhttps://api.tiller-verify.com/api/v1/check/{check_id}/accept

Authorization

Bearer

Path parameters

check_id*string

Header parameters

Body

application/json

commentstring

A comment explaining the reason for accepting the check

Example: "This is a comment for the acceptance of this check"

comment_forstring

The context of the comment, e.g., 'IndividualCheck'

Example: "IndividualCheck"

referenceinteger

The unique reference ID for the check

Example: 123456

Response

200401404

The check has been successfully accepted.

Body

application/json

messagestring

Example: "Check accepted"

Request

JavaScriptCurlPython

const response = await fetch('https://api.tiller-verify.com/api/v1/check/{check_id}/accept', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "message": "Check accepted"
}

Reject check

The Reject Check endpoint (/check/{check_id}/reject) provides the ability to reject a verification check manually. When a check fails or does not meet the required criteria, it can be flagged as manually_rejected through this endpoint. This ensures that the system maintains an accurate log of rejected checks and can trigger any necessary follow-up actions or notifications. By rejecting a check, administrators can control the verification process and ensure that unsuitable individuals are not processed further.

The following body is required in the request:

payload = {
    "comment": "This is a comment for the rejection of this check",
    "comment_for": "IndividualCheck",
    "reference": 123456
}

Rejects a check, setting its status to 'manually_rejected'.

PATCHhttps://api.tiller-verify.com/api/v1/check/{check_id}/reject

Authorization

Bearer

Path parameters

check_id*string

Header parameters

Body

application/json

commentstring

A comment explaining the reason for rejecting the check

Example: "This is a comment for the rejection of this check"

comment_forstring

The context of the comment, e.g., 'IndividualCheck'

Example: "IndividualCheck"

referenceinteger

The unique reference ID for the check

Example: 123456

Response

200401404

The check has been successfully rejected.

Body

application/json

messagestring

Example: "Check rejected"

Request

JavaScriptCurlPython

const response = await fetch('https://api.tiller-verify.com/api/v1/check/{check_id}/reject', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "message": "Check rejected"
}