Uploads an identification document

This section is for consuming the W2 Data IDV Check 013 service.

If using W2-DATA-DOCUMENT_CHECK-039 please refer to Document Verification

How to use

To call the endpoint you will need to perform a HTTP POST request to the URL:

Upload Request

Content Type: The document upload endpoint expects the body of requests to be in the form-data format.

These are the properties this endpoint accepts:

ServiceAuthorisation🔒Contains authorisation information to identify the person using the service.
ReferenceContains a client-specified tracking reference. Maximum 100 Characters
Type🔒None - No type specified / known.
JPEG - A JPEG (Joint Picture Experts Group Image).
PNG - A PNG (Portable Network Graphics) image.
PDF - A PDF (Portable Document Format).
Document🔒Base64 Encoded representation of the document to upload.
ExpiryDesired expiry date to apply to the document to upload.

If left blank, W2 will use the default value of 14 days to expire the document. This can be set anywhere up to a maximum of 6 months.

Once the expiration date has been reached, W2 will remove the image data from our system, however the footprint of the upload will be preserved.
QueryOptionsSpecify optional flags that alter the invocation of the service. See here


Document Size Limit

The maximum file size that we accept for a document upload is 15MB, please ensure your documents are no larger than this before uploading.

Upload Response

    "bytesUploaded": 108920,
    "reference": "123",
    "documentTypeValidationSucceeded": true,
    "id": "0e397a02-4b7c-5494-abf0-14e2230be606",
    "resolvedDocumentType": "JPEG"


BytesUploadedThe number of bytes uploaded to check against expected number.
ReferenceAn echo of the value that was used on submission - useful when operating asynchronously.
DocumentTypeValidationSucceededWhether or not the resolved document type matched the type specified by the user (e.g if the user specified the document was a PNG, and the document resolved to a PNG, this value is true).
IdThe system assigned unique Id applied to this document on upload. Used to refer to the document when associating documents with a service as a part of the Files element of a KYC Check request.
ResolvedDocumentTypeThe document type as resolved by the service - this can be compared against the expected (submitted) type for validation purposes.

- None
- No type specified / known.
- JPEG - A JPEG (Joint Picture Experts Group Image).
- PNG - A PNG (Portable Network Graphics) image.
- PDF - A PDF (Portable Document Format)

Click Try It! to start a request and see the response here!