Submit a borrower signature

post

https://api.clc.solutions/v1/borrowers/{borrowerId}/signatures

CLC supplies the master loan agreement to you, and you serve it to the borrower
to read and accept. On acceptance you submit the signature here, one request
per signature; signatures are never batched.

This endpoint acknowledges receipt and returns no body. Eligibility to
request facilities is evaluated asynchronously and reported by the
borrower.eligible webhook.

Requires scope borrower:write.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

borrowerId

string

required

Body Params

full_name

string

required

Full legal name the borrower accepted the contract under

string

required

Email address the borrower accepted the contract with

ip_address

string

required

IP address the acceptance originated from (IPv4 or IPv6)

signed_at

date-time

required

RFC 3339 timestamp of the borrower's acceptance

contract_type

string

required

Which contract this signature covers, the value you got from GET /v1/documents.

contract_version

string

required

Version of the contract you actually served, verbatim from GET /v1/documents. Do not hard-code it.

Headers

Idempotency-Key

string

required

length ≤ 255

Required on every mutation. Unique per (tenant, key). Stored 24 h; a replay returns the original response with Idempotent-Replay: true.

X-CLC-Timestamp

string

required

^[0-9]{10}$

Unix seconds. Requests outside a ±5 minute window are rejected, and the value is part of the signed canonical request.

X-CLC-Signature

string

required

length between 88 and 88

^[A-Za-z0-9+/]{86}==$

Base64 of the Ed25519 signature over the canonical request. Ed25519 signatures are always 64 bytes, so this is always 88 characters ending in ==.

Response

202

Signature accepted; eligibility is evaluated asynchronously and reported by the borrower.eligible webhook