API Reference
Log inSign up
v.1.7.2
v.1.7.2
  • Introduction
  • Integration
  • Sandbox and Live
  • Authentication
  • Rate Limits
  • Service Quota
  • Errors
  • Pagination
  • Filtering
  • Versioning
  • Core resources
  • Clients
    • Create a client
    • Get a client
    • Update a client
    • Delete a client
    • List clients
    • Filtering clients
  • Addresses
    • Create an address
    • Get an address
    • Update an address
    • Delete an address
    • List addresses
    • Filtering addresses
  • Documents
    • Create a document
    • Get a document
    • Update a document
    • Upload image attachment
    • Download image attachment
    • Delete image attachment
    • Delete a document
    • List documents
    • Filtering documents
  • Live Photos
    • Upload a live photo
    • Get a live photo
    • Download live photo
    • Delete a live photo
    • List live photos
  • Checks
    • Create a check
    • Get a check
    • Update a check
    • Validate check outcome
    • List checks
    • Filtering checks
  • Risk Profile
    • Get a risk profile
  • Check types
    • AML Screening Check
    • Document Check
    • Identity Check
  • Other Resources
    • Webhooks
      • Create a webhook
      • Get a webhook
      • Update a webhook
      • Delete a webhook
      • List webhooks
      • Filtering webhooks
    • Reports
      • Generate a client report
      • Generate a check report
    • SDK Tokens
      • Generate a token
    • Team Members
      • Get a team member
      • List team members
      • Filtering team members
    • Audit Logs
      • Get an audit log
      • List audit logs
      • Filtering audit logs
Powered by GitBook
On this page
  • The Document object
  • The image object

Was this helpful?

Documents

Documents can be linked with clients for further checks or for KYC filing purposes.

PreviousFiltering addressesNextCreate a document

Last updated 4 years ago

Was this helpful?

Documents can be created for a given client for the following purposes:

  • Secure and centralised document storage.

  • Perform checks such as and .

The documents API allows you to create, update, retrieve, upload, and delete documents. You can retrieve a specific document as well as a list of all your client's documents.

To upload an image attachment, you first have to object, then .

The Document object

Attribute

Type

Description

id

string

The unique identifier for a document.

clientId

string

The ID of the client associated with this document.

type

string

The type of document. Valid values include:

  1. passport

  2. driving_license

  3. national_insurance_number

  4. social_security_number

  5. tax_identification_numbe

  6. national_identity_card

  7. visa

  8. polling_card

  9. residence_permit

  10. birth_certificate

  11. bank_statement

  12. change_of_name

  13. tax_document

  14. company_confirmation_statement

  15. company_annual_accounts

  16. company_statement_of_capital

  17. company_change_of_address

  18. company_incorporation

  19. company_change_of_officers

  20. company_change_of_beneficial_owners

  21. unknown

  22. other

classification

string

The classification or purpose of this document. Valid values include:

  1. proof_of_identity

  2. source_of_wealth

  3. source_of_funds

  4. proof_of_address

  5. company_filing

  6. other

issuingCountry

string

images

array[object]

createdAt

string

The date and time when the document was created.

updatedAt

string

The date and time when the document was updated.

{
    "id": "5eb1276f96be4a0008713af6",
    "clientId": "5eb1276d96be4a0008713af5",
    "type": "driving_license",
    "classification": "source_of_wealth",
    "issuingCountry": "GB",
    "createdAt": "2020-01-01T14:06:44.756Z",
    "updatedAt": "2020-01-01T14:06:44.756Z"
}

The image object

Attribute

Type

Description

id

string

The unique identifier for a document image attachment.

fileName

string

The file name.

documentSide

string

The side of document: front or back.

downloadLink

string

The download link to the document image.

contentType

string

The content-type of the document image.

size

number

The size of the document image in bytes.

createdAt

string

The date and time when the image was created.

updatedAt

string

The date and time when the image was updated.

The document's issuing country. This will be the .

The images or attachments associated with the document. This will only appear once a document image is uploaded. Also, see below.

two-letter country ISO code
the image object
Document Checks
Identity Checks
upload an image attachment
create a document