Owner Upload

Intro

The Owner Upload service allows you to send your own end-user and transactional data to the Kontomatik system, enabling you to perform the same operations as with data from sources like AIS or PDF Statements Parsing. This is particularly useful if you have proprietary data that you’d like to use for analysis, scoring, labeling, or other API features provided by Kontomatik.

Integration

Once you have the API access, you can start using the service:

1. Prepare your data
   The data you send must be in JSON format and follow the structure provided in our Owner Upload Payload documentation. Be sure to include the ownerExternalId in the payload and associate it with the unique end-user on your side. You will reference this ownerExternalId for future requests.
2. Send the data
   Once the data is prepared, send it to the POST /v1/owner endpoint. You’ll need to ensure that the Content-Type is set to application/json. Optionally, you can compress the payload with gzip to increase the batch volume.
3. Receive the response
   Once the data is successfully processed, you will receive a JSON object containing a requestId. In case of an error, the system will provide detailed error information, which you can use to troubleshoot and correct any issues with the data.

What’s next?

Now that the data is uploaded to Kontomatik servers, you can use our other solutions such as:

• Scoring
• Labeling and Vendors Recognition
• Data Summary
• Income Confirmation

All those features require the ownerExternalId in the request. Simply use the same ownerExternalId that you included in the Owner Upload payload.

Additionally, data for a single ownerExternalId will be aggregated from multiple sources. For example, you can combine data from AIS + PDF + Owner Upload, or Owner Upload + PDF + PDF, etc. as long as you provide the same identifier for each source. This allows you to create a comprehensive financial report for an individual end-user.