Upload Tenant Documents
Upload one or more documents for a tenant. At least one document is required.
File size limits:
- Each individual document must not exceed 4 MB.
- The combined size of all documents uploaded in a single request must not exceed 20 MB.
If fileType is set to unknown-type, document analysis will be initiated
automatically after upload.
Asynchronous Processing
Document analysis is performed as an Asynchronous operation. The API response confirms successful upload, while analysis is processed in the background.
Document Analysis Completion Webhook
When document analysis from Skor Lite is completed successfully, a webhook
event with the name DOCUMENT_ANALYSIS_DATA is sent to the configured
webhook endpoint.
The webhook payload contains:
event: Event name (DOCUMENT_ANALYSIS_DATA)data: Document analysis result data
In case of document analysis failure, the process is automatically handled by the SKOR system and does not require manual retries from the client.
The configured webhook endpoint must accept POST requests.
Required Documents by Employment Type
The documents required for a tenant depend on their declared employment status. Each employment type requires documents across one or more of the following categories:
- Identification: Documents used to verify the tenant’s identity
- Employment Status: Documents proving current employment or activity
- Income / Tax Documents: Documents used to assess income and financial stability
Student:
Identification
- Passport
- National Identity Card (Front)
- National Identity Card (Back)
- Residence Permit (Front)
- Residence Permit (Back) Employment / Status
- University Acceptance Letter
- Student Registration Contract
Employed:
Identification
- Passport
- National Identity Card (Front)
- National Identity Card (Back)
- Residence Permit (Front)
- Residence Permit (Back)
Employment Status
- Employment Contract
- Working Life Certificate
Income Documents
- Payslip
- Deduction Certificate
- Last Annual Tax Report (Model 100)
Self-Employed (Freelancer):
Identification
- Passport
- National Identity Card (Front)
- National Identity Card (Back)
- Residence Permit (Front)
- Residence Permit (Back)
Employment Status
- Employment Contract
- Working Life Certificate
Income Documents
- Last Annual Tax Report (Model 100)
- Last Fractionated Tax Report (Model 130)
- Deduction Certificate
- Last Quarterly VAT Tax (Form 303)
Self-Employed (Own a Company):
Identification
- Passport
- National Identity Card (Front)
- National Identity Card (Back)
- Residence Permit (Front)
- Residence Permit (Back)
Employment Status
- Working Life Certificate
Income Documents
- Last Annual Tax Report (Model 100)
- Last Quarterly VAT Tax (Form 303)
- Deduction Certificate
- Last Year’s Corporate Tax Return
- Last Year’s Corporate Balance Sheet
- Last Year’s Corporate Profit & Loss Statement
Retired:
Identification
- Passport
- National Identity Card (Front)
- National Identity Card (Back)
- Residence Permit (Front)
- Residence Permit (Back)
Income Documents
- Comprehensive Certificate of Benefits
- Last Revalorization Letter
Unemployed:
Identification
- Passport
- National Identity Card (Front)
- National Identity Card (Back)
- Residence Permit (Front)
- Residence Permit (Back)
Employment History
- Working Life Certificate
Income Documents
- Comprehensive Certificate of Benefits
- Last Annual Tax Report (Model 100)
Public Servant:
Identification
- Passport
- National Identity Card (Front)
- National Identity Card (Back)
- Residence Permit (Front)
- Residence Permit (Back)
Employment Status
- Working Life Certificate
Income / Tax Documents
- Last Annual Tax Report (Model 100)
- Payslip
- Deduction Certificate
Authorizations
HTTP Bearer Authentication. Pass the token generated via
/keys/generate-token as Authorization: Bearer <token>.
Path Parameters
Body
One or more documents to upload. Each document must not exceed 4 MB. The total upload size per request must not exceed 20 MB. Allowed file types: - application/pdf - image/jpeg - image/jpg - image/png
1Type of the uploaded document. If set to unknown-type, document analysis will be triggered.