Attribute a loan to a partner

POST/lokta-lms/api/v1/loan-attributions

Attributes a loan to the active partner that sourced it.

One partner per loan, and this is enforced: a second attribution is a 409 sourcing/loan_already_attributed, not a second row. Correct the existing one instead.

Only an active partner may be attributed: a pending partner has not finished onboarding and an inactive one has been stood down, and attributing to either creates a fee liability to a party the lender has not agreed to pay.

source defaults to at_origination. backfill must be stated deliberately, because a backfilled attribution is an assertion about a past nobody witnessed.

For a Direct loan, do not call this at all.

When to use it

Use this to record which partner sourced a loan. The partner has to be active. For a Direct loan, do not call it.

Worth knowing

A loan has one partner. A second attribution returns 409, so correct the existing one instead.
Send an Idempotency-Key header.

Header parameters

Idempotency-Keyheader · string · optional

Per-intent key; persist it before sending and reuse it on retry

Request body application/json

loan_idinteger · optional

Placeholder name, to be confirmed. The loan to attribute.

partner_idstring · optional

Placeholder name, to be confirmed. The active partner the loan is attributed to.

sourcestring · optional

Where the attribution came from. Defaults to at_origination; a backfill has to be stated deliberately.

One of: at_origination, backfill

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/loan-attributions' \ -u '{username}:{password}' \ -H 'Tenant-Identifier: default' \ -H 'Content-Type: application/json' \ -d '{ "loan_id": 1, "partner_id": "string", "source": "at_origination" }'

import requests response = requests.post( "https://default.lokta.tech/lokta-lms/api/v1/loan-attributions", auth=("{username}", "{password}"), headers={"Tenant-Identifier": "default"}, json={ "loan_id": 1, "partner_id": "string", "source": "at_origination" }, ) print(response.json())

const response = await fetch("https://default.lokta.tech/lokta-lms/api/v1/loan-attributions", { method: "POST", headers: { Authorization: "Basic " + Buffer.from("{username}:{password}").toString("base64"), "Tenant-Identifier": "default", "Content-Type": "application/json", }, body: JSON.stringify({ "loan_id": 1, "partner_id": "string", "source": "at_origination" }), }); console.log(await response.json());

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://default.lokta.tech/lokta-lms/api/v1/loan-attributions")) .header("Authorization", "Basic " + Base64.getEncoder().encodeToString("{username}:{password}".getBytes())) .header("Tenant-Identifier", "default") .header("Content-Type", "application/json") .method("POST", HttpRequest.BodyPublishers.ofString(""" { "loan_id": 1, "partner_id": "string", "source": "at_origination" } """)) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

payload := strings.NewReader(`{ "loan_id": 1, "partner_id": "string", "source": "at_origination" }`) req, _ := http.NewRequest("POST", "https://default.lokta.tech/lokta-lms/api/v1/loan-attributions", 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))