Verify or reject a document

POST/lokta-lms/api/v1/sourcing-partners/{partnerId}/documents/{documentId}/verification

Verifies or rejects a partner document.

{"status": "verified"} or {"status": "rejected", "reason": "…"}.

A rejection needs a reason and a verification does not; the same asymmetry as deactivating a partner. Accepting a document is the expected outcome and explains itself; refusing one stops an onboarding, and the partner has to be told what to send instead.

A document cannot be returned to pending. That would erase the fact that somebody looked at it, which is the one thing the verification record exists to preserve.

The checklist's expired still outranks a stored verified, so verifying a document whose valid_to has passed does not make it current.

Path parameters

partnerIdpath · string · required

documentIdpath · string · required

Request body application/json

statusstring · required

The decision. A document cannot be returned to pending.

One of: verified, rejected

reasonstring · optional

Required when the status is rejected, so the partner knows what to send instead.

Responses

defaultdefault response

Every request authenticates with HTTP Basic and carries a Tenant-Identifier header. See the conventions for dates, commands, pagination and errors. Open this operation in the interactive explorer, or read it as Markdown.

This is the API reference for Lokta, the agentic loan servicing platform. Go to lokta.ai

curl -X POST \ 'https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{partnerId}/documents/{documentId}/verification' \ -u '{username}:{password}' \ -H 'Tenant-Identifier: default' \ -H 'Content-Type: application/json' \ -d '{ "status": "verified", "reason": "string" }'

import requests response = requests.post( "https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{partnerId}/documents/{documentId}/verification", auth=("{username}", "{password}"), headers={"Tenant-Identifier": "default"}, json={ "status": "verified", "reason": "string" }, ) print(response.json())

const response = await fetch("https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{partnerId}/documents/{documentId}/verification", { method: "POST", headers: { Authorization: "Basic " + Buffer.from("{username}:{password}").toString("base64"), "Tenant-Identifier": "default", "Content-Type": "application/json", }, body: JSON.stringify({ "status": "verified", "reason": "string" }), }); console.log(await response.json());

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{partnerId}/documents/{documentId}/verification")) .header("Authorization", "Basic " + Base64.getEncoder().encodeToString("{username}:{password}".getBytes())) .header("Tenant-Identifier", "default") .header("Content-Type", "application/json") .method("POST", HttpRequest.BodyPublishers.ofString(""" { "status": "verified", "reason": "string" } """)) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

payload := strings.NewReader(`{ "status": "verified", "reason": "string" }`) req, _ := http.NewRequest("POST", "https://default.lokta.tech/lokta-lms/api/v1/sourcing-partners/{partnerId}/documents/{documentId}/verification", payload) req.SetBasicAuth("{username}", "{password}") req.Header.Set("Tenant-Identifier", "default") req.Header.Set("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() data, _ := io.ReadAll(res.Body) fmt.Println(string(data))