Partner API overview

The referral side of the marketplace: submit a business and follow what happens next.

The Partner API is the referral side of the platform: accountants, brokers and software platforms submit business-funding requests programmatically and track every referral and its commission state, against the same reference, forever.

A referral, end to endWhat happens to a business you send us, and which event tells you about it.

OpenedYoudraft
POST /leads
A lead does not have to be complete to exist. Fill it in with PATCH as your own form collects more.
SubmittedYousubmitted
POST /leads/{id}/submit
Until you submit, nothing is matched.
Matched and routedCapvantmatched
The business is matched against every lane whose buy box it fits, and routed to the ones it does.
Offers returnedCapvantoffers_availablelead.offer_received
Read them with GET /leads/{id}/offers. Indicative figures arrive first, firm ones once statements are in.
Fundedfundedlead.funded
Commission attaches here. This is the state your reconciliation reads.
Declineddeclinedlead.declined
No lane took it. The reason travels with the event.

You move itCapvant moves it

Authentication

Same pattern as the Lender API: an API key in the X-API-Key header. Partner keys start with cv_pk_ and are created by your own team in the partner portal under Settings to API keys; the full key is shown once. Keys are scoped strictly to your own referrals.

Base URL

Shell

https://api.capvant.com/partner/v1

Errors, rate limits (120 requests per minute per key) and webhook signatures are identical to the Lender API, so one integration pattern covers both sides.

The referral you submit enters the standard Capvant pipeline: qualification, matching, lender hand-off and offers all run on our side. Your commission follows the funded deal on the same record, identically to widget and portal referrals.

Authentication

Base URL

On this page