NAV
API REFERENCE

API Reference

Welcome to Docsumo API ! You can use this API to access all our API endpoints, such as the Upload API to upload documents, or the Extract Data API to get extracted data.

The API is organized around REST. All requests should be made over SSL. All request and response bodies, including errors, are encoded in JSON.

We also have some specific language bindings to make integration easier. You can switch the programming language of the examples with the tabs in the top right.

Currently, we support the following official client bindings:

To play around with a few examples, we recommend a REST client called Postman. Simply tap the button below to import a pre-made collection of examples.

Docsumo Webapp APIs
run in postamn

Docsumo Financial APIs
run in postamn

Authentication

Docsumo API uses API_KEY to access various endpoints. You can get your endpoint from Docsumo Setting for authentication.

You can pass the token to the API in the HTTP Authorization Header using ‘X-API-KEY’.

Header

Example

Install Docsumo python client before you run python code.
pip install docsumo

The example below is written in curl and python.

curl -X GET \
  https://app.docsumo.com/api/v1/eevee/apikey/limit/ \
  -H 'X-API-KEY: <apikey>' \
from docsumo import Docsumo

docsumo = Docsumo(apikey=<apikey>)
docsumo.user_detail_credit_limit()

Errors

The Docsumo API uses HTTP Status codes to reflect successful and error requests. 2XX status codes represent a successful request, 4XX/5XX status codes represent an error took place. If you receive an error HTTP status code, check the body for an error code and message.

Valid response example

{
    "data": []
    "status": "success",
    "status_code": 200
}

Error response

{
    "status_code": 400,
    "message": "Validation Failed.",
    "error_code": "UNAUTHORIZED" 
}
Status Code Description Most Likely Cause
2XX Successful Request  
400 Bad Request Invalid/missing data
401 Unauthorized Invalid/missing credentials
404 Not Found The resource does not exist, ex. invalid/non-existent user id
409 Conflict Trying to overwrite a resource, ex. when creating a user with an email that already exists
429 Too Many Requests Hit an API rate limit
50X server error We made some mistake. Contact us

Rate Limits

To preserve the integrity and reliability of the platform our APIs have the following rate limits.

All API Endpoints

You can run a max of ten requests per second 10 requests/second unless noted otherwise.

Docsumo Webapp APIs

User Detail

User detail and limit

Get user detail along with the credit limit and usage information.

Definition

GET https://app.docsumo.com/api/v1/eevee/apikey/limit/ 
GET https://app.docsumo.com/api/v1/eevee/apikey/limit/ 

Example

curl -X GET \
  https://app.docsumo.com/api/v1/eevee/apikey/limit/ \
  -H 'X-API-KEY: <apikey>' \
docsumo = Docsumo(apikey=<apikey>)
docsumo.user_detail_credit_limit()

Response of API

{
    "data": {
        "document_types": [
            {
                "title": "Invoice",
                "value": "invoice"
            },
            {
                "title": "Bill of Lading",
                "value": "bill_of_lading"
            }
        ],
        "email": "hello+new_check@docsumo.com",
        "full_name": "tootlip",
        "monthly_doc_current": 7,
        "monthly_doc_limit": 1000,
        "user_id": "5e36961fe1707125e15c20af"
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}
Json Response Detail  
data dict dict of response.
data.document_types list list of document types in user account.
data.document_types[].title string title of document.
data.document_types[].value string internal documents type.
data.email string email of user.
data.full_name string name of user.
data.monthly_doc_current string current number of documents.
data.monthly_doc_limit string monthly documents number limit.
data.user_id internal user id of user.

Upload Documents

Upload files

Upload files from your local machine. Files to be uploaded need to have the document type type assigned to it. Pretrained Models (if exists) for this document type is then used to capture the key-values and tabular data for this document. If you have URL or base64, check Upload files [url and base64]

Definition

POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 
POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 

Example Request

curl -X POST \ 
https://app.docsumo.com/api/v1/eevee/apikey/upload/ \
-H apikey: <apikey> \
-F files=@ \
-F type=<document_type>  \
-F user_doc_id= \
-F doc_meta_data= \
-F review_token= \
import os
import requests

## requests
# path of file
path = 'example.jpg'
filename = os.path.basename(path)
multipart_form_data = {"files": ( filename, open(path, 'rb')),
                        "type": (None, <document_type>)}
headers = {"X-API-KEY": '<apikey>'}

r = requests.post(
    "https://app.docsumo.com/api/v1/eevee/apikey/upload/" ,
    files=multipart_form_data,
    headers=headers,
)

r.json()

Example Response

{
    "data": {
        "document": [
            {
                "created_at": "Sat, 13 Jun 2020 20:14:38 GMT",
                "doc_id": "fffcb91ba02248d78af90d73cc1a6720",
                "email": "bikram.dahal+j14@docsumo.com",
                "review_url": "http://app.docsumo.com/review-document/fffcb91ba02248d78af90d73cc1a6720",
                "status": "new",
                "title": "sample_invoice_docsumo_2-merged.pdf",
                "type": "invoice",
                "user_doc_id": "",
                "user_id": "5ee52bb5cd4b9a1bd51df053"
            }
        ]
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}
Form Arguments  
files required stream of files body.
type required one of the document types value obtained from User detail.
user_doc_id optionalstring unique user_doc_id that can be send and use to track document.
doc_meta_data optionalstring additional metadata to be passed.
review_token optionalboolean generated shareable link by default.
headers (python only) dictionary of credentials (apikey)
Json Response Detail  
data dict dict of response.
data.document list list of uploaded documents detail.
data.document[].doc_id string doc_id, this id is used to make query for all the data associated with this document.
data.document[].email string email of the user.
data.document[].review_url string this url is to review the document in the app.
data.document[].status string status of the document.
data.document[].title string title of the document.
data.document[].type string type of the document.
data.document[].user_id string internal user id of the user.

Upload files [url and base64]

Upload file using URL or base64. Similar to file upload, the document type type needs to be assigned. Pretrained Models (if exists) for this document type is then used to capture the key-values and tabular data for this document.

Definition

POST https://app.docsumo.com/api/v1/eevee/apikey/upload/custom/
POST https://app.docsumo.com/api/v1/eevee/apikey/upload/custom/

Example Request

curl -X POST \ 
https://app.docsumo.com/api/v1/eevee/apikey/upload/custom/ \
-H apikey: <apikey> \
-F file=  \
-F type=<document_type> \
-F user_doc_id= \
-F doc_meta_data= \
-F filename= \
-F file_type=

## requests
# path of file
url = "https://docsumo.com/img/other/logo.png"

multipart_form_data = {"file": (None, url),
                        "type": (None, <document_type>),
                    'filename': (None, <file_name>)}
headers = {"X-API-KEY": <apikey>}

r = requests.post(
    "https://app.docsumo.com/api/v1/eevee/apikey/upload/custom/" ,
    files=multipart_form_data,
    headers=headers,
)
r.json()

Example Response

{
    "data": {
        "document": [
            {
                "created_at": "Sat, 13 Jun 2020 20:14:38 GMT",
                "doc_id": "fffcb91ba02248d78af90d73cc1a6720",
                "email": "bikram.dahal+j14@docsumo.com",
                "review_url": "http://app.docsumo.com/review-document/fffcb91ba02248d78af90d73cc1a6720",
                "status": "new",
                "title": "sample_invoice_docsumo_2-merged.pdf",
                "type": "invoice",
                "user_doc_id": "",
                "user_id": "5ee52bb5cd4b9a1bd51df053"
            }
        ]
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}
Form Arguments  
file required string url of file or base64 of the file.
type required one of the document types value obtained from User detail.
user_doc_id optionalstring unique user_doc_id that can be send and use to track document.
doc_meta_data optionalstring additional metadata to be passed.
filename required string name of the file that it will be save with.
file_type required string specify url or base64 depending on the file.
headers (python only) dictionary of credentials (apikey).
Json Response Detail  
data dict dict of response.
data.document list list of uploaded documents detail.
data.document[].created_at string created date and time.

Document List

Get the detailed list of the documents in your account.

Definition

GET https://app.docsumo.com/api/v1/eevee/apikey/documents/all/?offset=0&sort_by=created_date.desc&limit=1
GET https://app.docsumo.com/api/v1/eevee/apikey/documents/all/?offset=0&sort_by=created_date.desc&limit=1

Example

curl -X GET \
  'https://app.docsumo.com/api/v1/eevee/apikey/documents/all/?offset=0&sort_by=created_date.asc&limit=100&created_date=gte:yyyy-mm-dd&created_date=lte:yyyy-mm-dd&status=' \
  -H 'X-API-KEY: <apikey>' \
docsumo = Docsumo(apikey=<apikey>)
docsumo.documents_list(offset=0, limit=20, status='', created_date_greater_than='', created_date_less_than='')

Response of API

{
    "data": {
        "documents": [
            {
                "converted_to_digital": true,
                "created_at_iso": "2020-07-23T04:15:26+00:00",
                "doc_id": "4c05f77f32d34104b4bd318692386af5",
                "doc_meta_data": "",
                "folder_id": "",
                "folder_name": "",
                "modified_at_iso": "2020-07-23T04:15:26+00:00",
                "preview_image": {
                    "height": 1061,
                    "url": "https://production-docsumo-documents.s3.ap-south-1.amazonaws.com/5c8e98d5e9e9b400093c2f8d/28173/4c05f77f32d34104b4bd318692386af5_thumbnail.jpg",
                    "width": 750
                },
                "review_url": "https://app.docsumo.com/review-document/4c05f77f32d34104b4bd318692386af5",
                "s3_filename": "5c8e98d5e9e9b400093c2f8d/28173/4c05f77f32d34104b4bd318692386af5.png",
                "status": "reviewing",
                "template_doc_id": "4c05f77f32d34104b4bd318692386af5",
                "time_dict": {
                    "processing_time": 35.476734,
                    "total_time": 36.104214
                },
                "title": "test.png",
                "type": "invoice",
                "type_title": "Invoice",
                "uploaded_by": {
                    "avatar_url": "",
                    "email": "bt@gmail.com",
                    "full_name": "Bikram Testing",
                    "user_id": "5c8e98d5e9e9b400093c2f8d"
                },
                "user_doc_id": ""
            }
        ],
        "limit": 1,
        "offset": 0,
        "total": 132
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}
Query Parameters  
offset number starting point of the documents list.
sort_by date sorting by date.
limit number total number of files to show.
created_date date gte:yyyy-mm-dd greater than date range filter.
created_date date lte:yyyy-mm-dd less than date range filter.
status string status of the file.
Json Response Detail  
data dict dict of response.
data.documents list list of documents.
data.documents[].created_at_iso date date on which document was created.
data.documents[].doc_id string document id of the document.
data.documents[].doc_meta_data string metadata that is sent during document upload.
data.documents[].folder_id string folder id of the folder.
data.documents[].folder_name string name of the folder.
data.documents[].modified_at_iso date date on which the document was modified.
data.documents[].preview_image dict dict of document image property.
data.documents[].preview_image{}.height number height of the document image.
data.documents[].preview_image{}.url string url link of the document image.
data.documents[].preview_image{}.width number width of the document image.
data.documents[].review_url string url link of the reviewing document.
data.documents[].s3_filename string name of the document in s3 bucket.
data.documents[].status string status of the document.
data.documents[].template_doc_id string document id of the template document, same as doc_id if no template is found.
data.documents[].time_dict dict dict of the time required details.
data.documents[].time_dict{}.processing_time number time required for processing the document.
data.documents[].time_dict{}.total_time number total time required for the document.
data.documents[].title string name of the document.
data.documents[].type string internal documents type cant change.
data.documents[].type_title string title of the document type cant change.
data.documents[].uploaded_by dict dict of the uploader detail.
data.documents[].uploaded_by{}.avatar_url string url for the avatar of the uploader.
data.documents[].uploaded_by{}.email string email address of the uploader.
data.documents[].uploaded_by{}.full_name string full name of the uploader.
data.documents[].uploaded_by{}.user_id string user id of the uploader.
data.limit string total files to show.
data.offset string files shown from this offset value.
data.total number total number of documents.

Document Detail

Single document detail

Get all the upload detail (metadata) of a single document. In order to get the details, the document id doc_id of the document is required. This can be obtained from the documents list.

Definition

GET https://app.docsumo.com/api/v1/eevee/apikey/documents/detail/<doc_id>/
GET https://app.docsumo.com/api/v1/eevee/apikey/documents/detail/<doc_id>/

Example

curl -X GET \
  'https://app.docsumo.com/api/v1/eevee/apikey/documents/detail/<doc_id>/' \
  -H 'X-API-KEY: <apikey>' \
# We can get the single document details using python requests package.
import requests
headers = {"X-API-KEY": <apikey>}
requests.get("https://app.docsumo.com/api/v1/eevee/apikey/documents/detail/<doc_id>/",headers=headers)

Response of API

{
    "data": {
        "document": {
            "data": {
                "col1": "",
                "col2": "",
                "col3": ""
            },
            "doc_id": "6bcb42576ccc4679b00c23b8a976a6a9",
            "pages": [
                {
                    "id": 1,
                    "image": {
                        "height": 2200,
                        "url": "https://production-docsumo-documents.s3.amazonaws.com/5e9d33e7904eb9b51f19e89a/4701/6bcb42576ccc4679b00c23b8a976a6a9_image.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAXW2HOGPLTCFC5S32%2F20200723%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20200723T061832Z&X-Amz-Expires=43200&X-Amz-SignedHeaders=host&X-Amz-Signature=cdd91f9dbb0a24eab915ab4f35e4d8c2cc3417e4d9a91e7630232be2cd00b268",
                        "width": 1700
                    }
                }
            ],
            "preview_image": {
                "height": 1100,
                "url": "https://production-docsumo-documents.s3.ap-south-1.amazonaws.com/5e9d33e7904eb9b51f19e89a/4701/6bcb42576ccc4679b00c23b8a976a6a9_thumbnail.jpg",
                "width": 850
            },
            "type": "invoice",
            "type_title": "Invoice",
            "uploaded_by": {
                "avatar_url": "",
                "email": "workingtest@email.com",
                "full_name": "Sunil Bista ",
                "user_id": "5e9d33e7904eb9b51f19e89a"
            },
            "user_id": "5e9d33e7904eb9b51f19e89a"
        }
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}
Query Parameters  
apikey string apikey can be found in account settings page.
doc_id string doc_id of the document whose details is required.
Json Response Detail  
data dict dict of response.
data.document dict dict of document data.
data.document.doc_id string document id of the document.
data.document.pages list list of pages in the document.
data.document.pages[].id string id of the document page.
data.document.pages[].image dict dict of image of the page.
data.document.pages[].image{}.height number height of the image of page.
data.document.pages[].image{}.url string url of image of page.
data.document.pages[].image{}.width number width of the image of page.
data.document.preview_image dict dict of the preview image detail of the document.
data.document.preview_image{}.height number height of image of the document.
data.document.preview_image{}.url string url of the image of the document.
data.document.preview_image{}.width number width of the image of the document.
data.document.type string internal document type. can’t change
data.document.type_title string title of the document type. can’t change
data.document.uploaded_by dict dict of the uploader detail.
data.document.uploaded_by{}.avatar_url string url for the avatar of the uploader.
data.document.uploaded_by{}.email string email address of the uploader.
data.document.uploaded_by{}.full_name string full name of the uploader.
data.document.uploaded_by{}.user_id string user id of the uploader.
data.userid string internal user id of user.

Extract data

Obtain the extracted data from the document in JSON format. The key-value or table data extracted from the document either manually or by existing models can be obtained. In order to get the details, the document id doc_id of the document is required. This can be obtained from the documents list.

Definition

GET https://app.docsumo.com/api/v1/eevee/apikey/data/<doc_id>/
GET https://app.docsumo.com/api/v1/eevee/apikey/data/<doc_id>/

Example

curl -X GET \
  'https://app.docsumo.com/api/v1/eevee/apikey/data/<doc_id>/' \
  -H 'X-API-KEY: <apikey>' \
docsumo = Docsumo(apikey=<apikey>)
docsumo.extracted_data(<doc_id>)

Response of API

{
    "data": {
        "Basic Information": {
            "Invoice Number": {
                "model": "template",
                "orig_value": "AEPL/18-19/027",
                "position": [
                    993,
                    192,
                    1179,
                    215
                ],
                "value": "AEPL/18-19/027"
            },
            "Issue Date": {
                "model": "template",
                "orig_value": "DT.31.08.2018",
                "position": [
                    1187,
                    192,
                    1352,
                    215
                ],
                "value": "31/08/2018"
            }
        },
        "Buyer Detail": {
            "Address": {
                "model": "template",
                "orig_value": "SUITE # 219, EDISON,",
                "position": [
                    205,
                    469,
                    468,
                    499
                ],
                "value": "SUITE # 219, EDISON"
            },
            "Name": {
                "model": "template",
                "orig_value": "SLT IMPORTS INC",
                "position": [
                    203,
                    440,
                    415,
                    462
                ],
                "value": "SLT IMPORTS INC"
            }
        },
        "Line Items": [
            {
                "Description": {
                    "orig_value": "",
                    "position": [],
                    "value": ""
                },
                "Quantity": {
                    "orig_value": "",
                    "position": [],
                    "value": ""
                },
                "Subtotal Line": {
                    "orig_value": "",
                    "position": [],
                    "value": ""
                },
                "Tax Rate Line": {
                    "orig_value": "",
                    "position": [],
                    "value": ""
                },
                "Unit Price": {
                    "orig_value": "",
                    "position": [],
                    "value": ""
                }
            },
            {
                "Description": {
                    "orig_value": "KHAZANA SONA MASOORI RICE",
                    "position": [
                        447,
                        843,
                        844,
                        866
                    ],
                    "value": "KHAZANA SONA MASOORI RICE"
                },
                "Quantity": {
                    "orig_value": 10401.0,
                    "position": [
                        1133,
                        840,
                        1202,
                        867
                    ],
                    "value": 10401.0
                },
                "Subtotal Line": {
                    "orig_value": 14435.3,
                    "position": [
                        1475,
                        845,
                        1576,
                        866
                    ],
                    "value": 14435.3
                },
                "Tax Rate Line": {
                    "orig_value": "",
                    "position": [],
                    "value": ""
                },
                "Unit Price": {
                    "orig_value": "",
                    "position": [],
                    "value": ""
                }
            }
        ],
        "Seller Detail": {
            "Address": {
                "model": "template",
                "orig_value": "2A, GRANT LANE, 1ST FLOOR, KOLKATA 700 012 BRANCH : D-374, TTC INDUSTRIAL AREA, MIDC, TURBHE, NAVI MUMBAI - 400703 A/C : RADHE AGRO INDUSTRIES INDIA PVT. LTD. RAICHUR - 584101",
                "position": [
                    198,
                    222,
                    793,
                    401
                ],
                "value": "2A, GRANT LANE, 1ST FLOOR, KOLKATA 700 012 BRANCH : D-374, TTC INDUSTRIAL AREA, MIDC, TURBHE, NAVI MUMBAI - 400703 A/C : RADHE AGRO INDUSTRIES INDIA PVT. LTD. RAICHUR - 584101"
            },
            "Name": {
                "model": "template",
                "orig_value": "ABHAYA EXPORTS (PVT) LTD.",
                "position": [
                    201,
                    190,
                    570,
                    220
                ],
                "value": "ABHAYA EXPORTS (PVT) LTD"
            }
        },
        "Session 06": {
            "Key 01": {
                "model": "",
                "orig_value": "",
                "position": "",
                "value": ""
            }
        },
        "Session 07": [
            {
                "Key 01": {
                    "orig_value": "",
                    "position": "",
                    "value": ""
                },
                "Key 02": {
                    "orig_value": "",
                    "position": "",
                    "value": ""
                }
            }
        ]
    },
    "error": "",
    "error_code": "",
    "message": "",
    "meta_data": {
        "doc_meta_data": "",
        "status": "reviewing",
        "title": "2758.jpg",
        "user_doc_id": null,
        "user_id": "5e9d33e7904eb9b51f19e89a"
    },
    "status": "success",
    "status_code": 200
}
Query Parameters  
apikey string apikey can be found in account settings page.
doc_id string doc_id of the document whose details is required.
Json Response Detail  
data dict dict of response containing the annotation details for each keys.
error string error message.
error_code string error code.
message string details on the error message.
status string document status.
status_code string document status code.
meta_data dict dict of the document metadata.
meta_data{}.doc_meta_data string metadata that is sent during document upload.
meta_data{}.status string status of the document.
meta_data{}.title string name of the document.
meta_data{}.user_doc_id string internal user document id.
meta_data{}.user_id string internal user id of user.

Document Summary

Get the summary of the document types along with the count and status of the documents uploaded in each of the document types.

Definition

GET https://app.docsumo.com/api/v1/mew/apikey/documents/summary/
GET https://app.docsumo.com/api/v1/mew/apikey/documents/summary/

Example

curl -X GET \
  'https://app.docsumo.com/api/v1/mew/apikey/documents/summary/' \
  -H 'X-API-KEY: <apikey>' \
docsumo = Docsumo(apikey=<apikey>)
docsumo.documents_summary()

Response of API

{
    "data": {
        "document": [
            {
                "can_upload": true,
                "default": true,
                "doc_counts": {
                    "all": 5,
                    "processed": 1,
                    "reviewing": 4
                },
                "doc_type": "invoice",
                "id": 1,
                "title": "Invoice",
                "upload_email": "invoice_62c174ee87d1@docs.docsumo.com",
                "user_id": "5e9d33e7904eb9b51f19e89a"
            },
            {
                "can_upload": true,
                "default": true,
                "doc_counts": {
                    "all": 1,
                    "processed": 0,
                    "reviewing": 1
                },
                "doc_type": "passport_front",
                "id": 3,
                "title": "Passport Front",
                "upload_email": "passportfront_f25b3c105b29@docs.docsumo.com",
                "user_id": "5e9d33e7904eb9b51f19e89a"
            }

        ]
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}
Query Parameters  
apikey string apikey can be found in account settings page.
Json Response Detail  
data dict dict of response.
data.document list list of document type data.
data.document[i].can_upload list boolean value if user can upload or not.
data.document[i].default list default value for the document.
data.document[i].doc_counts dict dict of document count.
data.document[i].doc_counts{}.all number number of total document for this document type.
data.document[i].doc_counts{}.processed number number of processed document for this document type.
data.document[i].doc_counts{}.reviewing number number of reviewing document for this document type.
data.document[i].doc_type string type of document.
data.document[i].id number id of the document type.
data.document[i].title string title of the document type.
data.document[i].upload_email email email address where documents can be emailed to get processed under this document type.
data.document[i].user_id user_id interal user id of the user.

Delete Document

Delete the document using the document id Document Id doc_id. This can be obtained from the documents list.

Definition

GET https://app.docsumo.com/api/v1/eevee/apikey/delete/<doc_id>/
GET https://app.docsumo.com/api/v1/eevee/apikey/delete/<doc_id>/

Example

curl -X GET \
  'https://app.docsumo.com/api/v1/eevee/apikey/delete/<doc_id>/' \
  -H 'X-API-KEY: <apikey>' \
docsumo = Docsumo(apikey=<apikey>)
docsumo.delete_documents(<doc_id>)
Query Parameters  
apikey string apikey can be found in account settings page.
doc_id string doc_id of the document whose details is required.
Json Response Detail  
error string error message.
error_code string error code.
message string details on the error message.
status string document status.
status_code string document status code.

Response of API

{
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}
Docsumo Financial APIs

Introduction

Docsumo allows users to extract information from a variety of standard Identification Documents like Passports, Voter IDs, PAN cards, Driving License, Cerificate of Registration and many more.

Allowed file extension

Authentication

Same as Docsumo Web API

Errors

Status Code Error Code Detail
400 WRONG_DOCUMENT_TYPE No text in image or image is too blur to get text.
400 BAD_IMAGE file has bad lighting or has bright spot due to which required data could not be extracted.
400 BLUR_IMAGE image blur and text could not be extracted with high confidence.
400 IMAGE_MISSING_ON_REQUEST file is missing on form body.
400 FILE_TYPE_NOT_SUPPORTED file except png, jpg, jpeg, tiff, pdf.
400 WRONG_SIDE If document has two side and on params wrong side was send.
400 IO_FILE could not open the file, file is corrupted.
400 B_W_IMAGE photocopy of document.
400 SCANNED_IMAGE scan or color photocopy of document.
400 DOCUMENT_CROPPED document is cropped from any side.
400 PHOTO_OF_PHOTO screenshot of pan or photo of photo.
401 UNAUTHORIZED unauthorized access.
401 TOKEN_EXPIRED token used in the request has expired.
402 NO_ENOUGH_CREDIT the allocated credit has expired.
429 TOO_MANY_REQUEST the number of request exceeds the server capacity.

USA Insurance Compliance

Acord 25 COI Form

Extract information from the Acord 25 COI Forms.

Definition

POST https://acord25api.docsumo.com/api/v1/acord25/extract/
POST https://acord25api.docsumo.com/api/v1/acord25/extract/

Example Request

curl -X POST 'https://acord25api.docsumo.com/api/v1/acord25/extract/' \
--header 'X-API-KEY:  <apikey>' \
--form 'files=@/path/to/file'
import requests

url = "https://acord25api.docsumo.com/api/v1/acord25/extract/"

payload = {}
files = [
  ('files', open(<file_path>,'rb'))
]
headers = {
  'X-API-KEY': <apikey>,
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response

{
  "meta_data": {
    "id": "3905d3dd3569419b9b08f3b387590f1c",
    "title": "010436745_1-acfa20f61ab590f13770eb831a4735f7-converted.pdf"
  },
  "message": "",
  "status_code": 200,
  "data": {
    "id": "010436745_1-acfa20f61ab590f13770eb831a4735f7-converted",
    "pages": [
      {
        "page": 1,
        "acordTwentyFiveConfidence": 1,
        "acordVersion": "01/2014",
        "issueDate": "10/02/2015",
        "producer": {
          "companyName": "Peoples United Ins. Agency CT",
          "address": "One Goodwin Square",
          "city": "Hartford",
          "state": "CT",
          "zip": "06103",
          "licenseNumber": "",
          "contactName": "",
          "phone": "860 524-7663",
          "fax": "",
          "emailAddress": ""
        },
        "insurers": [
          {
            "index": "A",
            "companyName": "Hartford Fire Insurance Company",
            "naicNumber": "19682"
          },
          {
            "index": "B",
            "companyName": "Hartford Casualty Insurance Com",
            "naicNumber": "29424"
          },
          {
            "index": "c",
            "companyName": "Trumbull Insurance Company",
            "naicNumber": "27120"
          },
          {
            "index": "D",
            "companyName": "Natl Union Fire Ins. Co of Pit",
            "naicNumber": "19445"
          }
        ],
        "insured": {
          "companyName": "TouchNet Information Systems, Inc",
          "dba": "(Heartiand Payment Systems, Inc.)",
          "address": "15520 College Boulevard",
          "city": "Lenexa",
          "state": "KS",
          "zip": "66219"
        },
        "certificateNumber": "",
        "revisionNumber": "",
        "coverages": [
          {
            "type": "GENt AGGREGATE LIMIT APPLIES PER :",
            "insurerIndex": [
              "A"
            ],
            "typeOfInsurance": {
              "inEffect": "false",
              "claimsMade": "false",
              "occur": "true",
              "COMMERCIAL GENERAL LIABILITY": "true",
              "generalAggregateLimitAppliesPer": {
                "policy": "false",
                "project": "false",
                "location": "true",
                "other": {
                  "enabled": "false"
                }
              }
            },
            "additionalInsured": false,
            "subrogationWaived": false,
            "policies": [
              {
                "number": "O2UUNTD0886",
                "policyEff": "10/01/2015",
                "policyExp": "10/01/2016"
              }
            ],
            "limits": {
              "eachOccurrence": "$1,000,000",
              "damageToRentedPremisesEaOccurrence": "$300,000",
              "medExpAnyOnePerson": "$10,000",
              "personalAndAdvInjury": "$1,000,000",
              "generalAggregate": "$2,000,000",
              "productsCompOpAgg": "$2,000,000"
            }
          },
          {
            "type": "AUTOMOBILE LIABILITY",
            "insurerIndex": [
              "A"
            ],
            "typeOfInsurance": {
              "anyAuto": "false",
              "ownedAutosOnly": "false",
              "hiredAutosOnly": "false",
              "scheduledAutos": "false",
              "nonOwnedAutosOnly": "false",
              "ALL OWNED AUTOS": "false",
              "AUTOS SCHEDULED": "false",
              "HIRED AUTOS": "true",
              "AUTOS NON-OWNED": "true"
            },
            "additionalInsured": false,
            "subrogationWaived": false,
            "policies": [
              {
                "number": "02UUNTD0886",
                "policyEff": "10/01/2015",
                "policyExp": "10/01/2016"
              }
            ],
            "limits": {
              "combinedSingleLimitEaAccident": "$"
            }
          },
          {
            "type": "UMBRELL LIAB",
            "insurerIndex": [
              "B"
            ],
            "typeOfInsurance": {
              "inEffect": "true",
              "occur": "true",
              "excessLiab": "false",
              "claimsMade": "false",
              "ded": "false",
              "retention": "RETENTIONS10,00010,000"
            },
            "additionalInsured": false,
            "subrogationWaived": false,
            "policies": [
              {
                "number": "02RHURO5491",
                "policyEff": "10/01/2015",
                "policyExp": "10/01/2016"
              }
            ],
            "limits": {
              "eachOccurrence": "$25,000,000",
              "generalAggregate": "$25,000,000"
            }
          },
          {
            "type": "AND EMPLOYERS LIABSLITY WORKERS COMPENSATION",
            "insurerIndex": [
              "C"
            ],
            "typeOfInsurance": {
              "anyProprietorPartnerExecutiveOfficerMemeberExcluded": "false"
            },
            "additionalInsured": "false",
            "subrogationWaived": false,
            "policies": [
              {
                "number": "02WECR4310",
                "policyEff": "10/01/2015",
                "policyExp": "10/01/2016"
              }
            ],
            "limits": {
              "E.L DISEASE": "$1,000,000"
            }
          },
          {
            "type": "Professional E&O inct Cyber & Privacy Liability",
            "insurerIndex": [
              "D"
            ],
            "additionalInsured": false,
            "subrogationWaived": false,
            "policies": [
              {
                "number": "013478346",
                "policyEff": "05/31/2015",
                "policyExp": "05/31/2016"
              }
            ],
            "limits": {
              "additionalLimits": []
            }
          }
        ],
        "certificateHolder": [
          {
            "company name": "Stephen F. Austin State University",
            "dba": "Dora Fuselier, Controller",
            "address": "SFA Station",
            "dba address": "Box 13035",
            "city": "Nacogdoches",
            "state": "TX",
            "zip": "75962-3035"
          }
        ],
        "signature": true,
        "cancellation": "SHOULD ANY OF THE ABOVE DESCRIBED POLICIES BE CANCELLED BEFORE THE EXPIRATION DATE THEREOF, NOTICE WILL BE DELIVERED IN ACCORDANCE WITH THE POLICY PROVISIONS."
      }
    ]
  }
}
Status Code Error Code
400 NO_ACCORD
400 EXTRACTION_ISSUE
Form Arguments  
files string path to the file
Json Response Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
meta_data{}.id string id of the document.
meta_data{}.title string name of the document.

Acord 25 COI Form - File Url

Upload Acord 25 COI Form using file url.

Definition

POST https://acord25api.docsumo.com/api/v1/acord25/extract/?request_type=async
POST https://acord25api.docsumo.com/api/v1/acord25/extract/?request_type=async

Example Request

curl -X POST \
  'https://acord25api.docsumo.com/api/v1/acord25/extract/?request_type=async' \
  -H 'X-API-KEY: <apikey> \
  -d '{
    "file_url": "https://test.s3.amazonaws.com/test.pdf",
    "file_name": "test.pdf",
    "uuid": "7bdfdf35-280a-4a43-a72c-1ae3ad577665",
    "webhook_url": "https://hooks.zaiper.com/926792f2-a418-431a-a086-775a489983b9"
}'
import requests

url = "https://acord25api.docsumo.com/api/v1/acord25/extract/?request_type=async"

payload = "{\n    \"file_url\": \"https://test.s3.amazonaws.com/test.pdf?",\n    \"file_name\": \"test.pdf\",\n    \"uuid\": \"7bdfdf35-280a-4a43-a72c-1ae3ad577665\",\n    \"webhook_url\": \"https://hooks.zaiper.com/926792f2-a418-431a-a086-775a489983b9\"\n}"
headers = {
  'X-API-KEY': '<apikey>',
  'Content-Type': 'application/json',
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.json())

Example Response

{
  "meta_data": {
    "id": "3905d3dd3569419b9b08f3b387590f1c",
    "title": "010436745_1-acfa20f61ab590f13770eb831a4735f7-converted.pdf"
  },
  "message": "",
  "status_code": 200,
  "data": {
    "id": "010436745_1-acfa20f61ab590f13770eb831a4735f7-converted",
    "pages": [
      {
        "page": 1,
        "acordTwentyFiveConfidence": 1,
        "acordVersion": "01/2014",
        "issueDate": "10/02/2015",
        "producer": {
          "companyName": "Peoples United Ins. Agency CT",
          "address": "One Goodwin Square",
          "city": "Hartford",
          "state": "CT",
          "zip": "06103",
          "licenseNumber": "",
          "contactName": "",
          "phone": "860 524-7663",
          "fax": "",
          "emailAddress": ""
        },
        "insurers": [
          {
            "index": "A",
            "companyName": "Hartford Fire Insurance Company",
            "naicNumber": "19682"
          },
          {
            "index": "B",
            "companyName": "Hartford Casualty Insurance Com",
            "naicNumber": "29424"
          },
          {
            "index": "c",
            "companyName": "Trumbull Insurance Company",
            "naicNumber": "27120"
          },
          {
            "index": "D",
            "companyName": "Natl Union Fire Ins. Co of Pit",
            "naicNumber": "19445"
          }
        ],
        "insured": {
          "companyName": "TouchNet Information Systems, Inc",
          "dba": "(Heartiand Payment Systems, Inc.)",
          "address": "15520 College Boulevard",
          "city": "Lenexa",
          "state": "KS",
          "zip": "66219"
        },
        "certificateNumber": "",
        "revisionNumber": "",
        "coverages": [
          {
            "type": "GENt AGGREGATE LIMIT APPLIES PER :",
            "insurerIndex": [
              "A"
            ],
            "typeOfInsurance": {
              "inEffect": "false",
              "claimsMade": "false",
              "occur": "true",
              "COMMERCIAL GENERAL LIABILITY": "true",
              "generalAggregateLimitAppliesPer": {
                "policy": "false",
                "project": "false",
                "location": "true",
                "other": {
                  "enabled": "false"
                }
              }
            },
            "additionalInsured": false,
            "subrogationWaived": false,
            "policies": [
              {
                "number": "O2UUNTD0886",
                "policyEff": "10/01/2015",
                "policyExp": "10/01/2016"
              }
            ],
            "limits": {
              "eachOccurrence": "$1,000,000",
              "damageToRentedPremisesEaOccurrence": "$300,000",
              "medExpAnyOnePerson": "$10,000",
              "personalAndAdvInjury": "$1,000,000",
              "generalAggregate": "$2,000,000",
              "productsCompOpAgg": "$2,000,000"
            }
          },
          {
            "type": "AUTOMOBILE LIABILITY",
            "insurerIndex": [
              "A"
            ],
            "typeOfInsurance": {
              "anyAuto": "false",
              "ownedAutosOnly": "false",
              "hiredAutosOnly": "false",
              "scheduledAutos": "false",
              "nonOwnedAutosOnly": "false",
              "ALL OWNED AUTOS": "false",
              "AUTOS SCHEDULED": "false",
              "HIRED AUTOS": "true",
              "AUTOS NON-OWNED": "true"
            },
            "additionalInsured": false,
            "subrogationWaived": false,
            "policies": [
              {
                "number": "02UUNTD0886",
                "policyEff": "10/01/2015",
                "policyExp": "10/01/2016"
              }
            ],
            "limits": {
              "combinedSingleLimitEaAccident": "$"
            }
          },
          {
            "type": "UMBRELL LIAB",
            "insurerIndex": [
              "B"
            ],
            "typeOfInsurance": {
              "inEffect": "true",
              "occur": "true",
              "excessLiab": "false",
              "claimsMade": "false",
              "ded": "false",
              "retention": "RETENTIONS10,00010,000"
            },
            "additionalInsured": false,
            "subrogationWaived": false,
            "policies": [
              {
                "number": "02RHURO5491",
                "policyEff": "10/01/2015",
                "policyExp": "10/01/2016"
              }
            ],
            "limits": {
              "eachOccurrence": "$25,000,000",
              "generalAggregate": "$25,000,000"
            }
          },
          {
            "type": "AND EMPLOYERS LIABSLITY WORKERS COMPENSATION",
            "insurerIndex": [
              "C"
            ],
            "typeOfInsurance": {
              "anyProprietorPartnerExecutiveOfficerMemeberExcluded": "false"
            },
            "additionalInsured": "false",
            "subrogationWaived": false,
            "policies": [
              {
                "number": "02WECR4310",
                "policyEff": "10/01/2015",
                "policyExp": "10/01/2016"
              }
            ],
            "limits": {
              "E.L DISEASE": "$1,000,000"
            }
          },
          {
            "type": "Professional E&O inct Cyber & Privacy Liability",
            "insurerIndex": [
              "D"
            ],
            "additionalInsured": false,
            "subrogationWaived": false,
            "policies": [
              {
                "number": "013478346",
                "policyEff": "05/31/2015",
                "policyExp": "05/31/2016"
              }
            ],
            "limits": {
              "additionalLimits": []
            }
          }
        ],
        "certificateHolder": [
          {
            "company name": "Stephen F. Austin State University",
            "dba": "Dora Fuselier, Controller",
            "address": "SFA Station",
            "dba address": "Box 13035",
            "city": "Nacogdoches",
            "state": "TX",
            "zip": "75962-3035"
          }
        ],
        "signature": true,
        "cancellation": "SHOULD ANY OF THE ABOVE DESCRIBED POLICIES BE CANCELLED BEFORE THE EXPIRATION DATE THEREOF, NOTICE WILL BE DELIVERED IN ACCORDANCE WITH THE POLICY PROVISIONS."
      }
    ]
  }
}

Error

Status Code Error Code
400 NO_ACCORD
400 EXTRACTION_ISSUE
Query Parameter  
request_type string async and sync
Form Arguments  
file_url string url to the file.
file_name string name of the file.
uuid string id of the file.
webhook_url string webhook url to the file.
Json Response Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
meta_data{}.id string id of the document.
meta_data{}.title string name of the document.

Acord 27 COI Form

Extract information from the Acord 27 COI Forms.

Definition

POST https://acord27api.docsumo.com/api/v1/acord27/extract/
POST https://acord27api.docsumo.com/api/v1/acord27/extract/

Example Request

curl -X POST 'https://acord27api.docsumo.com/api/v1/acord27/extract/' \
--header 'X-API-KEY:  <apikey>' \
--form 'files=@/path/to/file'
import requests

url = "https://acord27api.docsumo.com/api/v1/acord27/extract/"

payload = {}
files = [
  ('files', open(<file_path>,'rb'))
]
headers = {
  'X-API-KEY': <apikey>,
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response

{
    "meta_data": {
        "id": "9717a9127e264a56b3f781ca119c78f6",
        "title": "00dcef8f-6b36-44d6-8278-16a711bf078ccontractore784e884-c839-4dfc2.pdf",
        "method": {
            "1": "pdf"
        },
        "dimension": {
            "1": {
                "height": 3301,
                "width": 2550
            }
        }
    },
    "message": "",
    "status_code": 200,
    "data": {
        "id": "00dcef8f-6b36-44d6-8278-16a711bf078ccontractore784e884-c839-4dfc2",
        "pages": [
            {
                "page": 1,
                "acordTwentySevenConfidence": 1,
                "acordVersion": "03/ACORD 27 2016",
                "issueDate": {
                    "text": "6/21/2019"
                },
                "producer": {
                    "companyName": "",
                    "address": "113 Drive Park, P.O. Box 1047",
                    "city": "Albany",
                    "state": "NY",
                    "zip": "11794",
                    "licenseNumber": "",
                    "phone": "6124870120",
                    "fax": "",
                    "emailAddress": ""
                },
                "insured": {
                    "companyName": "EP. Whiteberg & Co., Inc.",
                    "dba": "Mr. Kingslow ",
                    "address": "Five Madison Plaza Ste 530",
                    "city": "Hackensack",
                    "state": "NJ",
                    "zip": "07601"
                },
                "company": {
                    "companyName": "REMCO Company",
                    "address": "1212 Focus Department 2009",
                    "city": "Des Moines",
                    "state": "IA",
                    "zip": "50391-2001"
                },
                "policy": {
                    "policyType": "",
                    "loanNumber": "",
                    "policyNumber": "PW30472312389K",
                    "effectiveDate": "07/01/2018 ",
                    "expirationDate": "07/02/2019 ",
                    "continuedUntilTerminated": false,
                    "evidenceDated": ""
                },
                "property": {
                    "companyName": "",
                    "location": "",
                    "city": "",
                    "state": "",
                    "zip": ""
                },
                "coverages_information": {
                    "perilsInsured": [
                        {
                            "continuedUntil": false
                        },
                        {
                            "basic": false
                        },
                        {
                            "broad": false
                        },
                        {
                            "special": false
                        },
                    ]
                },
                "additionalInterest": [
                    {
                        "MORTGAGEE": false
                    },
                    {
                        "LENDER'S LOSS PAYABLE": false
                    },
                    {
                        "LOSS PAYEE": false
                    },
                    {
                        "MORTGAGEE": false
                    }
                ],
                "nameAndAddress": {
                    "companyName": "Logist Fifth U.S. LP",
                    "address": "7812 Street Suite # 100",
                    "city": "Ontario",
                    "state": "CA",
                    "zip": "91764"
                },
                "signature": {
                    "exists": true
                },
                "loan": {
                    "loanNumber": ""
                },
                "coverages": [
                    {
                        "coverage": "Replacement Cost / Special Form Business Personal Property",
                        "amount_of_insurance": "$270,100",
                        "deductible": "$2,500"
                    },
                    {
                        "coverage": "Ocean Cargo / policy #MASICNY0310US19 / 07-01-2019 to 07-01-2020 Starr Indemnity & Liability Company Cargo Limit",
                        "amount_of_insurance": "$15,000,000",
                        "deductible": "$10,000"
                    }
                ],
                "cancellation": {
                    "text": "SHOULD ANY OF THE ABOVE DESCRIBED POLICIES BE CANCELLED BEFORE THE EXPIRATION DATE THEREOF, NOTICE WILL BE DELIVERED IN ACCORDANCE WITH THE POLICY PROVISIONS."
                },
                "remarks": {
                    "text": "Named Insureds Include : S. Goldberg & Co., Inc. SGI Apparel,Inc. SG Import Services Inc. Rugged Shark, LLC SG Footwear/Messer Group Inc. Re : San Bernardino Distribution Center 2, 311 S. Doolittle Drive, San Bernardino, CA 92408. See Attached..."
                },
                "code": "",
                "sub_code": "",
                "agencyCustomerId": "SGOLD1"
            }
        ]
    }
}
Status Code Error Code
400 NO_ACCORD
400 EXTRACTION_ISSUE
Form Arguments  
files string path to the file
Json Response Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
meta_data{}.id string id of the document.
meta_data{}.title string name of the document.

Acord 28 COI Form

Extract information from the Acord 28 COI Forms.

Definition

POST https://acord28api.docsumo.com/api/v1/acord28/extract/
POST https://acord28api.docsumo.com/api/v1/acord28/extract/

Example Request

curl -X POST 'https://acord28api.docsumo.com/api/v1/acord28/extract/' \
--header 'X-API-KEY:  <apikey>' \
--form 'files=@/path/to/file'
import requests

url = "https://acord28api.docsumo.com/api/v1/acord28/extract/"

payload = {}
files = [
  ('files', open(<file_path>,'rb'))
]
headers = {
  'X-API-KEY': <apikey>,
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response


{
    "meta_data": {
        "id": "8e3c35120c2b407487e1479a43e48cb9",
        "title": "0b0f8f4c-e017-4481-86a8-d7871dda5855contractord132d50a-4079-47454.pdf",
        "method": {
            "1": "pdf"
        },
        "dimension": {
            "1": {
                "height": 3301,
                "width": 2550
            }
        }
    },
    "message": "",
    "status_code": 200,
    "data": {
        "id": "0b0f8f4c-e017-4481-86a8-d7871dda5855contractord132d50a-4079-47454",
        "pages": [
            {
                "page": 1,
                "acordTwentyEightConfidence": 1,
                "acordVersion": "03/2016",
                "issueDate": {
                    "text": "3/3/2020"
                },
                "producer": {
                    "companyName": "Ben  Co.",
                    "dba": "Brokers of CA. Inc. ",
                    "address": "Boulevard Suite 912",
                    "city": "Glendale",
                    "state": "CA",
                    "zip": "91203",
                    "licenseNumber": "98913",
                    "phone": "",
                    "fax": "12851230 ",
                    "emailAddress": "brokersSuit@ajgm"
                },
                "insured": {
                    "companyName": "Top Inc.",
                    "dba": "Top No. 23, LLC",
                    "address": "12 South Euclid",
                    "city": "Pasadena",
                    "state": "CA",
                    "zip": "91101"
                },
                "company": {
                    "companyName": "",
                    "address": "",
                    "city": "",
                    "state": "",
                    "zip": ""
                },
                "policy": {
                    "policyType": "Property",
                    "loanNumber": "",
                    "policyNumber": "See Attached",
                    "effectiveDate": "06/01/2019 ",
                    "expirationDate": "06/01/2020 ",
                    "continuedUntilTerminated": false,
                    "evidenceDated": ""
                },
                "property": {
                    "building": false,
                    "businessPersonalProperty": false,
                    "location": "",
                    "city": "",
                    "state": "",
                    "zip": ""
                },
                "coverages": [
                    {
                        "actual_loss_sustained": true,
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "limit": "",
                        "months": "",
                        "key": "businesIncome",
                        "labels": "BI"
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "limit": "$Incl Above",
                        "key": "blanketCoverage",
                        "labels": "BLANKET COVERAGE"
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "key": "terrorismCoverage",
                        "labels": "TERRORISM COVERAGE",
                        "coverages": [
                            {
                                "yes": false,
                                "no": true,
                                "nan": false,
                                "key": "terrorismSpecificExclusion",
                                "labels": "IS THERE A TERRORISM-SPECIFIC EXCLUSION?"
                            },
                            {
                                "yes": false,
                                "no": true,
                                "nan": false,
                                "key": "domesticTerrorismExcluded",
                                "labels": "IS DOMESTIC TERRORISM EXCLUDED?"
                            }
                        ]
                    },
                    {
                        "yes": false,
                        "no": true,
                        "nan": false,
                        "key": "terrorismSpecificExclusion",
                        "labels": "IS THERE A TERRORISM-SPECIFIC EXCLUSION?"
                    },
                    {
                        "yes": false,
                        "no": true,
                        "nan": false,
                        "key": "domesticTerrorismExcluded",
                        "labels": "IS DOMESTIC TERRORISM EXCLUDED?"
                    },
                    {
                        "yes": false,
                        "no": true,
                        "nan": false,
                        "limit": "",
                        "ded": "",
                        "key": "limitedFungusCoverage",
                        "labels": "LIMITED FUNGUS COVERAGE"
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "key": "fungusExclusion",
                        "labels": "FUNGUS EXCLUSION"
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "key": "replacementCost",
                        "labels": "REPLACEMENT COST"
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "key": "agreedValue",
                        "labels": "AGREED VALUE"
                    },
                    {
                        "yes": false,
                        "no": true,
                        "nan": false,
                        "key": "coinsurance",
                        "labels": "COINSURANCE"
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "limit": "$125,000,000",
                        "ded": "See Attached",
                        "key": "equipmentBreakdown",
                        "labels": "EQUIPMENT BREAKDOWN (IF APPLICABLE)"
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "limit": "Included",
                        "ded": "See Attached",
                        "key": "coverageForLoss",
                        "labels": "COVERAGE FOR LOSS TO UNDAMAGED PORTION OF BLDG"
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "limit": "Included",
                        "ded": "See Attached",
                        "key": "demolitionCosts",
                        "labels": "DEMOLITION COSTS"
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "limit": "Included",
                        "ded": "See Attached",
                        "key": "incrCostOfConstruction",
                        "labels": "INCR. COST OF CONSTRUCTION"
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "limit": "200,000,000",
                        "ded": "See Attached",
                        "key": "earthMovement",
                        "labels": "EARTH MOVEMENT (IF APPLICABLE)"
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "limit": "200,000,000",
                        "ded": "See Attached",
                        "key": "flood",
                        "labels": "FLOOD"
                    },
                    {
                        "yes": "",
                        "no": "",
                        "nan": false,
                        "limit": "Included",
                        "ded": "See Attached",
                        "key": "windHailInc",
                        "labels": "WIND / HAIN INC",
                        "subjectToDifferentProvience": {
                            "yes": "",
                            "no": "",
                            "nan": false,
                            "limit": "Included",
                            "ded": "See Attached"
                        }
                    },
                    {
                        "yes": "",
                        "no": "",
                        "nan": false,
                        "limit": "Included",
                        "ded": "See Attached",
                        "key": "namedStromIncl",
                        "labels": "NAMED STROM INCL",
                        "subjectToDifferentProvience": {
                            "yes": "",
                            "no": "",
                            "nan": false,
                            "limit": "Included",
                            "ded": "See Attached"
                        }
                    },
                    {
                        "yes": true,
                        "no": false,
                        "nan": false,
                        "key": "waiveSubrogation",
                        "labels": "PERMISSION TO WAIVE SUBROGATION IN FAVOR OF MORTGAGE HOLDER PRIOR TO LOSS"
                    },
                    {
                        "key": "ordinanceOrLaw",
                        "label": "ORDINANCE OR LAW",
                        "coverages": [
                            {
                                "yes": true,
                                "no": false,
                                "nan": false,
                                "limit": "Included",
                                "ded": "See Attached",
                                "key": "coverageForLoss",
                                "labels": "COVERAGE FOR LOSS TO UNDAMAGED PORTION OF BLDG"
                            },
                            {
                                "yes": true,
                                "no": false,
                                "nan": false,
                                "limit": "Included",
                                "ded": "See Attached",
                                "key": "demolitionCosts",
                                "labels": "DEMOLITION COSTS"
                            },
                            {
                                "yes": true,
                                "no": false,
                                "nan": false,
                                "limit": "Included",
                                "ded": "See Attached",
                                "key": "incrCostOfConstruction",
                                "labels": "INCR. COST OF CONSTRUCTION"
                            }
                        ]
                    }
                ],
                "additionalInterest": {
                    "contractOfSale": false,
                    "lenderSLossPayable": false,
                    "lossPayee": false,
                    "mortgagee": false,
                    "evidenceOnly": true
                },
                "lenderServiceAgenet": {
                    "companyName": {},
                    "address": {},
                    "city": {},
                    "state": {},
                    "zip": {}
                },
                "nameAndAddress": {
                    "companyName": "Bens SalleLe Lang, Inc.",
                    "address": "Fifth Broadway 203-06",
                    "city": "Cambridge",
                    "state": "MA",
                    "zip": "02142"
                },
                "signature": {
                    "exists": true
                },
                "comercialPropertyCoverageAmountOfInsurance": {
                    "limit": "1500000000 "
                },
                "ded": {
                    "value": "See Attached"
                },
                "cancellation": {
                    "text": "SHOULD ANY OF THE ABOVE DESCRIBED POLICIES BE CANCELLED BEFORE THE EXPIRATION DATE THEREOF, NOTICE WILL BE DELIVERED IN ACCORDANCE WITH THE POLICY PROVISIONS."
                },
                "code": "",
                "sub_code": "",
                "agencyCustomerId": ""
            }
        ]
    }

Status Code Error Code
400 NO_ACCORD
400 EXTRACTION_ISSUE
Form Arguments  
files string path to the file
Json Response Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
meta_data{}.id string id of the document.
meta_data{}.title string name of the document.

Flood Certification

Flood certification is a document issued to certify whether a property is located in a flood zone based on FEMA flood maps.

Definition

POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 
POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 

Example Request

curl -X POST \ 
https://app.docsumo.com/api/v1/eevee/apikey/upload/ \
-H apikey: <apikey> \
-F files=@ \
-F type=flood_certification  \
-F user_doc_id= \
-F doc_meta_data= \
-F review_token= \
import os
import requests

## requests
# path of file
path = 'example.jpg'
filename = os.path.basename(path)
multipart_form_data = {"files": ( filename, open(path, 'rb')),
                        "type": (None, "flood_certification")}
headers = {"X-API-KEY": '<apikey>'}

r = requests.post(
    "https://app.docsumo.com/api/v1/eevee/apikey/upload/" ,
    files=multipart_form_data,
    headers=headers,
)

r.json()

Example Response

{
    "data": {
        "document": [
            {
                "created_at": "Sat, 13 Jun 2020 20:14:38 GMT",
                "doc_id": "fffcb91ba02248d78af90d73cc1a6720",
                "email": "bikram.dahal+j14@docsumo.com",
                "review_url": "http://app.docsumo.com/review-document/fffcb91ba02248d78af90d73cc1a6720",
                "status": "new",
                "title": "sample_invoice_docsumo_2-merged.pdf",
                "type": "invoice",
                "user_doc_id": "",
                "user_id": "5ee52bb5cd4b9a1bd51df053"
            }
        ]
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}

Webhook Response

{
   "meta_data":{
      "title":"sample_flood_certification.pdf",
      "doc_id":"6bc60c941fc34c88ac199f3a6e9f31cd",
      "type":"flood_certification",
      "user_doc_id":null,
      "doc_meta_data":"",
      "folder_name":"",
      "created_at":"2022-08-11T10:34:05+00:00",
      "modified_at":"2022-08-11T10:34:33+00:00",
      "uploaded_from":"dummy",
      "stp":false,
      "review_url":"https://apptesting.docsumo.com/review-document/6bc60c941fc34c88ac199f3a6e9f31cd",
      "user_id":"62f4a9442780aeded1bf4806",
      "org_id":"62f4a9442780aeded1bf4806",
      "status":"processed",
      "approved_with_error":false
   },
   "data":{
      "Basic Information":{
         "OMB Control No":{
            "value":"1234-5678",
            "position":[
               1329,
               121,
               1647,
               149
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Expires":{
            "value":"10/31/18",
            "position":[
               1549,
               149,
               1647,
               177
            ],
            "confidence":1.0,
            "review_required":false
         }
      },
      "Lender Detail":{
         "Customer Number":{
            "value":"1234567890",
            "position":[
               52,
               289,
               175,
               313
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Company Name":{
            "value":"ABC Company",
            "position":[
               52,
               340,
               199,
               365
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Company Address":{
            "value":"123 JOY LANE 5TH FLOOR NORTH HOLLYWOOD, CA, 91605",
            "position":[
               50,
               365,
               400,
               441
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Delivery Method":{
            "value":"ABC-COM - WEB",
            "position":[
               233,
               480,
               409,
               505
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Lender Id":{
            "value":"12345",
            "position":[
               194,
               543,
               255,
               567
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Loan Identifier":{
            "value":"12345",
            "position":[
               653,
               550,
               715,
               575
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Amount of Flood Insurance Required":{
            "value":"",
            "position":[

            ],
            "confidence":0,
            "review_required":true
         }
      },
      "Collateral Detail":{
         "Borrower Name":{
            "value":"XYZ COMPANY",
            "position":[
               638,
               289,
               801,
               313
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Determination Address":{
            "value":"323 HERITAGE ROAD PARKER, SD 12345-6789 AURORA COUNTY",
            "position":[
               638,
               343,
               902,
               421
            ],
            "confidence":1.0,
            "review_required":false
         },
         "APN Tax ID":{
            "value":"12345",
            "position":[
               756,
               431,
               817,
               457
            ],
            "confidence":1.0,
            "review_required":false
         },
         "SD":{
            "value":"15",
            "position":[
               677,
               455,
               702,
               480
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Section":{
            "value":"",
            "position":[

            ],
            "confidence":0,
            "review_required":true
         },
         "Township":{
            "value":"",
            "position":[

            ],
            "confidence":0,
            "review_required":true
         },
         "Lot":{
            "value":"12345",
            "position":[
               1188,
               432,
               1250,
               457
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Phase":{
            "value":"",
            "position":[

            ],
            "confidence":0,
            "review_required":true
         },
         "Range":{
            "value":"",
            "position":[

            ],
            "confidence":0,
            "review_required":true
         },
         "Block":{
            "value":"12345",
            "position":[
               1464,
               432,
               1526,
               457
            ],
            "confidence":1.0,
            "review_required":false
         }
      },
      "NFIP Community Jurisdiction":{
         "NFIP Community Name":{
            "value":"XYZ COMMUNITY",
            "position":[
               188,
               708,
               375,
               733
            ],
            "confidence":1.0,
            "review_required":false
         },
         "County":{
            "value":"LOS ANGELES COUNTY CA",
            "position":[
               633,
               708,
               1078,
               733
            ],
            "confidence":1.0,
            "review_required":false
         },
         "State":{
            "value":"CA",
            "position":[
               1047,
               708,
               1078,
               733
            ],
            "confidence":1.0,
            "review_required":false
         },
         "NFIP Community Number":{
            "value":"111111",
            "position":[
               1314,
               708,
               1388,
               733
            ],
            "confidence":1.0,
            "review_required":false
         }
      },
      "NFIP Data Affecting Building Mobile Home":{
         "NFIP Map Number or Community Panel Number":{
            "value":"01234C1234F",
            "position":[
               221,
               869,
               362,
               894
            ],
            "confidence":1.0,
            "review_required":false
         },
         "NFIP Map Panel Effective Revised Date":{
            "value":"11, 2018",
            "position":[
               774,
               869,
               860,
               894
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Letter of Map Change":{
            "value":false,
            "position":[
               994,
               825,
               1023,
               862
            ],
            "confidence":1,
            "review_required":false
         },
         "Date":{
            "value":"",
            "position":[

            ],
            "confidence":0,
            "review_required":true
         },
         "Case Number":{
            "value":"",
            "position":[

            ],
            "confidence":0,
            "review_required":true
         },
         "Flood Zone":{
            "value":"X",
            "position":[
               311,
               939,
               326,
               963
            ],
            "confidence":1.0,
            "review_required":false
         },
         "No NFIP Map":{
            "value":false,
            "position":[

            ],
            "confidence":0,
            "review_required":true
         }
      },
      "Federal Flood Insurance Availability":{
         "Federal Flood Insurance is available":{
            "value":true,
            "position":[
               87,
               1029,
               114,
               1055
            ],
            "confidence":1,
            "review_required":false
         },
         "Regular Program":{
            "value":true,
            "position":[
               986,
               1023,
               1013,
               1049
            ],
            "confidence":1,
            "review_required":false
         },
         "Emergency Program of NFIP":{
            "value":false,
            "position":[

            ],
            "confidence":0,
            "review_required":true
         },
         "Federal Flood Insurance is not available":{
            "value":false,
            "position":[

            ],
            "confidence":0,
            "review_required":true
         },
         "Federal Flood Insurance may not be available":{
            "value":false,
            "position":[

            ],
            "confidence":0,
            "review_required":true
         }
      },
      "Determination":{
         "IS BUILDING MOBILE HOME IN SPECIAL FLOOD HAZARD AREA":{
            "value":false,
            "position":[
               1548,
               1278,
               1575,
               1303
            ],
            "confidence":1,
            "review_required":false
         }
      },
      "HMDA Information":{
         "HMDA State":{
            "value":"00",
            "position":[
               1497,
               1502,
               1522,
               1527
            ],
            "confidence":1.0,
            "review_required":false
         },
         "HMDA County":{
            "value":"014",
            "position":[
               1485,
               1530,
               1522,
               1555
            ],
            "confidence":1.0,
            "review_required":false
         },
         "MSA MD":{
            "value":"11014",
            "position":[
               1460,
               1558,
               1522,
               1583
            ],
            "confidence":1.0,
            "review_required":false
         },
         "CT":{
            "value":"9039.01",
            "position":[
               1442,
               1586,
               1522,
               1610
            ],
            "confidence":1.0,
            "review_required":false
         }
      },
      "Preparer Information":{
         "Name":{
            "value":"Company Name Pvt. Ltd",
            "position":[
               526,
               1975,
               814,
               2004
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Address":{
            "value":"221B Baker Street Third Floor Buffalo, NY 12345",
            "position":[
               526,
               2005,
               751,
               2095
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Phone":{
            "value":"1.600.873.6640",
            "position":[
               1100,
               2036,
               1254,
               2061
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Fax":{
            "value":"1.600.612.6380",
            "position":[
               1100,
               2066,
               1254,
               2091
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Date of Determination":{
            "value":"December 11, 2010",
            "position":[
               1338,
               1969,
               1534,
               1994
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Order Number":{
            "value":"1090930662",
            "position":[
               1377,
               2058,
               1500,
               2083
            ],
            "confidence":1.0,
            "review_required":false
         }
      },
      "Extra Information":{
         "Certificate Type":{
            "value":"LIFE OF LOAN DETERMINATIO N",
            "position":[
               53,
               1786,
               386,
               1811
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Comments":{
            "value":"Optional Comment",
            "position":[
               51,
               1459,
               353,
               1539
            ],
            "confidence":1.0,
            "review_required":false
         }
      },
      "Error":{
         "Error Message":{
            "value":"",
            "position":[

            ],
            "confidence":1.0,
            "review_required":false
         }
      }
   },
   "error":"",
   "error_code":"",
   "message":"",
   "status":"success",
   "status_code":200,
   "event":"doc_status_change"
}
Form Arguments  
files required stream of files body.
type required one of the document types value obtained from User detail.
user_doc_id optionalstring unique user_doc_id that can be send and use to track document.
doc_meta_data optionalstring additional metadata to be passed.
review_token optionalboolean generated shareable link by default.
headers (python only) dictionary of credentials (apikey)
Json Response Detail  
data dict dict of response.
data.document list list of uploaded documents detail.
data.document[].doc_id string doc_id, this id is used to make query for all the data associated with this document.
data.document[].email string email of the user.
data.document[].review_url string this url is to review the document in the app.
data.document[].status string status of the document.
data.document[].title string title of the document.
data.document[].type string type of the document.
data.document[].user_id string internal user id of the user.
Webhook Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.

USA Tax Returns

W2

Extract information from the W2 Forms.

Definition

POST https://w2forms.docsumo.com/api/v1/w2forms/extract/
POST https://w2forms.docsumo.com/api/v1/w2forms/extract/

Example Request

curl -X POST 'https://w2forms.docsumo.com/api/v1/w2forms/extract/' \
--header 'X-API-KEY:  <apikey>' \
--form 'files=@/path/to/file'
import requests

url = "https://w2forms.docsumo.com/api/v1/w2forms/extract/"

payload = {}
files = [
  ('files', open(<file_path>,'rb'))
]
headers = {
  'X-API-KEY': <apikey>,
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response

{
    "data": {
        "wages_tips_other_compensation": {
            "position": [
                246,
                963,
                404,
                995
            ],
            "value": "137280.24"
        },
        "dependent_care_benefits": {
            "position": [
                444,
                1232,
                768,
                1266
            ],
            "value": ""
        },
        "nonqualified_plans": {
            "position": [
                57,
                1296,
                310,
                1329
            ],
            "value": ""
        },
        "box14a_amount": {
            "position": [
                1895,
                2537,
                1956,
                2569
            ],
            "value": "898.12"
        },
        "box14a_code": {
            "position": [
                1980,
                2537,
                2010,
                2568
            ],
            "value": "CA"
        },
        "state_employers_state_id_number": {
            "position": [
                99,
                1496,
                144,
                1528
            ],
            "value": "CA"
        },
        "state_wages_and_tips": {
            "position": [
                640,
                1496,
                799,
                1529
            ],
            "value": "139180.24"
        },
        "state_income_tax": {
            "position": [
                285,
                1564,
                403,
                1593
            ],
            "value": "8130.01"
        },
        "local_wages_tips": {
            "position": [
                449,
                1563,
                744,
                1592
            ],
            "value": ""
        },
        "local_income_tax": {
            "position": [
                57,
                1623,
                301,
                1648
            ],
            "value": ""
        },
        "federal_income_tax_witheld": {
            "position": [
                488,
                927,
                791,
                994
            ],
            "value": "Federal 23942.68"
        },
        "locality_name": {
            "position": [
                450,
                1628,
                651,
                1658
            ],
            "value": ""
        },
        "social_security_wages": {
            "position": [
                236,
                1034,
                404,
                1068
            ],
            "value": "127200.00"
        },
        "social_security_tax_witheld": {
            "position": [
                668,
                1034,
                791,
                1066
            ],
            "value": "7886.40"
        },
        "medical_wages_and_tips": {
            "position": [
                238,
                1104,
                409,
                1138
            ],
            "value": "15620201"
        },
        "medical_tax_witheld": {
            "position": [
                671,
                1104,
                790,
                1136
            ],
            "value": "2264.93"
        },
        "social_security_tips": {
            "position": [
                100,
                1167,
                316,
                1203
            ],
            "value": ""
        },
        "allocated_tips": {
            "position": [
                454,
                1166,
                646,
                1201
            ],
            "value": ""
        },
        "city_name": {
            "position": [
                96,
                490,
                542,
                530
            ],
            "value": "NEW CENTURY,"
        },
        "control_no": {
            "position": [
                59,
                337,
                250,
                361
            ],
            "value": "0000000398 RD2"
        },
        "eid_no": {
            "position": [
                167,
                893,
                348,
                924
            ],
            "value": "16-1362385"
        },
        "employers_address": {
            "position": [
                96,
                455,
                642,
                490
            ],
            "value": "FOUR NEW CENTURY PARKWAY"
        },
        "employers_name": {
            "position": [
                96,
                420,
                381,
                453
            ],
            "value": "DANISCO US INC"
        },
        "state_name": {
            "position": [
                96,
                490,
                542,
                530
            ],
            "value": "KS"
        },
        "zip_code": {
            "position": [
                96,
                490,
                542,
                530
            ],
            "value": "66031"
        }
    },
    "message": "",
    "meta_data": {
        "id": "108e958b46dc44828cbd43d0f4004297",
        "title": ""
    },
    "status_code": 200
}


Status Code Error Code
400 NO_DATA
400 EXTRACTION_ISSUE
Form Arguments  
files string path to the file
Json Response Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
meta_data{}.id string id of the document.
meta_data{}.title string name of the document.

W9

Extract information from the W9 Forms.

Definition

POST https://w9forms.docsumo.com/api/v1/w9/extract/
POST https://w9forms.docsumo.com/api/v1/w9/extract/

Example Request

curl -X POST 'https://w9forms.docsumo.com/api/v1/w9/extract/' \
--header 'X-API-KEY:  <apikey>' \
--form 'files=@/path/to/file'
import requests

url = "https://w9forms.docsumo.com/api/v1/w9/extract/"

payload = {}
files = [
  ('files', open(<file_path>,'rb'))
]
headers = {
  'X-API-KEY': <apikey>,
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response


{
    "meta_data": {
        "id": "0fcf190ed2cf4986ad6fedd67e143212",
        "title": "C and I Mechanical LLC.pdf",
        "method": {
            "1": "ocr"
        },
        "dimension": {
            "1": {
                "height": 3331,
                "width": 2590
            }
        }
    },
    "message": "",
    "status_code": 200,
    "data": {
        "id": "tmp/0fcf190ed2cf4986ad6fedd67e143212.pdf",
        "pages": [
            {
                "page": 1,
                "w9_confidience": 1,
                "w9_version": "",
                "name": {
                    "value": "Bert Blanchard",
                    "position": [
                        325,
                        387,
                        1606,
                        462
                    ]
                },
                "business_name": {
                    "value": "C AND I Mechanical LLC",
                    "position": [
                        325,
                        479,
                        1139,
                        555
                    ]
                },
                "other_details": {
                    "value": "Sheridan co 80110",
                    "position": [
                        325,
                        941,
                        665,
                        1022
                    ]
                },
                "optional_account_number": {
                    "value": "",
                    "position": [
                        328,
                        1036,
                        823,
                        1068
                    ]
                },
                "date": {
                    "value": "2019/12/09",
                    "position": [
                        1661,
                        2075,
                        2261,
                        2136
                    ]
                },
                "signature": {
                    "value": true,
                    "position": [
                        584,
                        2057,
                        1384,
                        2136
                    ]
                },
                "tax_classification": [
                    {
                        "Limited liability company. Enter the tax classification (C=C corporation, S=S corporation, P=partnership)": {
                            "value": false,
                            "checked_position": [
                                349,
                                690,
                                379,
                                720
                            ],
                            "position": [
                                391,
                                689,
                                1660,
                                723
                            ]
                        }
                    },
                    {
                        "Other (see instructions)": {
                            "value": false,
                            "position": [
                                349,
                                807,
                                380,
                                837
                            ],
                        }
                    },
                    {
                        "single-member LLC": {
                            "value": true,
                            "position": [
                                350,
                                622,
                                379,
                                651
                            ],
                        }
                    },
                    {
                        "C Corporation": {
                            "value": false,
                            "position": [
                                824,
                                623,
                                853,
                                652
                            ],
                        }
                    },
                    {
                        "S Corporation": {
                            "value": false,
                            "position": [
                                1104,
                                624,
                                1134,
                                653
                            ],
                        }
                    },
                    {
                        "Partnership": {
                            "value": false,
                            "position": [
                                1358,
                                624,
                                1387,
                                653
                            ],
                        }
                    },
                    {
                        "Trust/estate": {
                            "value": false,
                            "position": [
                                1639,
                                625,
                                1668,
                                655
                            ],
                        }
                    }
                ]
            }
        ]
    }
}


Status Code Error Code
400 NO_DATA
400 EXTRACTION_ISSUE
Form Arguments  
files string path to the file
Json Response Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
meta_data{}.id string id of the document.
meta_data{}.title string name of the document.

USA CRE Lending

Rent Roll - Multifamily

Rent roll helps landlords track when individual tenants’ rent is due and when it has been collected.

Definition

POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 
POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 

Example Request

curl -X POST \ 
https://app.docsumo.com/api/v1/eevee/apikey/upload/ \
-H apikey: <apikey> \
-F files=@ \
-F type=rent_roll  \
-F user_doc_id= \
-F doc_meta_data= \
-F review_token= \
import os
import requests

## requests
# path of file
path = 'example.pdf'
filename = os.path.basename(path)
multipart_form_data = {"files": ( filename, open(path, 'rb')),
                        "type": (None, "rent_roll")}
headers = {"X-API-KEY": '<apikey>'}

r = requests.post(
    "https://app.docsumo.com/api/v1/eevee/apikey/upload/" ,
    files=multipart_form_data,
    headers=headers,
)

r.json()

Example API Response

{
    "data": {
        "document": [
            {
                "created_at": "Sat, 13 Jun 2020 20:14:38 GMT",
                "doc_id": "fffcb91ba02248d78af90d73cc1a6720",
                "email": "bikram.dahal+j14@docsumo.com",
                "review_url": "http://app.docsumo.com/review-document/fffcb91ba02248d78af90d73cc1a6720",
                "status": "new",
                "title": "sample_rent_roll_docsumo_2-merged.pdf",
                "type": "rent_roll",
                "user_doc_id": "",
                "user_id": "5ee52bb5cd4b9a1bd51df053"
            }
        ]
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}

Example Webhook/Json Response

{
   "meta_data":{
      "title":"abee4bf47d1a4716ac7bc7c792549246.xlsx",
      "doc_id":"7dcbe9210f994e5b860f6dbc35b69879",
      "type":"rent_roll",
      "user_doc_id":null,
      "doc_meta_data":"",
      "folder_name":"",
      "created_at":"2022-08-11T07:15:16+00:00",
      "modified_at":"2022-08-11T07:15:21+00:00",
      "uploaded_from":"web",
      "stp":false,
      "review_url":"https://apptesting.docsumo.com/document-spreadsheet/7dcbe9210f994e5b860f6dbc35b69879",
      "user_id":"62f4a9442780aeded1bf4806",
      "org_id":"62f4a9442780aeded1bf4806",
      "status":"processed",
      "approved_with_error":false
   },
   "data": {
      "Summary": {
            "Unit Count": {
               "value": 3,
               "confidence": 1.0,
               "review_required": false
            },
            "% Occupancy": {
               "value": 100.0,
               "confidence": 1.0,
               "review_required": false
            },
            "Total Rent": {
               "value": 4090.0,
               "confidence": 1.0,
               "review_required": false
            },
            "Total Area": {
               "value": 1218.0,
               "confidence": 1.0,
               "review_required": false
            },
            "Rent Per Sqft": {
               "value": 3.36,
               "confidence": 1.0,
               "review_required": false
            },
            "Average Area": {
               "value": 406.0,
               "confidence": 1.0,
               "review_required": false
            },
            "Average Rent": {
               "value": 1363.33,
               "confidence": 1.0,
               "review_required": false
            },
            "As of Date": {
               "value": "12/07/2021",
               "confidence": 1.0,
               "review_required": false
            }
      },
      "Unit Mix Summary": [
            {
               "Unit Label": {
                  "value": "0.0*1.0",
                  "confidence": 1.0,
                  "review_required": false
               },
               "# of Beds": {
                  "value": "0.0",
                  "confidence": 1.0,
                  "review_required": false
               },
               "# of Baths": {
                  "value": "1.0",
                  "confidence": 1.0,
                  "review_required": false
               },
               "# of Units": {
                  "value": "2",
                  "confidence": 1.0,
                  "review_required": false
               },
               "Avg. Monthly Rent": {
                  "value": "1297.5",
                  "confidence": 1.0,
                  "review_required": false
               },
               "Avg. Sqft.": {
                  "value": "357.0",
                  "confidence": 1.0,
                  "review_required": false
               },
               "Occupancy %": {
                  "value": "100.0",
                  "confidence": 1.0,
                  "review_required": false
               }
            },
            {
               "Unit Label": {
                  "value": "1.0*1.0",
                  "confidence": 1.0,
                  "review_required": false
               },
               "# of Beds": {
                  "value": "1.0",
                  "confidence": 1.0,
                  "review_required": false
               },
               "# of Baths": {
                  "value": "1.0",
                  "confidence": 1.0,
                  "review_required": false
               },
               "# of Units": {
                  "value": "1",
                  "confidence": 1.0,
                  "review_required": false
               },
               "Avg. Monthly Rent": {
                  "value": "1495.0",
                  "confidence": 1.0,
                  "review_required": false
               },
               "Avg. Sqft.": {
                  "value": "504.0",
                  "confidence": 1.0,
                  "review_required": false
               },
               "Occupancy %": {
                  "value": "100.0",
                  "confidence": 1.0,
                  "review_required": false
               }
            }
      ],
      "Occupancy Summary": [
            {
               "Occupancy Status": {
                  "value": "occupied",
                  "confidence": 1.0,
                  "review_required": false
               },
               "# of Units": {
                  "value": "3",
                  "confidence": 1.0,
                  "review_required": false
               },
               "Avg. Sqft.": {
                  "value": "406.0",
                  "confidence": 1.0,
                  "review_required": false
               },
               "Avg. Monthly Rent": {
                  "value": "1363.33",
                  "confidence": 1.0,
                  "review_required": false
               }
            }
      ],
      "cleaned_table": [
            {
               "unit": {
                  "value": "Unit",
                  "confidence": 1.0,
                  "review_required": false
               },
               "building_id": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "floor_plan": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "unit_type": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "bedroom": {
                  "value": "bedroom",
                  "confidence": 1.0,
                  "review_required": false
               },
               "bathroom": {
                  "value": "bathroom",
                  "confidence": 1.0,
                  "review_required": false
               },
               "sq_ft": {
                  "value": "Sq. Ft.",
                  "confidence": 1.0,
                  "review_required": false
               },
               "status": {
                  "value": "Status",
                  "confidence": 1.0,
                  "review_required": false
               },
               "tenant_name": {
                  "value": "Tenant",
                  "confidence": 1.0,
                  "review_required": false
               },
               "move_in": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "move_out": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "lease_start": {
                  "value": "Lease From",
                  "confidence": 1.0,
                  "review_required": false
               },
               "lease_end": {
                  "value": "Lease To",
                  "confidence": 1.0,
                  "review_required": false
               },
               "market_rent": {
                  "value": "Market Rent",
                  "confidence": 1.0,
                  "review_required": false
               },
               "monthly_rent": {
                  "value": "Rent",
                  "confidence": 1.0,
                  "review_required": false
               },
               "charge_codes": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "total_charges": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "deposit": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "balance": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "occupancy": {
                  "value": "occupancy",
                  "confidence": 1.0,
                  "review_required": false
               }
            },
            {
               "unit": {
                  "value": "1",
                  "confidence": 1.0,
                  "review_required": false
               },
               "building_id": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "floor_plan": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "unit_type": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "bedroom": {
                  "value": 0.0,
                  "confidence": 1.0,
                  "review_required": false
               },
               "bathroom": {
                  "value": 1.0,
                  "confidence": 1.0,
                  "review_required": false
               },
               "sq_ft": {
                  "value": 357.0,
                  "confidence": 1.0,
                  "review_required": false
               },
               "status": {
                  "value": "Current",
                  "confidence": 1.0,
                  "review_required": false
               },
               "tenant_name": {
                  "value": "Jur\u0123is Ragnar Thrussell",
                  "confidence": 1.0,
                  "review_required": false
               },
               "move_in": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "move_out": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "lease_start": {
                  "value": "07/16/2018",
                  "confidence": 1.0,
                  "review_required": false
               },
               "lease_end": {
                  "value": "02/28/2022",
                  "confidence": 1.0,
                  "review_required": false
               },
               "market_rent": {
                  "value": 1295.0,
                  "confidence": 1.0,
                  "review_required": false
               },
               "monthly_rent": {
                  "value": 1250.0,
                  "confidence": 1.0,
                  "review_required": false
               },
               "charge_codes": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "total_charges": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "deposit": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "balance": {
                  "value": "",
                  "confidence": 1.0,
                  "review_required": false
               },
               "occupancy": {
                  "value": "occupied",
                  "confidence": 1.0,
                  "review_required": false
               }
            },

      ]
   },
   "error":"",
   "error_code":"",
   "message":"",
   "status":"success",
   "status_code":200,
   "event":"doc_status_change"
}

Fields extracted from Rent roll

fields Description
unit Unit Number of property
building_id Building ID of property
floor_plan Floor plan of property
unit_type Unit type of property
bedrooms Number of bedrooms in the property
bathrooms Number of bathrooms in the property
sq_ft Area of the Property in sq-ft
status Status of property
tenant_name Name of the Tenant
move_in Move in date of rentor
move_out Move out date of rentor
lease_start Lease start date of rentor
lease_end Lease end date of rentor
market_rent Market rent of property
monthly_rent Monthly rent of property
charge_codes Charge Codes
total_charges Total charges associated with the property
phone Phone Number of the Tenant
deposit Deposit amount associated with the property
balance Balance associated with the property
security_deposit Security Deposit associated with the property
sqft Area of the Property in sq ft
last_rent_increase_date Last Rent Increase date
last_rent_increase_amount Last rent increase amount
Form Arguments  
files required stream of files body.
type required one of the document types value obtained from User detail.
user_doc_id optionalstring unique user_doc_id that can be send and use to track document.
doc_meta_data optionalstring additional metadata to be passed.
review_token optionalboolean generated shareable link by default.
headers (python only) dictionary of credentials (apikey)
API Response Detail  
data dict dict of response.
data.document list list of uploaded documents detail.
data.document[].doc_id string doc_id, this id is used to make query for all the data associated with this document.
data.document[].email string email of the user.
data.document[].review_url string this url is to review the document in the app.
data.document[].status string status of the document.
data.document[].title string title of the document.
data.document[].type string type of the document.
data.document[].user_id string internal user id of the user.
Webhook Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
status_code int status code of response.
event (webhook only) trigger event of webhook.

Profit and Loss Statement

Profit and Loss refers to a financial statement that summarizes the revenues, costs, and expenses incurred during a specified period

Definition

POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 
POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 

Example Request

curl -X POST \ 
https://app.docsumo.com/api/v1/eevee/apikey/upload/ \
-H apikey: <apikey> \
-F files=@ \
-F type=p_and_l  \
-F user_doc_id= \
-F doc_meta_data= \
-F review_token= \
import os
import requests

## requests
# path of file
path = 'example.pdf'
filename = os.path.basename(path)
multipart_form_data = {"files": ( filename, open(path, 'rb')),
                        "type": (None, "p_and_l")}
headers = {"X-API-KEY": '<apikey>'}

r = requests.post(
    "https://app.docsumo.com/api/v1/eevee/apikey/upload/" ,
    files=multipart_form_data,
    headers=headers,
)

r.json()

Example API Response

{
    "data": {
        "document": [
            {
                "created_at": "Sat, 13 Jun 2020 20:14:38 GMT",
                "doc_id": "fffcb91ba02248d78af90d73cc1a6720",
                "email": "bikram.dahal+j14@docsumo.com",
                "review_url": "http://app.docsumo.com/review-document/fffcb91ba02248d78af90d73cc1a6720",
                "status": "new",
                "title": "sample_pnl_docsumo_2-merged.pdf",
                "type": "p_and_l",
                "user_doc_id": "",
                "user_id": "5ee52bb5cd4b9a1bd51df053"
            }
        ]
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}

Example Webhook/Json Response

{
   "data":[
      {
         "category":"income",
         "coa_category":"Income",
         "coa_subcategory1":"Sales",
         "coa_subcategory2":"Sales Of Product",
         "description":"Sales",
         "id":"0",
         "row_type":"transaction_line",
         "subcategory1":"",
         "subcategory2":"",
         "subcategory3":"",
         "total":196442.24,
         "value":{
            "April 2021":41341.97,
            "February 2021":16545.89,
            "March 2021":138554.38
         }
      },
      {
         "category":"income",
         "coa_category":"Income",
         "coa_subcategory1":"Other Income",
         "coa_subcategory2":"Miscellaneous Other Income",
         "description":"Uncategorized Income",
         "id":"1",
         "row_type":"transaction_line",
         "subcategory1":"",
         "subcategory2":"",
         "subcategory3":"",
         "total":0,
         "value":{
            "April 2021":0,
            "February 2021":0,
            "March 2021":0
         }
      },
      {
         "category":"income",
         "coa_category":"Total",
         "coa_subcategory1":"Total",
         "coa_subcategory2":"Total",
         "description":"Total Income",
         "id":"2",
         "row_type":"total_line",
         "subcategory1":"",
         "subcategory2":"",
         "subcategory3":"",
         "total":28705,
         "value":{
            "April 2021":845.61,
            "February 2021":26545.89,
            "March 2021":1313.5
         }
      }
   ],
   "meta_data":{
      "approved_with_error":false,
      "created_at":"2022-09-20T11:28:09+00:00",
      "doc_id":"3fcd4c96f57941b0b7522b9042c4b554",
      "doc_meta_data":"",
      "folder_name":"",
      "modified_at":"2022-09-20T11:52:56+00:00",
      "org_id":"62d14d6e5131fd5183f2751d",
      "review_url":"https://app.docsumo.com/document-spreadsheet/3fcd4c96f57941b0b7522b9042c4b554",
      "status":"processed",
      "stp":false,
      "title":"sample_pnl.pdf",
      "type":"p_and_l",
      "uploaded_from":"web",
      "user_doc_id":null,
      "user_id":"62d14d6e5131fd5183f2751d"
   },
   "error":"",
   "error_code":"",
   "message":"",
   "status":"success",
   "status_code":200,
   "event":"doc_status_change"
}

COA Categories For CRE

COA_Category COA_Subcategory1 COA_Subcategory2
Expense Other Expense Other expenses
Expenses General And Administrative Advertising And Marketing
Expenses General And Administrative Leasing
Expenses Excluded Expenses Excluded Expenses
Expenses General And Administrative Travel Or Meals And Entertainment
Expenses General And Administrative Office Expenses
Expenses General And Administrative Interest Paid
Expenses General And Administrative Managment Fees
Expenses General And Administrative Other Taxes Or Assmnts
Expenses General And Administrative Office Expenses
Expenses General And Administrative Insurance
Expenses Payroll And Benefits Salaries
Expenses Payroll And Benefits Payroll Taxes And Benefits
Expenses Professional Fees Professional Fees
Expenses Rental Expenses Rent
Expenses Repairs And Maintainance Building Repairs And Maintainance
Expenses Repairs And Maintainance Cleaning Or Turnover
Expenses Repairs And Maintainance Landscaping And Grounds
Expenses Utilities Energy
Expenses Utilities Fuel Or Gas
Expenses Utilities Trash Removal
Expenses Utilities Water And Sewer
Expenses Utilities Cabel And Internet
Expenses Utilities General Utilities
Income Rental Income Commercial Income
Income Excluded Income Excluded Income
Income Concessions Concessions
Income Laundry Or Vending Income Laundry Or Vending Income
Income Other Income Other Income
Income Sales Sales Of Product
Income Sales Sales Tax And Ammonts
Income Vacancy And Collection Loss Vacancy
Income Vacancy And Collection Loss Bad Debts
Total Total Total
Net Operating Income Net Operating Income Net Operating Income

COA Categories For Business

COA_Category COA_Subcategory1 COA_Subcategory2
Expenses Cost Of Sales Labour
Expenses Cost Of Sales Manufacturing Distribution
Expenses Cost Of Sales Materials
Expenses Cost Of Sales Other Cost Of Sales
Expenses Non Operating Expenses Interests Paid
Expenses Non Operating Expenses Other Non Operating Expenses
Expenses Non Operating Expenses Professional Fees
Expenses Operating Expenses Allowances and Benefits
Expenses Operating Expenses Amortization
Expenses Operating Expenses Bank Charges
Expenses Operating Expenses Building Rent Lease
Expenses Operating Expenses Contract Services
Expenses Operating Expenses Cost Of Good sold
Expenses Operating Expenses Customer Aquisition Cost
Expenses Operating Expenses Depreciation Depletion
Expenses Operating Expenses Employee Stock Compensation
Expenses Operating Expenses Employee Wages
Expenses Operating Expenses Entertainment
Expenses Operating Expenses General And Administration Cost
Expenses Operating Expenses Insurance
Expenses Operating Expenses License Or Permits
Expenses Operating Expenses Marketing
Expenses Operating Expenses Other Operating Expenses
Expenses Operating Expenses Repairs Maintenance
Expenses Operating Expenses Research And Development
Expenses Operating Expenses Salaries
Expenses Operating Expenses Software
Expenses Operating Expenses Subscription Fees
Expenses Operating Expenses Taxes
Expenses Operating Expenses Travel
Expenses Operating Expenses Utilities
Income Non Operating Income Interest
Income Non Operating Income Other Non Operating Income
Income Operating Income General Services
Income Operating Income Non Recurring Income
Income Operating Income Products Merchandise
Income Operating Income Recurring Income
Total Total Total
Form Arguments  
files required stream of files body.
type required one of the document types value obtained from User detail.
user_doc_id optionalstring unique user_doc_id that can be send and use to track document.
doc_meta_data optionalstring additional metadata to be passed.
review_token optionalboolean generated shareable link by default.
headers (python only) dictionary of credentials (apikey)
API Response Detail  
data dict dict of response.
data.document list list of uploaded documents detail.
data.document[].doc_id string doc_id, this id is used to make query for all the data associated with this document.
data.document[].email string email of the user.
data.document[].review_url string this url is to review the document in the app.
data.document[].status string status of the document.
data.document[].title string title of the document.
data.document[].type string type of the document.
data.document[].user_id string internal user id of the user.
Webhook Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.

Balance Sheet

The balance sheet refers to a financial statement that reports a company\‘s assets, liabilities, and shareholder equity at a specific point in time. Balance sheets provide the basis for computing rates of return for investors and evaluating a company\’s capital structure.

Definition

POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 
POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 

Example Request

curl -X POST \ 
https://app.docsumo.com/api/v1/eevee/apikey/upload/ \
-H apikey: <apikey> \
-F files=@ \
-F type=balance_sheet  \
-F user_doc_id= \
-F doc_meta_data= \
-F review_token= \
import os
import requests

## requests
# path of file
path = 'example.pdf'
filename = os.path.basename(path)
multipart_form_data = {"files": ( filename, open(path, 'rb')),
                        "type": (None, "balance_sheet")}
headers = {"X-API-KEY": '<apikey>'}

r = requests.post(
    "https://app.docsumo.com/api/v1/eevee/apikey/upload/" ,
    files=multipart_form_data,
    headers=headers,
)

r.json()

Example API Response

{
    "data": {
        "document": [
            {
                "created_at": "Sat, 13 Jun 2020 20:14:38 GMT",
                "doc_id": "fffcb91ba02248d78af90d73cc1a6720",
                "email": "test@docsumo.com",
                "review_url": "http://app.docsumo.com/review-document/fffcb91ba02248d78af90d73cc1a6720",
                "status": "new",
                "title": "sample_pnl_docsumo_2-merged.pdf",
                "type": "p_and_l",
                "user_doc_id": "",
                "user_id": "5ee52bb5cd4b9a1bd51df053"
            }
        ]
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}

Example Webhook/Json Response

{
    "7218bb366a174433b95b9364656c68fb": {
        "meta_data": {
            "title": "sample_balance_sheet.pdf",
            "doc_id": "7218bb366a174433b95b9364656c68fb",
            "type": "balance_sheet",
            "uploaded_from": "dummy",
            "user_doc_id": null,
            "doc_meta_data": "",
            "folder_name": "",
            "created_at_iso": "2022-12-02T12:18:24+00:00",
            "modified_at_iso": "2022-12-02T12:18:34+00:00",
            "status": "reviewing",
            "review_url": "https://apptesting.docsumo.com/document-spreadsheet/7218bb366a174433b95b9364656c68fb"
        },
        "data": [
            {
                "id": "0",
                "description": "Checking",
                "value": {
                    "Total": 25000.0
                },
                "total": 25000.0,
                "row_type": "transaction_line",
                "coa_category": "Assets",
                "coa_subcategory1": "Cash And Financial Assets",
                "coa_subcategory2": "Additional Financial Assets And Investments",
                "category": "assets",
                "subcategory1": "bank accounts",
                "subcategory2": "",
                "subcategory3": ""
            },
            {
                "id": "1",
                "description": "Savings",
                "value": {
                    "Total": 45000.0
                },
                "total": 45000.0,
                "row_type": "transaction_line",
                "coa_category": "Assets",
                "coa_subcategory1": "Cash And Financial Assets",
                "coa_subcategory2": "Financial Assets Investments",
                "category": "assets",
                "subcategory1": "bank accounts",
                "subcategory2": "",
                "subcategory3": ""
            },
            {
                "id": "2",
                "description": "Total Bank Accounts",
                "value": {
                    "Total": 70000.0
                },
                "total": 70000.0,
                "row_type": "total_line",
                "coa_category": "Total",
                "coa_subcategory1": "Total",
                "coa_subcategory2": "Total",
                "category": "assets",
                "subcategory1": "bank accounts",
                "subcategory2": "",
                "subcategory3": ""
            },
            {
                "id": "3",
                "description": "Accounts Receivable",
                "value": {
                    "Total": 15000.0
                },
                "total": 15000.0,
                "row_type": "transaction_line",
                "coa_category": "Assets",
                "coa_subcategory1": "Receivables And Contracts",
                "coa_subcategory2": "Accounts Notes And Loans Receivable",
                "category": "assets",
                "subcategory1": "",
                "subcategory2": "",
                "subcategory3": ""
            },
            {
                "id": "4",
                "description": "Equipment",
                "value": {
                    "Total": 5000.0
                },
                "total": 5000.0,
                "row_type": "transaction_line",
                "coa_category": "Assets",
                "coa_subcategory1": "Property Plant And Equipment",
                "coa_subcategory2": "Machinery And Equipment",
                "category": "assets",
                "subcategory1": "fixed assets",
                "subcategory2": "",
                "subcategory3": ""
            },
            {
                "id": "5",
                "description": "Furniture",
                "value": {
                    "Total": 1250.0
                },
                "total": 1250.0,
                "row_type": "transaction_line",
                "coa_category": "Assets",
                "coa_subcategory1": "Property Plant And Equipment",
                "coa_subcategory2": "Furniture And Fixtures",
                "category": "assets",
                "subcategory1": "fixed assets",
                "subcategory2": "",
                "subcategory3": ""
            }

        ]
    }
}

COA Categories

COA_Subcategory COA_Subcategory1 COA_SubCategroy2
Assets Current Assets Accounts Notes And Loans Receivable
Assets Current Assets Bank Accounts
Assets Current Assets Cash And Cash Equivalents
Assets Current Assets Inventory
Assets Current Assets Invested Cash
Assets Current Assets Other Current Assets
Assets Current Assets Other debtors
Assets Current Assets Prepayments
Assets Current Assets Receivables And Contracts
Assets Current Assets Stock
Assets Current Assets Tax Recoverable
Assets Current Assets Trade Debtors
Assets Fixed and Non-Current Assets Accumulated Amortization
Assets Fixed and Non-Current Assets Accumulated Depreciation
Assets Fixed and Non-Current Assets Capitalised Lease
Assets Fixed and Non-Current Assets Due from Group
Assets Fixed and Non-Current Assets Investment in Group Cos
Assets Fixed and Non-Current Assets Land/Building
Assets Fixed and Non-Current Assets Long Term Investments
Assets Fixed and Non-Current Assets Machinery/Equipment
Assets Fixed and Non-Current Assets Other Assets
Assets Intangible Assets Acquisition In Progress
Assets Intangible Assets Computer Software
Assets Intangible Assets Contracts And Rights
Assets Intangible Assets Intellectual Property
Assets Intangible Assets Other Intangible Assets
Assets Intangible Assets Right To Use Assets
Assets Intangible Assets Trade And Distribution Assets
Assets Other Assets Other Assets
Equity Equity Reserves
Equity Equity Current Earnings
Equity Equity Shares
Equity Equity Owners Equity Accounts
Equity Equity Paid in Capital
Equity Equity Profit & Loss Account
Equity Equity Retained Earnings
Equity Equity Shareholder distribution
Equity Equity Shareholders Equity
Equity Equity Other Equity
Liabilities Accruals And Other Liabilities Accrued Expenses Including Payroll
Liabilities Accruals And Other Liabilities Accrued Taxes Other Than Payroll
Liabilities Accruals And Other Liabilities Other Liabilities
Liabilities Current Liabilities Accounts Payable
Liabilities Current Liabilities Accrued Expenses Including Payroll
Liabilities Current Liabilities Accrued Taxes Other Than Payroll
Liabilities Current Liabilities Bank O/D
Liabilities Current Liabilities Credit Cards
Liabilities Current Liabilities Directors Loans
Liabilities Current Liabilities Dividends Payable
Liabilities Current Liabilities Other Creditors
Liabilities Current Liabilities Other current liabilities
Liabilities Current Liabilities Sales Tax Payable
Liabilities Current Liabilities Short Term Debt
Liabilities Current Liabilities Tax liability
Liabilities Current Liabilities Trade Creditors
Liabilities Long-Term Liablities Line of Credit Accounts
Liabilities Long-Term Liablities Other Non-Current Liabilities
Liabilities Term & Other Liabilities Deferred Tax
Liabilities Term & Other Liabilities Other Term and Other Liabilities
Total Total Total
Form Arguments  
files required stream of files body.
type required one of the document types value obtained from User detail.
user_doc_id optionalstring unique user_doc_id that can be send and use to track document.
doc_meta_data optionalstring additional metadata to be passed.
review_token optionalboolean generated shareable link by default.
headers (python only) dictionary of credentials (apikey)
API Response Detail  
data dict dict of response.
data.document list list of uploaded documents detail.
data.document[].doc_id string doc_id, this id is used to make query for all the data associated with this document.
data.document[].email string email of the user.
data.document[].review_url string this url is to review the document in the app.
data.document[].status string status of the document.
data.document[].title string title of the document.
data.document[].type string type of the document.
data.document[].user_id string internal user id of the user.
Webhook Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.

US Bank Statments

A bank statement is an official document that summarizes your account activity over a certain period of time—typically one month. Currently we support top 20 US banks. We are add support fot top 100 soon.

Definition

POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 
POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 

Example Request

curl -X POST \ 
https://app.docsumo.com/api/v1/eevee/apikey/upload/ \
-H apikey: <apikey> \
-F files=@ \
-F type=us_bank_statement  \
-F user_doc_id= \
-F doc_meta_data= \
-F review_token= \
import os
import requests

## requests
# path of file
path = 'example.pdf'
filename = os.path.basename(path)
multipart_form_data = {"files": ( filename, open(path, 'rb')),
                        "type": (None, "us_bank_statement")}
headers = {"X-API-KEY": '<apikey>'}

r = requests.post(
    "https://app.docsumo.com/api/v1/eevee/apikey/upload/" ,
    files=multipart_form_data,
    headers=headers,
)

r.json()

Example API Response

{
    "data": {
        "document": [
            {
                "created_at": "Sat, 13 Jun 2020 20:14:38 GMT",
                "doc_id": "fffcb91ba02248d78af90d73cc1a6720",
                "email": "test@docsumo.com",
                "review_url": "http://app.docsumo.com/review-document/fffcb91ba02248d78af90d73cc1a6720",
                "status": "new",
                "title": "sample_pnl_docsumo_2-merged.pdf",
                "type": "p_and_l",
                "user_doc_id": "",
                "user_id": "5ee52bb5cd4b9a1bd51df053"
            }
        ]
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}

Example Webhook/Json Response

{
    "bfed55cd894d4a3085a579f02fc93019": {
        "meta_data": {
            "title": "sample_us_bank_statement.pdf",
            "doc_id": "bfed55cd894d4a3085a579f02fc93019",
            "type": "us_bank_statement",
            "uploaded_from": "dummy",
            "user_doc_id": null,
            "doc_meta_data": "",
            "folder_name": "",
            "created_at_iso": "2022-12-02T12:28:36+00:00",
            "modified_at_iso": "2022-12-02T12:29:09+00:00",
            "status": "reviewing",
            "review_url": "https://app.docsumo.com/review-document/bfed55cd894d4a3085a579f02fc93019"
        },
        "data": {
            "Basic Information": {
                "Account Name": {
                    "value": "MR JOHN DOE",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Account Number": {
                    "value": "0123456789",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Bank Name": {
                    "value": "Wells Fargo",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Opening Balance": {
                    "value": "869.4",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Closing Balance": {
                    "value": "371.18",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "Start Date": {
                    "value": "2018-07-01",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                },
                "End Date": {
                    "value": "2018-07-31",
                    "position": [],
                    "confidence": 0,
                    "review_required": true
                }
            },

            },
            "Transactions": {
                "Line Items": [
                    {
                        "date": {
                            "value": "02/07/2018",
                            "position": [
                                178,
                                2664,
                                206,
                                2686
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "check_no": {
                            "value": "",
                            "position": [
                                330,
                                2662,
                                418,
                                2711
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "description": {
                            "value": "ATM Check Deposit on 07/02 1037 1752",
                            "position": [
                                420,
                                2664,
                                997,
                                2708
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "debit": {
                            "value": "",
                            "position": [
                                1293,
                                2662,
                                1480,
                                2711
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "credit": {
                            "value": 2724.82,
                            "position": [
                                1143,
                                2664,
                                1218,
                                2686
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "balance": {
                            "value": "",
                            "position": [
                                1480,
                                2662,
                                1592,
                                2711
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "type": {
                            "value": "transactions",
                            "position": [],
                            "confidence": 0,
                            "review_required": true
                        }
                    },
                    {
                        "date": {
                            "value": "02/07/2018",
                            "position": [
                                178,
                                2715,
                                206,
                                2737
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "check_no": {
                            "value": "",
                            "position": [
                                330,
                                2711,
                                418,
                                2761
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "description": {
                            "value": "Online Transfer to Serrano Business Checking xxxxxx8620 Ref #345 on 06/30/18",
                            "position": [
                                420,
                                2715,
                                906,
                                2759
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "debit": {
                            "value": 190.0,
                            "position": [
                                1350,
                                2715,
                                1409,
                                2737
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "credit": {
                            "value": "",
                            "position": [
                                1132,
                                2711,
                                1293,
                                2761
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "balance": {
                            "value": "",
                            "position": [
                                1480,
                                2711,
                                1592,
                                2761
                            ],
                            "confidence": 0,
                            "review_required": true
                        },
                        "type": {
                            "value": "transactions",
                            "position": [],
                            "confidence": 0,
                            "review_required": true
                        }
                    },
                ]
            }
        }
    }
}

Bank Supported

SN Bank name
1 JPMorgan Chase
2 Bank of America
3 Citigroup
4 Wells Fargo
5 Goldman Sachs
6 Morgan Stanley
7 Charles Schwab Corporation
8 U.S. Bancorp
9 Truist Financial
10 PNC Financial Services
11 TD Bank, N.A.
12 The Bank of New York Mellon
13 Capital One
14 State Street Corporation
15 HSBC Bank USA
16 Citizens Financial Group
17 SVB Financial Group
18 UBS
19 Fifth Third Bank
20 USAA

Bank Supported(coming soon)

SN Bank name
21 American Express
22 M&T Bank
23 BMO Harris Bank
24 KeyCorp
25 Ally Financial
26 Huntington Bancshares
27 Barclays
28 Santander Bank
29 RBC Bank
30 Regions Financial Corporation
31 Ameriprise
32 Northern Trust
33 MUFG Union Bank
34 BNP Paribas / Bank of the West
35 Deutsche Bank
36 Discover Financial
37 First Citizens BancShares
38 Synchrony Financial
39 Credit Suisse
40 Comerica
41 Raymond James Financial
42 First Horizon National Corporation
43 Popular, Inc.
44 Webster Bank
45 Western Alliance Bank
46 CIBC Bank USA
47 New York Community Bank
48 East West Bank
49 Synovus
50 Valley National Bank
51 Cullen/Frost Bankers, Inc.
52 Wintrust Financial
53 Mizuho Financial Group
54 South State Bank
55 John Deere Capital Corporation
56 Old National Bank
57 BOK Financial Corporation
58 FNB Corporation
59 PacWest Bancorp
60 Pinnacle Financial Partners
61 TIAA
62 UMB Financial Corporation
63 Prosperity Bancshares
64 Associated Banc-Corp
65 BankUnited
66 Stifel
67 Hancock Whitney
68 Commerce Bancshares
69 MidFirst Bank
70 Texas Capital Bank
71 First Interstate BancSystem
72 Umpqua Holdings Corporation
73 Sumitomo Mitsui Banking Corporation
74 United Bank (West Virginia)
75 FirstBank Holding Co
76 Simmons Bank
77 Glacier Bancorp
78 Arvest Bank
79 First National of Nebraska
80 First Hawaiian Bank
81 Fulton Financial Corporation
82 Flagstar Bank
83 Home BancShares
84 United Community Bank
85 Ameris Bancorp
86 Bank of Hawaii
87 City National Bank of Florida
88 Eastern Bank
89 Pacific Premier Bancorp
90 Cathay Bank
91 Columbia Bank
92 WSFS Bank
93 Customers Bancorp
94 Washington Federal
95 Independent Bank
96 Atlantic Union Bank
97 Heartland Financial USA
98 Central Bancompany
99 First BanCorp
100 Mechanics Bank
Form Arguments  
files required stream of files body.
type required one of the document types value obtained from User detail.
user_doc_id optionalstring unique user_doc_id that can be send and use to track document.
doc_meta_data optionalstring additional metadata to be passed.
review_token optionalboolean generated shareable link by default.
headers (python only) dictionary of credentials (apikey)
API Response Detail  
data dict dict of response.
data.document list list of uploaded documents detail.
data.document[].doc_id string doc_id, this id is used to make query for all the data associated with this document.
data.document[].email string email of the user.
data.document[].review_url string this url is to review the document in the app.
data.document[].status string status of the document.
data.document[].title string title of the document.
data.document[].type string type of the document.
data.document[].user_id string internal user id of the user.
Webhook Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.

Invoice API

Invoice

An invoice is a document that maintains a record of a transaction between a buyer and seller.

Definition

POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 
POST https://app.docsumo.com/api/v1/eevee/apikey/upload/ 

Example Request

curl -X POST \ 
https://app.docsumo.com/api/v1/eevee/apikey/upload/ \
-H apikey: <apikey> \
-F files=@ \
-F type=invoice  \
-F user_doc_id= \
-F doc_meta_data= \
-F review_token= \
import os
import requests

## requests
# path of file
path = 'example.pdf'
filename = os.path.basename(path)
multipart_form_data = {"files": ( filename, open(path, 'rb')),
                        "type": (None, "invoice")}
headers = {"X-API-KEY": '<apikey>'}

r = requests.post(
    "https://app.docsumo.com/api/v1/eevee/apikey/upload/" ,
    files=multipart_form_data,
    headers=headers,
)

r.json()

Example API Response

{
    "data": {
        "document": [
            {
                "created_at": "Sat, 13 Jun 2020 20:14:38 GMT",
                "doc_id": "fffcb91ba02248d78af90d73cc1a6720",
                "email": "bikram.dahal+j14@docsumo.com",
                "review_url": "http://app.docsumo.com/review-document/fffcb91ba02248d78af90d73cc1a6720",
                "status": "new",
                "title": "sample_rent_roll_docsumo_2-merged.pdf",
                "type": "rent_roll",
                "user_doc_id": "",
                "user_id": "5ee52bb5cd4b9a1bd51df053"
            }
        ]
    },
    "error": "",
    "error_code": "",
    "message": "",
    "status": "success",
    "status_code": 200
}

Example Webhook/Json Response

{
   "meta_data":{
      "title":"sample_invoice_docsumo.pdf",
      "doc_id":"f95ad39846044ebb89c46dff923952c5",
      "type":"invoice",
      "user_doc_id":null,
      "doc_meta_data":"",
      "folder_name":"",
      "created_at":"2022-09-20T08:49:52+00:00",
      "modified_at":"2022-09-20T08:49:52+00:00",
      "uploaded_from":"dummy",
      "stp":false,
      "review_url":"https://app.docsumo.com/review-document/f95ad39846044ebb89c46dff923952c5",
      "user_id":"63297eab80d34291bc8d9454",
      "org_id":"63297eab80d34291bc8d9454",
      "status":"processed",
      "approved_with_error":false
   },
   "data":{
      "Basic Information":{
         "Invoice Number":{
            "value":"2020",
            "position":[
               1311,
               436,
               1357,
               459
            ],
            "confidence":1.0,
            "review_required":false
         },
         "Issue Date":{
            "value":"13/12/2020",
            "position":[
               1311,
               474,
               1424,
               497
            ],
            "confidence":0,
            "review_required":true
         },
         "Terms":{
            "value":"Due upon recipt",
            "position":[
               1311,
               515,
               1464,
               538
            ],
            "confidence":0,
            "review_required":true
         },
         "Order Id/Tracking No":{
            "value":"",
            "position":[
               385.7,
               1389.1,
               385.7,
               1390.8
            ],
            "confidence":1,
            "review_required":false
         }
      },
      "Seller Detail":{
         "Name":{
            "value":"XYZ COMPANY PVT LTD",
            "position":[
               105,
               311,
               375,
               338
            ],
            "confidence":0,
            "review_required":true
         },
         "Address":{
            "value":"Texas, USA",
            "position":[
               105,
               349,
               218,
               375
            ],
            "confidence":0,
            "review_required":true
         },
         "GST/ VAT Number":{
            "value":"",
            "position":[

            ],
            "confidence":0,
            "review_required":true
         }
      },
      "Buyer Detail":{
         "Name":{
            "value":"ABC COMPANY PVT LTD",
            "position":[
               105,
               565,
               379,
               593
            ],
            "confidence":0,
            "review_required":true
         },
         "Address":{
            "value":"Texas, USA",
            "position":[
               105,
               606,
               218,
               631
            ],
            "confidence":0,
            "review_required":true
         },
         "GST/ VAT Number":{
            "value":"",
            "position":[

            ],
            "confidence":0,
            "review_required":true
         }
      },
      "GST & Amount":{
         "Subtotal":{
            "value":165000.0,
            "position":[
               1432,
               1140,
               1548,
               1165
            ],
            "confidence":0,
            "review_required":true
         },
         "Tax Rate":{
            "value":13.0,
            "position":[
               1484,
               1187,
               1548,
               1213
            ],
            "confidence":0,
            "review_required":true
         },
         "Tax Total":{
            "value":21450.0,
            "position":[
               1445,
               1235,
               1548,
               1260
            ],
            "confidence":0,
            "review_required":true
         },
         "Total Due":{
            "value":186450.13,
            "position":[
               1432,
               1283,
               1548,
               1308
            ],
            "confidence":0,
            "review_required":true
         }
      },
      "Table":{
         "Line Items":[
            {
               "Description":{
                  "value":"Cost of Development",
                  "position":[
                     105,
                     805,
                     326,
                     831
                  ],
                  "confidence":1,
                  "review_required":false
               },
               "HSN":{
                  "value":"",
                  "position":[

                  ],
                  "confidence":0,
                  "review_required":true
               },
               "Quantity":{
                  "value":1,
                  "position":[
                     1072,
                     805,
                     1085,
                     831
                  ],
                  "confidence":0,
                  "review_required":true
               },
               "Unit Price":{
                  "value":50000,
                  "position":[
                     1234,
                     805,
                     1298,
                     831
                  ],
                  "confidence":0,
                  "review_required":true
               },
               "Tax Rate Line":{
                  "value":"",
                  "position":[

                  ],
                  "confidence":0,
                  "review_required":true
               },
               "Subtotal Line":{
                  "value":50000,
                  "position":[
                     1484,
                     805,
                     1548,
                     831
                  ],
                  "confidence":0,
                  "review_required":true
               }
            },
            {
               "Description":{
                  "value":"Service Fee",
                  "position":[
                     105,
                     853,
                     223,
                     878
                  ],
                  "confidence":0,
                  "review_required":true
               },
               "HSN":{
                  "value":"",
                  "position":[

                  ],
                  "confidence":0,
                  "review_required":true
               },
               "Quantity":{
                  "value":1,
                  "position":[
                     1072,
                     853,
                     1085,
                     878
                  ],
                  "confidence":0,
                  "review_required":true
               },
               "Unit Price":{
                  "value":5000,
                  "position":[
                     1247,
                     853,
                     1298,
                     878
                  ],
                  "confidence":0,
                  "review_required":true
               },
               "Tax Rate Line":{
                  "value":"",
                  "position":[

                  ],
                  "confidence":0,
                  "review_required":true
               },
               "Subtotal Line":{
                  "value":5000,
                  "position":[
                     1496,
                     853,
                     1548,
                     878
                  ],
                  "confidence":0,
                  "review_required":true
               }
            },

         ]
      }
   },
   "error":"",
   "error_code":"",
   "message":"",
   "status":"success",
   "status_code":200,
   "event":"doc_status_change"
}

Fields extracted from Invoice

Section Name UI Auto Extract Names Description
Basic information Invoice Number Invoice Number
Basic information Invoice Date Invoice Date
Basic information Purchase Number Purchase Number Identification
Basic information Due Date The due date of the invoice
Basic information Payment Terms Payment Terms in the document
Basic information Invoice Type Type of invoice
Seller Details Seller Name Name of the seller
Seller Details Seller Address Address of the seller
Seller Details Seller ID Unique identifier of the seller (eg: GST, ABN, VAT)
Seller Details Seller Acc Number Account number of the seller
Buyer detail Buyer Name Name of the buyer
Buyer detail Buyer Address Address of the buyer
Buyer detail Buyer ID Unique identifier of the buyer (eg: GST, ABN, VAT)
Buyer detail Buyer Acc Number Account number of the buyer
Amounts Net Amount Net amount
Amounts Tax Amount Total Tax amount
Amounts Tax Rate Tax rate
Amounts Gross Amount Gross Amount
Amounts Amount Due Final Amount to be paid
Amounts Currency The currency which invoice is paid in
Payment Payment Acc Number Bank Account Number
Payment Payment Acc Name Bank Account Name
Payment Payment Bank Name Name of the Bank
Payment Payment Bank Address Address of the bank
Payment Payment IBAN IBAN number of the bank
Payment Payment Swift SWIFT code of the bank
Payment Payment Route Number Route number of the bank
Notes Delivery Notes Delivery Notes on the bank
Line Items Code Item Code
Line Items Description Description
Line Items Quanitiy Quantity
Line Items UOM Units of Measurement
Line Items Base Amount Amount before taxes
Line Items Tax Rate Line Tax rate
Line Items Unit Price Unit Price
Line Items Subtotal Line Subtotal Line
Form Arguments  
files required stream of files body.
type required one of the document types value obtained from User detail.
user_doc_id optionalstring unique user_doc_id that can be send and use to track document.
doc_meta_data optionalstring additional metadata to be passed.
review_token optionalboolean generated shareable link by default.
headers (python only) dictionary of credentials (apikey)
API Response Detail  
data dict dict of response.
data.document list list of uploaded documents detail.
data.document[].doc_id string doc_id, this id is used to make query for all the data associated with this document.
data.document[].email string email of the user.
data.document[].review_url string this url is to review the document in the app.
data.document[].status string status of the document.
data.document[].title string title of the document.
data.document[].type string type of the document.
data.document[].user_id string internal user id of the user.
Webhook Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
status_code int status code of response.
event (webhook only) trigger event of webhook.

Indian Lending

Bank Statments

Extract transaction data from Indian bank statements.

Definition

POST http://bankstatementapi.docsumo.com/api/v1/parse/basic/?xml=false&debug=true
POST http://bankstatementapi.docsumo.com/api/v1/parse/basic/?xml=false&debug=true

Example Request

curl --location --request POST 'https://bankstatementapi.docsumo.com/api/v1/parse/basic/?xml=false&debug=true' \
--header 'X-API-KEY: {{apikey}}' \
--form 'file_{id}=@/path/to/file' \
--form 'password_{id}=' \
--form 'doc_uploaded_date=2019-12-02' \
--form 'user_bank_name='
import requests

url = "https://bankstatementapi.docsumo.com/api/v1/parse/basic/?xml=true&debug=true"

payload = {'password_{id}': '',
'doc_uploaded_date': '2019-12-02',
'user_bank_name': ''}
files = [
  ('file_{id}', open(<file_path>,'rb'))
]
headers = {
  'X-API-KEY': <apikey>,
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response

{
  "analysis": {
    "MonthlyAnalysis": {
      "2019-07": {
        "avgDailyBalance": "730.42",
        "balAvgOf6Dates": "165.27",
        "balanceOn10th": "155.10",
        "balanceOn15th": "155.10",
        "balanceOn1st": "203.10",
        "balanceOn20th": "155.10",
        "balanceOn25th": "155.10",
        "balanceOn30th": "3325.10",
        "balanceOn5th": "168.10",
      },
      "2019-08": {
        "avgDailyBalance": "353.03",
        "balAvgOf6Dates": "577.03",
        "balanceOn10th": "0.00",
        "balanceOn15th": "0.00",
        "balanceOn1st": "3325.10",
        "balanceOn20th": "0.00",
        "balanceOn25th": "0.00",
        "balanceOn30th": "505.00",
        "balanceOn5th": "137.10",
      },
      "2019-09": {
        "avgDailyBalance": "571.32",
        "balAvgOf6Dates": "862.72",
        "balanceOn10th": "506.00",
        "balanceOn15th": "53.10",
        "balanceOn1st": "4005.00",
        "balanceOn20th": "53.10",
        "balanceOn25th": "53.10",
        "balanceOn30th": "58.10",
        "balanceOn5th": "506.00",
      }
    },
    "Summary": {
      "avgBalanceOf6Dates": "535.01",
      "avgDailyBalance": "551.38",
      "avgMonthlyExpense": "3618.33",
      "avgMonthlyIncome": "3570.00",
      "avgMonthlySurplus": "-48.33",
      }
  },
  "error": "",
  "error_code": "",
  "message": "",
  "meta_data": {
    "accounts_data": {
      "account_number": "",
      "account_type": "SAVINGS-BASIC SAVINGS",
      "address": "",
      "bank_name": "Axis Bank, India",
      "closing_balance": "",
      "email": "",
      "landline": "",
      "mobile": "",
      "name": "",
      "opening_balance": "203.10",
      "pan": ""
    },
    "date_count": 26,
    "method": "box",
    "order": 1,
    "title": "axis_bank.pdf",
    "total_time_taken (in second)": 30,
    "validation_info_balance": {
      "extracted_count_balance": 26,
      "extracted_target_ratio_balance": 0.93,
      "target_count_balance": 28
    },
    "validation_info_date": {
      "extracted_count_date": 26,
      "extracted_target_ratio_date": 1,
      "target_count_date": 26
    }
  },
  "status": "success",
  "status_code": 200
}

Error Code

Error Condition
E_DATE_RANGE The user does not have transactions for a large range of the days in the Bank statement shared. This can also be triggered when the user submits without uploading a bank statement.
E_NOT_ACCEPTED Insufficient data to generate a report. Often triggered if there are no transactions for a whole month or months.
E_STATEMENT_UNSUPPORTED_FORMAT Scanned image and not a PDF, MPassbook, etc.
E_MULTIPLE_ERRORS Aggregation of any errors in list.
E_FILE_EDITOR_BLACKLISTED Flag for whether a “blacklisted” editing tool was used on the PDF(metadata).
E_FILE_NOT_STATEMENT The uploaded file is not a valid bank statement. The uploaded file is a tax invoice, payslip, or some other invalid document.
E_FILE_NO_PASSWORD Statement password not provided.
E_OTHER Timed out due to inactivity or there were one or more fatal errors.
E_STATEMENT_WRONG_INSTITUTION The user uploaded the statement for the incorrect institution (chose ABC bank but uploaded statement for XYZ bank).
E_AMOUNT_BALANCE_MISMATCH Balances do not reconcile with transactions.
E_FILE_IO Damaged PDF or unable to open.
E_INCOMPLETE_MONTHS Flag for whether a full month is not reflected on the bank statement.
E_STATEMENT_NO_TRANSACTIONS There are no transactions in this statement. Please upload a valid bank statement.
E_STATEMENT_TOO_MANY_PAGES Cannot process files with more than 1000 pages.
Query Parameter  
xml boolean get detail in xml true or false.
debug boolean bypass certain error and checks with debug=true.
Form Arguments  
file_{id} string path of the bank statement file.
password_{id} string password of the file.
doc_uploaded_date date upload date of the document.
user_bank_name string name of the bank of the user.
Json Response Detail  
analysis dict dict of response.
meta_data dict dict of metadata of the document.
Json Response Sections Breakdown  
customerInfo This section contains the information on customer.
statementDetails Information about the valid statement files are shown in this section.
summaryInfo Summary of several useful quantitative attributes over the total time period of the statement.
monthwiseDetails Summary of several useful quantitative attributes of the statement on a monthly basis.
accountDetails This section contains details of accounts, such as name of the bank, account number and current balance.
bouncedPenalXns This section lists all bounced/rejected and penal transactions.
salaryPensionCredits This section lists all unambiguously identified Salary/Pension transactions.
highValueXns High value debit and credit transactions.
recurring.debts This section lists all transactions related to common recurring expenses. The criterion for considering a category to be recurring is that expense in the category must occur in 4 or more months.
recurring.uncategorized.expenses This section lists all recurring uncategorized transactions. Two transactions are grouped based on the transaction narration. The criterion for considering a group to be recurring is same as for recurring.debts.
recurring.amount.date Attempts to identify recurring monthly payments of fixed amounts, puts each such sequence of transactions in a group, and lists all such groups.
BouncedEmiXns It should contain date, chqNo, narration, amount, category, reason. Reason field should state whether the emi bounce is technical or non-technical.
xns This section lists all the transactions with amount.

Indian KYC

These API helps you extract the relevant key-values from the Indian Identification Documents uploaded by the users.

Fraud checks

Checks to determine if the document uploaded is Monochrome (Black and White), Scanned image or Photo of photo has to be carried out. Usually the images taken from secondary sources like scans, print outs or other documents are fraudulent. If ?fraud_check=true then the documents are checked for the following Frauds.
- B_W_IMAGE
- SCANNED_IMAGE
- DOCUMENT_CROPPED
- PHOTO_OF_PHOTO

Otherwise, these checks are skipped and all the fields that were extracted is returned.

Pan Extract

Extra information from Indian PAN Card documents.

Definition

POST https://panapi.docsumo.com/api/v1/pan/extract/?save_data=false&fraud_check=true
POST https://panapi.docsumo.com/api/v1/pan/extract/?save_data=false&fraud_check=true

Example Request

curl --location --request POST 'https://panapi.docsumo.com/api/v1/pan/extract/?save_data=false&fraud_check=true' \
--header 'X-API-KEY: {{apikey}}' \
--form 'files=@/path/to/file'
import requests

url = "https://panapi.docsumo.com/api/v1/pan/extract/?save_data=false&fraud_check=true"

payload = {}
files = [
  ('files', open(<file_path>,'rb'))
]
headers = {
  'X-API-KEY': <apikey>,
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response

{
    "data": {
        "dob": {
            "conf": 0.9910000085830688,
            "position": [
                25,
                184,
                133,
                208
            ],
            "review_required": false,
            "value": "23/11/1974"
        },
        "father_name": {
            "conf": 0.9918181896209717,
            "position": [
                25,
                129,
                183,
                151
            ],
            "review_required": false,
            "value": "Suresh Gupta"
        },
        "name": {
            "conf": 0.9880000054836273,
            "position": [
                19,
                89,
                166,
                107
            ],
            "review_required": false,
            "value": "Rahul Gupta"
        },
        "pan": {
            "conf": 0.9920000076293946,
            "position": [
                22,
                235,
                155,
                257
            ],
            "review_required": false,
            "value": "ABCDE1234F"
        }
    },
    "message": "",
    "meta_data": {
        "id": "34de761fc9e54d72bc5c9a363b12b163",
        "review_required": false,
        "rotation_angle": 0,
        "title": "a4116bf3aeac45fa97e7eefb7e45718d.jpg"
    },
    "status_code": 200
}
Form Arguments  
files string stream of files body.
Query Parameters  
save_data boolean save data true or false
fraud_check boolean check fraud true or false
Json Response Detail  
data dict dict of response.
data.{}.{key} string keys like number, name , dob
data.{}.{value}.conf float OCR confidence of text extracted.
data.{}.{value}.review_required boolean True if human review is required due to low OCR confidence or format doesnt match.
data.{}.{value}.position array position of extracted text.
data.{}.{value}.value string extracted text.
meta_data dict dict of metadata of the document.
meta_data{}.id string id of the document.
meta_data{}.review_required boolean status of review required for the document.
meta_data{}.title string name of the document.

Passport Extract

Extract information from Indian Passports.

Definition

POST https://passportapi.docsumo.com/api/v1/passport/extract/?side=back&save_data=false&fraud_check=true
POST https://passportapi.docsumo.com/api/v1/passport/extract/?side=back&save_data=false&fraud_check=true

Example Request

curl --location --request POST 'https://passportapi.docsumo.com/api/v1/passport/extract/?side=back&save_data=false&fraud_check=false' \
--header 'X-API-KEY: {{apikey}}' \
--form 'files=@/path/to/file'
import requests

url = "https://passportapi.docsumo.com/api/v1/passport/extract/?side=back&save_data=false&fraud_check=false"

payload = {}
files = [
  ('files', open(<file_path>,'rb'))
]
headers = {
  'X-API-KEY': '<apikey>',
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response

{
    "data": {
        "birth_place": {
            "confidence": 0.9683333337306976,
            "position": [
                349,
                277,
                628,
                304
            ],
            "review_required": false,
            "value": "MANGALORE KARNATAKA"
        },
        "dob": {
            "confidence": 0.9880000054836273,
            "position": [
                585,
                232,
                730,
                258
            ],
            "review_required": false,
            "value": "01/11/1973"
        },
        "expiry_date": {
            "confidence": 0.9920000076293946,
            "position": [
                580,
                373,
                724,
                399
            ],
            "review_required": false,
            "value": "01/05/2016"
        },
        "gender": {
            "confidence": 0.949999988079071,
            "position": [
                523,
                234,
                525,
                253
            ],
            "review_required": false,
            "value": "F"
        },
        "given_name": {
            "confidence": 0.9944444497426351,
            "position": [
                299,
                185,
                407,
                204
            ],
            "review_required": false,
            "value": "AISHWARYA"
        },
        "issue_date": {
            "confidence": 0.9920000076293946,
            "position": [
                349,
                368,
                491,
                392
            ],
            "review_required": false,
            "value": "02/05/2006"
        },
        "issue_place": {
            "confidence": 0.9950000047683716,
            "position": [
                348,
                324,
                437,
                345
            ],
            "review_required": false,
            "value": "MUMBAI"
        },
        "nationality": {
            "confidence": 0.996666669845581,
            "position": [
                320,
                236,
                375,
                253
            ],
            "review_required": false,
            "value": "INDIAN"
        },
        "passport_no": {
            "confidence": 0.9437500163912773,
            "position": [
                586,
                116,
                731,
                139
            ],
            "review_required": false,
            "value": "F7802033"
        },
        "surname": {
            "confidence": 0.9900000095367432,
            "position": [
                302,
                144,
                337,
                160
            ],
            "review_required": false,
            "value": "RAI"
        }
    },
    "message": "",
    "meta_data": {
        "id": "c075f7147c82447eade817a51f5460d2",
        "review_required": false,
        "rotation_angle": -2.2457425658950716,
        "title": "582d99f8c8f94bf78777143c1e992171.jpg"
    },
    "status_code": 200
}
Form Arguments  
files string stream of files body.
Query Parameters  
side string front or back side.
save_data boolean save data true or false.
fraud_check boolean check fraud true or false.
Json Response Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
meta_data{}.id string id of the document.
meta_data{}.review_required boolean status of review required for document.
meta_data{}.title string name of the document.

Aadhar Extract

Extracts information from Indian Aadhaar Cards.

Definition

POST https://nationalapi.docsumo.com/api/v1/national/extract/?side=back&save_data=false&return_redacted=false&fraud_check=true
POST https://nationalapi.docsumo.com/api/v1/national/extract/?side=back&save_data=false&return_redacted=false&fraud_check=true

Example Request

curl --location --request POST 'https://nationalapi.docsumo.com/api/v1/national/extract/?side=back&save_data=false&return_redacted=false&fraud_check=true' \
--header 'X-API-KEY: {{apikey}}' \
--form 'files=@/path/to/file'
import requests

url = "https://nationalapi.docsumo.com/api/v1/national/extract/?side=back&save_data=false&return_redacted=false&fraud_check=true"

payload = {}
files = [
  ('files', open(<file_path>,'rb'))
]
headers = {
  'X-API-KEY': <apikey>,
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response

{
    "data": {
        "address": {
            "conf": 0.9,
            "position": [
                1193,
                365,
                2092,
                734
            ],
            "review_required": false,
            "value": "14-2-89 Govt High School Back line Khammam Urban Mandal Ballepalle Khammam"
        },
        "father_name": {
            "conf": 0.9,
            "position": [
                1193,
                355,
                2092,
                714
            ],
            "review_required": false,
            "value": "Jaripiti Srinivas"
        },
        "no": {
            "conf": 0.99,
            "position": [
                898,
                1021,
                1578,
                1111
            ],
            "review_required": false,
            "value": "444422223333"
        },
        "pin": {
            "conf": 1,
            "position": [
                412,
                645,
                634,
                718
            ],
            "review_required": false,
            "value": "507002"
        },
        "state": {
            "conf": 1,
            "position": [
                412,
                645,
                634,
                718
            ],
            "review_required": false,
            "value": "Andhra Pradesh"
        }
    },
    "message": "",
    "meta_data": {
        "id": "7640bccd993d4a438b8883e94f9f6f01",
        "review_required": false,
        "rotation_angle": 0.4,
        "title": "a141d50039d14a3f91424798c3b3829d.jpg"
    },
    "status_code": 200
}
Form Arguments  
files string stream of files body.
Query Parameters  
side string front or back side.
save_data boolean save data true or false.
return_redacted boolean return image with aadhar number redacted as base64.
fraud_check boolean check fraud true or false.
Json Response Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
meta_data{}.id string id of the document.
meta_data{}.review_required boolean status of review required for document.
meta_data{}.title string name of the document.

Driving License Extract

Extract information from Indian Driving License.

Definition

POST https://dlrcapi.docsumo.com/api/v1/dl/extract/?save_data=false&fraud_check=true
POST https://dlrcapi.docsumo.com/api/v1/dl/extract/?save_data=false&fraud_check=true

Example Request

curl -X POST 'https://dlrcapi.docsumo.com/api/v1/dl/extract/?save_data=false&fraud_check=true' \
--header 'X-API-KEY: <apikey>' \
--form 'files=@/path/to/file'
import requests

url = "https://dlrcapi.docsumo.com/api/v1/dl/extract/?save_data=false&fraud_check=true"

payload = {}
files = [
  ('files', open(<file_path>,'rb'))
]
headers = {
  'X-API-KEY': <apikey>,
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response

{
    "data": {
        "address": {
            "confidence": 0.97,
            "position": [
                129,
                111,
                268,
                153
            ],
            "review_required": false,
            "value": "HNO-178 A2/B MIG FLATS PASCHIM VIHAR, DELHI 110063"
        },
        "category_of_veh": {
            "confidence": 0.99,
            "position": [],
            "review_required": true,
            "value": "LMV"
        },
        "date_of_validity": {
            "confidence": 0,
            "position": [],
            "review_required": false,
            "value": "2026/2/8"
        },
        "dl_no": {
            "confidence": 0.98,
            "position": [
                130,
                59,
                254,
                75
            ],
            "review_required": false,
            "value": "DL0420110149646"
        },
        "dob": {
            "confidence": 0.99,
            "position": [
                180,
                98,
                256,
                112
            ],
            "review_required": false,
            "value": "1976/2/9"
        },
        "name": {
            "confidence": 0.99,
            "position": [
                21,
                72,
                62,
                100
            ],
            "review_required": false,
            "value": "ANURAG BREJA"
        },
        "pin": {
            "confidence": 0.97,
            "position": [],
            "review_required": false,
            "value": "110063"
        },
        "rto": {
            "confidence": 0.98,
            "position": [],
            "review_required": false,
            "value": "Delhi"
        }
    },
    "message": "",
    "meta_data": {
        "id": "0e839d37e805422f988f6e042c29e6c9",
        "rotation_angle": 0,
        "title": "38e7f9f86f0e417a878423b8b4179727.jpg"
    },
    "status_code": 200
}
Form Arguments  
files string stream of files body.
Query Parameters  
save_data boolean save data true or false.
fraud_check boolean check fraud true or false.
Json Response Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
meta_data{}.id string id of the document.
meta_data{}.rotation_angle number angle of rotation of driving license.
meta_data{}.title string name of the document.

Voter Id

Extract information from Indian Voter IDs.

Definition

POST https://voteridapi.docsumo.com/api/v1/voterid/extract/?side=front&save_data=false&fraud_check=true
POST https://voteridapi.docsumo.com/api/v1/voterid/extract/?side=front&save_data=false&fraud_check=true

Example Request

curl -X POST 'https://voteridapi.docsumo.com/api/v1/voterid/extract/?side=back&save_data=false&fraud_check=true' \
--header 'X-API-KEY:  <apikey>' \
--form 'files=@/path/to/file'
import requests

url = "https://voteridapi.docsumo.com/api/v1/voterid/extract/?side=back&save_data=false&fraud_check=true"

payload = {}
files = [
  ('files', open(<file_path>,'rb'))
]
headers = {
  'X-API-KEY': <apikey>,
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response

{
    "data": {
        "father_name": {
            "conf": 0.9187500104308128,
            "position": [
                372,
                840,
                489,
                871
            ],
            "review_required": false,
            "value": "Leonardo Caprio Sr"
        },
        "name": {
            "conf": 0.9891304425571277,
            "position": [
                244,
                693,
                673,
                739
            ],
            "review_required": false,
            "value": "Leonardo Caprio Jr"
        },
        "voter_id": {
            "conf": 0.9790000140666961,
            "position": [
                532,
                136,
                724,
                176
            ],
            "review_required": false,
            "value": "AXP1471000"
        }
    },
    "message": "",
    "meta_data": {
        "id": "a6b51234818e47fd990f42e1ab2da37e",
        "review_required": false,
        "rotation_angle": 1.16,
        "title": "img.jpg"
    },
    "status_code": 200
}
Form Arguments  
files string stream of files body.
Query Parameters  
side string front or back side.
save_data boolean save data true or false.
fraud_check boolean check fraud true or false.
Json Response Detail  
data dict dict of response.
meta_data dict dict of metadata of the document.
meta_data{}.id string id of the document.
meta_data{}.review_required boolean status of review required for document.
meta_data{}.rotation_angle number angle of roation of voter id.
meta_data{}.title string name of the document.

Utility

Name Match

Check the similarity of the names from mutiple documents.

If similarity_scores >= 0.9 than name is similar

Definition

POST https://namematch.docsumo.com/api/v1/similarity/names/
POST https://namematch.docsumo.com/api/v1/similarity/names/

Example Request

curl -X POST 'https://namematch.docsumo.com/api/v1/similarity/names/' \
--header 'X-API-KEY:  <apikey>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference_name": "Bikram Dahal",
    "names": [
        "B Dahal",
        "Bikram D",
        "bikram dahal",
        "D bikram"
    ]
}'
import requests

url = "https://namematch.docsumo.com/api/v1/similarity/names/"

payload = "{\n    \"reference_name\": \"Bikram Dahal\",\n    \"names\": [\n        \"B Dahal\",\n        \"Bikram D\",\n        \"bikram dahal\",\n        \"D bikram\"\n    ]\n}"
headers = {
  'X-API-KEY': <apikey>,
  'Content-Type': 'application/json',
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.json())

Example Response

{
  "data": {
    "average_score": 0.917,
    "similarity_scores": [
      0.8,
      0.933,
      1,
      0.933
    ]
  },
  "error": "",
  "error_code": "",
  "message": "",
  "status_code": 200
}

Error

ERROR Condition
400 Json is not of required format. Please check body.
Form Arguments  
reference_name string reference for name.
names list list of names.
Json Response Detail  
data dict dict of response.
data.average_score number average score of name match.
data.similarity_scores list list of similarity_scores.

Selfie check

Check if selfie meets all requirements.

Definition

POST https://facematch.docsumo.com/api/v1/match/
POST https://facematch.docsumo.com/api/v1/match/

Example Request

curl -X POST 'https://facematch.docsumo.com/api/v1/match/' \
--header 'X-API-KEY:  <apikey>' \
--form 'file_selfie=@/path/to/file'
import requests

url = "https://facematch.docsumo.com/api/v1/match/"

payload = {}
files = [
  ('file_selfie', open('/path/to/file','rb'))
]
headers = {
  'X-API-KEY': '{{apikeybs}}',
}

response = requests.request("POST", url, headers=headers, data = payload, files = files)

print(response.json())

Example Response

{
  "data": "",
  "message": "",
  "meta_data": {
    "deltatime": 1.6522548198699951
  },
  "status_code": 200
}

Error

ERROR CODE Status Description
IMAGE_MISSING_ON_REQUEST 400 Files not found in the request.
FILE_SELFIE_MISSING_ON_REQUEST 400 filename_selfie not found in the request.
FILE_TYPE_NOT_SUPPORTED 400 File-type no supported.
IMAGE_INVALID 400 Corrupt/Invalid Image.
IMAGE_TOO_SMALL 400 Very low resolution image.
NO_FACE_DETECTED 400 Face is not detected.
MULTIPLE_FACE_DETECTED 400 Multiple faces present in the image.
PHOTO_OF_PHOTO 400 If the selfie is a photo of a picture (say photograph captured through mobile.
IMAGE_BLURRY 400 Image is blurry (or not very sharp).
IMAGE_BRIGHT 400 Image is too bright.
IMAGE_DARK 400 Image is too dark.
FACE_TOO_CLOSE 400 Face of the person is too close to the camera.
FACE_TOO_FAR 400 Face is too far from the camera.
EYES_CLOSED 400 Eyes are fully/partially closed.
FACE_POSE_WEIRD 400 selfie of the person is slanted, or person has turned his/her head.
IMAGE_ACCESSORY_GLASS 400 Person is wearing glasses (any).
Form Arguments  
file_selfie string file of selfie.
Json Response Detail  
meta_data dict dict of metadata.
meta_data{}.deltatime number time for selfie match.