Verify by Tiller API Documentation
  • Getting Started
    • Welcome!
    • Quick Start Guide
    • Data Security
  • Endpoints
    • API Reference
      • Authentication
      • Applications
      • Individuals
      • References
      • Webhooks
    • Error Handling
    • Changelog and Versioning
Powered by GitBook
On this page
  1. Endpoints
  2. API Reference

References

This page contains information about retrieving a set of references and their ID's.

PreviousIndividualsNextWebhooks

Last updated 7 months ago

The References API serves as a central repository for various reference data types for verification. This API provides access to reference information, which are organised into categories. These include:

  • Country: A list of countries and their ISO codes.

  • Document types: These are the available document types that the customer can select as part of the proof of address upload.

  • Industry: A list of selectable industries for your account settings.

  • Individual check field status: Each check can have a set of underlying results. These are represented by the check field results and can have the following status; 'pending', 'accepted', 'rejected'. These underlying results are what determines whether the check has passed or needs to be reviewed.

  • Individual check status: Each check can have the following status; 'pending', 'review', 'accepted', 'manually_accepted' or 'manually_rejected'.

  • Individual status: The progress of the customer completing their mobile app actions. They can be 'pending' or 'completed'. Only 'completed' individuals will have a customer report.

  • Mandate status: The progress of the application. This can be 'new', 'in progress', 'in review', 'completed' or 'rejected'.

  • Mandate type: A list of mandate/application types available. The information gathered and checks completed for the individuals associated with the mandate.

  • Title: The acceptable titles for submitting the customers details as part of the create application process.

get

Lists all reference data categories available in the API, such as mandate types, country codes or document types.

Authorizations
Query parameters
categorystring · enumOptionalPossible values:
Header parameters
Content-TypestringRequiredDefault: application/json
AcceptstringRequiredDefault: application/json
Responses
200Success
application/json
get
GET /api/v1/ext/references HTTP/1.1
Host: api.tiller-verify.com
Authorization: YOUR_API_KEY
Content-Type: text
Accept: text
200Success
[
  {
    "reference_id": 1,
    "name": "text",
    "category": "text",
    "extra": "text"
  }
]