---
updatedAt: 2025-11-11T23:14:53.000Z
agentTools:
projectIndex: https://developers.fortresstrust.com/llms.txt
---
# Uploads a document for KYC-checks (Auth)
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Fortress.Identity Api",
"version": "1.0"
},
"servers": [
{
"url": "https://api.sandbox.fortressapi.com/"
}
],
"paths": {
"/api/compliance/v1/personal-identities/{identityId}/documents": {
"post": {
"tags": [
"PersonalDocuments"
],
"summary": "Uploads a document for KYC-checks (Auth)",
"parameters": [
{
"name": "identityId",
"in": "path",
"description": "Id of the identity, to which document will be linked",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"required": [
"DocumentFront",
"DocumentType"
],
"type": "object",
"properties": {
"DocumentType": {
"$ref": "#/components/schemas/PersonalDocumentType"
},
"DocumentFront": {
"type": "string",
"description": "An image of the front of the ID. For passports, the front is the page containing the user's name and photograph.",
"format": "binary"
},
"DocumentBack": {
"type": "string",
"description": "An image of the back of the ID. This parameter is optional for the passport but required for others documents.",
"format": "binary"
},
"SelfPortrait": {
"type": "string",
"description": "A self-portrait of the user for facial recognition. This parameter is optional and can be used as an additional data point for verification.",
"format": "binary"
}
}
},
"encoding": {
"DocumentType": {
"style": "form"
},
"DocumentFront": {
"style": "form"
},
"DocumentBack": {
"style": "form"
},
"SelfPortrait": {
"style": "form"
}
}
}
}
},
"responses": {
"201": {
"description": "Created",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DocumentModel"
}
}
}
},
"400": {
"description": "Bad request model data",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Not authorized to access this identity",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
},
"404": {
"description": "Identity was not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
}
}
}
}
},
"security": [
{
"Bearer": []
}
]
}
}
},
"components": {
"schemas": {
"BusinessDocumentType": {
"enum": [
"other",
"proofOfAddress",
"proofOfCompanyFormation",
"formationDocument",
"agreement",
"taxIdDocument"
],
"type": "string"
},
"DocumentModel": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"identityId": {
"type": "string",
"format": "uuid"
},
"personalDocumentType": {
"$ref": "#/components/schemas/PersonalDocumentType"
},
"businessDocumentType": {
"$ref": "#/components/schemas/BusinessDocumentType"
},
"documentReferenceId": {
"type": "string",
"format": "uuid",
"nullable": true
},
"documentUuid": {
"type": "string",
"format": "uuid",
"nullable": true
},
"documentCheckStatus": {
"$ref": "#/components/schemas/DocumentStatus"
},
"isVerified": {
"type": "boolean",
"readOnly": true
}
},
"additionalProperties": false
},
"DocumentStatus": {
"enum": [
"pending",
"automaticReviewInProgress",
"manualReviewNeeded",
"accepted",
"rejected",
"resubmit"
],
"type": "string"
},
"PersonalDocumentType": {
"enum": [
"license",
"identificationCard",
"passport"
],
"type": "string"
},
"ProblemDetails": {
"type": "object",
"properties": {
"type": {
"type": "string",
"nullable": true
},
"title": {
"type": "string",
"nullable": true
},
"status": {
"type": "integer",
"format": "int32",
"nullable": true
},
"detail": {
"type": "string",
"nullable": true
},
"instance": {
"type": "string",
"nullable": true
}
},
"additionalProperties": {}
}
},
"securitySchemes": {
"Bearer": {
"type": "apiKey",
"description": "Put access token in the box below.
For example: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6I",
"name": "Authorization",
"in": "header"
}
}
},
"security": [
{
"Bearer": []
}
],
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
}
}
```