Documents

Endpoints for interacting with documents

Limits

These are the limits for documents in the EyeDP platform.

Accepted document types

BankStatement, Passport, DrivingLicence, Payslip and UtilityBill

File limits

Files has a size limit of 15MB and must be one of jpg, jpeg, png, gif, bmp, tiff, webp or pdf

Upload documents

Upload documents to a case.

Like creating a case this endpoint receives a form data payload. It makes it easy to upload multiple documents at once but can be tricky to get going. You will need to check how to upload form data arrays in your chosen implementation.

Endpoint	/api/cases/{caseId}/documents
Method	POST
Content type	multipart/form-data

Request

Field	Description	Required	Limits
documents[0].type	Type of the document	Yes	See the limits section
documents[0].files	File of the document	Yes	See the limits section

Uploading documents in Postman:

Response

The response contains the ids of the uploaded documents

[
    123,
    124
]

Get document

Gets a document based on it's id. The response includes the extracted information of the document.

Endpoint	/api/cases/{caseId}/documents/{documentId}
Method	GET

Response example

Response of a document while content extraction is in progress

{
    "id": 123,
    "name": "Bank Statement #1",
    "documentType": "BankStatement",
    "extractionStatus": "Pending",
    "extract": {}
}

Response of a document when content extraction has finished

{
    "id": 123,
    "name": "Bank Statement #1",
    "documentType": "BankStatement",
    "extractionStatus": "Completed",
    "extract": {
        "bankStatement": {
            "fullName": "James Smith",
            "address1": "12 Golf Road",
            "address2": "",
            "address6": "Cardiff",
            "address7": "123 123",
            "address8": "GB",
            "periodStartDate": "2025-02-01T00:00:00",
            "periodEndDate": "2025-02-28T00:00:00",
            "openingBalance": 731.62,
            "closingBalance": 1392.29,
            "hasOverdraft": false,
            "bankName": "Monzo",
            "accountNumber": "99999999",
            "sortCode": "00-00-00",
            "currency": "GBP",
            "dailyBalances": [
                {
                    "date": "2025-02-01T00:00:00",
                    "balance": 853.50
                }
            ],
            "transactions": [
                {
                    "date": "2025-02-21T00:00:00",
                    "amount": -19.00,
                    "description": "Netflix subscription",
                    "category": "Entertainment",
                    "balance": 1313.72
                }}
            ]
        }
    }
}