Create a borrower

post

https://api.clc.solutions/v1/borrowers

Requires scope borrower:write.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

type

string

enum

required

Allowed:

kyc_attested

boolean

required

The tenant attests it has completed KYC/AML for this end customer. CLC
does NOT run or read KYC, which is the tenant's responsibility. A facility
cannot activate without this attestation.

residency_country

string

required

length between 2 and 2

ISO 3166-1 alpha-2 country where the borrower resides. Eligibility and the terms CLC can offer depend on it.

residency_state

string

ISO 3166-2 subdivision code without the country prefix, so CA rather than US-CA. Required where lending is regulated at state level, which today means a residency_country of US.

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

201Borrower created