> ## Documentation Index > Fetch the complete documentation index at: https://docs.skortorent.com/llms.txt > Use this file to discover all available pages before exploring further. # Initiate KYC Verification > Starts identity verification for a tenant in a single call — uploads the provided identity document(s) and starts the verification workflow using the tenant's stored profile (`fname`, `lname`, `email`). Send as `multipart/form-data` with: - `doc_type` — `passport`, `driving_licence`, `national_identity_card`, or `residence_permit`. - `issuing_country` — 3-letter ISO code (e.g. `ESP`). - `front` — file (required, max 10 MB; `PDF`, `JPEG`, `JPG`, `PNG`). - `back` — file (required for all types except `passport`; same limits). Returns verification identifiers (`applicant_id`, `document_ids`, `workflow_run_id`, and `workflow_data`) you can use to track status. If a verification is already `pending` for the tenant, the request is rejected with `KYC already in progress for this tenant`. ## OpenAPI ````yaml /api-reference/openapi.yaml post /tenants/{tenantId}/kyc openapi: 3.1.0 info: title: SKOR Modular API version: 1.0.0 description: > ## Overview This is the SKOR Modular API v1. It provides access to tenant workflows, API keys, webhooks, document processing, identity verification, banking connectivity, and forensic analysis. ## Error Statuses The API uses standard HTTP status codes to indicate the success or failure of requests. Each error response provides guidance to help identify the issue and take corrective action. ### Success — `200 OK` The request was processed successfully and the expected response data is returned. ### Validation Error — `400 Bad Request` The request is invalid due to missing, malformed, or incorrect parameters. **Common causes:** - Required fields are missing from the request. - Invalid data formats or unsupported values are provided. - File size or payload limits are exceeded. **How to resolve:** - Verify all required parameters are present. - Ensure the request payload matches the documented schema. - Validate data formats and constraints before retrying. ### Unauthorized — `401 Unauthorized` Authentication failed or the provided token is missing or invalid. **Common causes:** - The `Authorization` header is missing. - An invalid or expired bearer token is provided. **How to resolve:** - Ensure the token is included in the request as an `Authorization: Bearer ` header. - Verify the token is valid and has not expired. - Generate a new token if required. ### Not Found — `404 Not Found` The requested resource does not exist or is not accessible. **Common causes:** - An invalid or non-existent resource identifier. - The resource has not been created or has been deleted. **How to resolve:** - Confirm the resource identifier is correct. - Ensure the resource exists before accessing it. ### Server Error — `500 Internal Server Error` An unexpected error occurred on the server while processing the request. **How to resolve:** - Retry the request after a short delay. - If the issue persists, **[contact us](mailto:info@skortorent.com)** with relevant request details. ### Need Help? If you encounter unexpected behavior, please **[contact us](mailto:info@skortorent.com)** for assistance. servers: - url: https://api.skortorent.com/api/v1 description: Live - url: https://dev-api.skortorent.com/api/v1 description: Sandbox security: - BearerAuth: [] paths: /tenants/{tenantId}/kyc: post: tags: - Tenants summary: Initiate KYC Verification description: > Starts identity verification for a tenant in a single call — uploads the provided identity document(s) and starts the verification workflow using the tenant's stored profile (`fname`, `lname`, `email`). Send as `multipart/form-data` with: - `doc_type` — `passport`, `driving_licence`, `national_identity_card`, or `residence_permit`. - `issuing_country` — 3-letter ISO code (e.g. `ESP`). - `front` — file (required, max 10 MB; `PDF`, `JPEG`, `JPG`, `PNG`). - `back` — file (required for all types except `passport`; same limits). Returns verification identifiers (`applicant_id`, `document_ids`, `workflow_run_id`, and `workflow_data`) you can use to track status. If a verification is already `pending` for the tenant, the request is rejected with `KYC already in progress for this tenant`. parameters: - $ref: '#/components/parameters/TenantIdParam' requestBody: required: true content: multipart/form-data: schema: type: object required: - front - doc_type - issuing_country properties: front: type: string format: binary description: >- Front of the identity document (field name `front`). Max 10 MB. For `passport` this is the only file. back: type: string format: binary description: >- Back of the identity document (field name `back`). Required for all types except `passport`. Max 10 MB. doc_type: type: string enum: - passport - driving_licence - national_identity_card - residence_permit description: Document type being verified. issuing_country: type: string minLength: 3 maxLength: 3 example: ESP description: 3-letter ISO country code. encoding: front: contentType: application/pdf, image/jpeg, image/jpg, image/png back: contentType: application/pdf, image/jpeg, image/jpg, image/png responses: '200': description: KYC initiated successfully content: application/json: schema: type: object properties: status: type: string enum: - success message: type: string example: KYC initiated successfully data: type: object properties: applicant_id: type: string description: Created applicant identifier. document_ids: type: array minItems: 1 maxItems: 2 items: type: string description: >- 1 ID for passport, 2 IDs for other types (front, back). workflow_run_id: type: string description: Identifier to check verification status. workflow_data: type: object description: Verification run details. '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '404': $ref: '#/components/responses/ErrorResponse' description: Tenant not found or missing required fields '500': $ref: '#/components/responses/ErrorResponse' components: parameters: TenantIdParam: name: tenantId in: path required: true schema: type: string responses: ErrorResponse: description: Error response content: application/json: schema: type: object properties: status: type: string enum: - error message: type: string securitySchemes: BearerAuth: type: http scheme: bearer description: | HTTP Bearer Authentication. Generate a shared token via `/authenticate/token`, then pass it as `Authorization: Bearer `. ````